4

我是 JS 和 Kotlin/JS 的新手。我从一个示例中为Obsidian插件提供了以下最小工作 Javascript 代码。它按预期工作:

var obsidian = require('obsidian');
class SomePlugin extends obsidian.Plugin {
    onload() {
        new obsidian.Notice('This is a notice!');
    }
}
module.exports = Plugin;

我希望使用 Kotlin 扩展这个插件,因为我知道这种语言,但是我在将它转换为 Kotlin/JS 时遇到了一些问题。到目前为止我的方法:

可运行项目可以在 Github上找到。运行gradle build以生成构建文件夹。它将在浏览器步骤中失败,但该步骤不是必需的。构建后生成的 js 文件可以在build\js\packages\main\kotlin\main.js.

主文件

@JsExport
class SomePlugin: Plugin() {
    override fun onload() {
        Notice("This is a notice!")
    }
}
@JsModule("obsidian")
@JsNonModule // required by the umd moduletype
external open class Component {
    open fun onload()
}
@JsModule("obsidian")
@JsNonModule
external open class Plugin : Component {
}
@JsModule("obsidian")
@JsNonModule
external open class Notice(message: String, timeout: Number = definedExternally) {
    open fun hide()
}

编辑:感谢@S.Janssen 的评论,我将模块类型切换为 umd

构建.gradle.kts

plugins {
    kotlin("js") version "1.5.20"
}
group = "de.example"
version = "1.0-SNAPSHOT"
repositories {
    mavenCentral()
}
dependencies {
    implementation(npm("obsidian", "0.12.5", false))
}
kotlin {
    js(IR) {
        binaries.executable()
        browser {
            webpackTask {
                output.libraryTarget = "umd"
            }
        }
    }
}

tasks.withType<KotlinJsCompile>().configureEach {
    kotlinOptions.moduleKind = "umd"
}

我实际上并不需要可以在 中运行的结果browser,但是如果没有browser定义,它甚至不会生成 js 文件。对于该browser部分,抛出异常说Can't resolve 'obsidian' in 'path\kotlin'. 但至少在 .js 下创建了一个 .js 文件build/js/packages/test/kotlin/test.js。然而,该代码与我预期的代码完全不同,并且也不被黑曜石接受为有效的插件代码。我还尝试了其他一些 gradle 选项。像“umd”,“amd”,“plain”,遗留编译器而不是 IR,nodejs 而不是浏览器。但是没有任何东西可以创建可运行的 js 文件。错误消息不同。使用旧版编译器,它需要 kotlin.js 文件,即使我将它放在文件夹旁边或将内容复制到脚本中,它也无法找到。

如何获得与上面发布的 Javascript 代码功能相似的代码?我知道它会产生开销,但是根据我的理解,当前生成的代码甚至没有定义或导出我的类。

我从 obisidan 调试器得到的错误消息:

Plugin failure: obsidian-sample-plugin TypeError: Object prototype may only be an Object or null: undefined

生成的代码:

    (function (root, factory) {
  if (typeof define === 'function' && define.amd)
    define(['exports', 'obsidian', 'obsidian', 'obsidian'], factory);
  else if (typeof exports === 'object')
    factory(module.exports, require('obsidian'), require('obsidian'), require('obsidian'));
  else {
    if (typeof Component === 'undefined') {
      throw new Error("Error loading module 'main'. Its dependency 'obsidian' was not found. Please, check whether 'obsidian' is loaded prior to 'main'.");
    }if (typeof Plugin === 'undefined') {
      throw new Error("Error loading module 'main'. Its dependency 'obsidian' was not found. Please, check whether 'obsidian' is loaded prior to 'main'.");
    }if (typeof Notice === 'undefined') {
      throw new Error("Error loading module 'main'. Its dependency 'obsidian' was not found. Please, check whether 'obsidian' is loaded prior to 'main'.");
    }root.main = factory(typeof main === 'undefined' ? {} : main, Component, Plugin, Notice);
  }
}(this, function (_, Component, Plugin, Notice) {
  'use strict';
  SomePlugin.prototype = Object.create(Plugin.prototype);
  SomePlugin.prototype.constructor = SomePlugin;
  function Unit() {
    Unit_instance = this;
  }
  Unit.$metadata$ = {
    simpleName: 'Unit',
    kind: 'object',
    interfaces: []
  };
  var Unit_instance;
  function Unit_getInstance() {
    if (Unit_instance == null)
      new Unit();
    return Unit_instance;
  }
  function SomePlugin() {
    Plugin.call(this);
  }
  SomePlugin.prototype.onload_sv8swh_k$ = function () {
    new Notice('This is a notice!');
    Unit_getInstance();
  };
  SomePlugin.prototype.onload = function () {
    return this.onload_sv8swh_k$();
  };
  SomePlugin.$metadata$ = {
    simpleName: 'SomePlugin',
    kind: 'class',
    interfaces: []
  };
  _.SomePlugin = SomePlugin;
  return _;
}));
4

1 回答 1

3

你可以在这里找到一个工作示例。我将在此回复中逐一介绍需要对您的代码进行的一些更改。

无法解决obsidian

Can't resolve 'obsidian' in 'path\kotlin'发生是因为obsidian-api包不是独立库。相反,它只包含一个obsidian.d.ts文件,即 TypeScript 声明文件。与其他语言中的头文件类似,此头文件不提供任何实现,而仅提供库的签名和类型——这意味着 Kotlin/JS 的 webpack(或任何 JavaScript 工具,就此而言)将无法解决实际的实现。这是预期的,可以通过将模块声明为external. 要在 Kotlin/JS 中执行此操作,请创建一个名为 的目录webpack.config.d,并添加一个01.externals.js包含以下内容的文件:

config.externals = {
    obsidian: 'obsidian',
};

(实际上,您也可以在官方sample-plugin 配置中找到等效的片段,因为这不是 Kotlin/JS 特定的问题)

@JsModule对多个声明进行分组

因为您要从同一个包中导入多个声明,而不是使用@JsModule/注释多个签名@JsNonModule,您必须创建一个单独的文件,并使用@file:@JsModule("...")/对其进行注释@file:JsNonModule

@file:JsModule("obsidian")
@file:JsNonModule

open external class Component {
    open fun onload()
    open fun onunload()
}

open external class Plugin(
    app: Any,
    manifest: Any
) : Component

open external class Notice(message: String, timeout: Number = definedExternally) {
    open fun hide()
}

Kotlin 的 ES5 与 Obsidian 的 ES6

此外,您的一些问题源于 Obsidian 的示例隐含地假设您的目标是 ES6(而 Kotlin 当前的目标是 ES5)。具体来说,这对您的插件如何导出其成员以及类的实例化方式产生了影响。

遗产

关于继承(因为YourPlugin继承自Plugin),ES6 类自动使用所有参数初始化父类。这是 ES5 的原型继承不支持的东西。这就是为什么在上面的代码片段中,我们需要显式传递Plugin类构造函数appmanifest参数,并在特定插件的实现中传递它们:

class SomePlugin(
    app: Any,
    manifest: Any
) : Plugin(
    app,
    manifest
)

出口/模块系统

关于导出你的插件,Obsidian 期望或者module.exports直接exports.default成为你的Plugin类。要实现这种精确的导出行为,需要满足一些条件,不幸的是有点麻烦: - 库目标需要是 CommonJS:(output.libraryTarget = "commonjs"不是CommonJS2) - 为了防止创建间接级别,通常情况下,导出的库需要设置为nulloutput.library = null - 要将插件导出为default,其类声明需要标记为@JsName("default")

于 2021-07-12T13:07:23.180 回答