javascript - Angular 6 typescript 与 KotlinJs 的集成

Question

我刚刚成功地将 Kotlin 编译的 javascript 模块导入到 angular 6 typescript 文件中。这并不容易，结果让我感到困惑。我想知道是否存在更优雅的方式。

最初我拿了一个 Kotlin 文件:

package com.example.test

data class SomeInterface(
    var id: String? = null,
    var value: String? = null
) {
}

它可以很好地编译为以下 JavaScript

(function (root, factory) {
  if (typeof define === 'function' && define.amd)
    define(['exports', 'kotlin'], factory);
  else if (typeof exports === 'object')
    factory(module.exports, require('kotlin'));
  else {
    if (typeof kotlin === 'undefined') {
      throw new Error("Error loading module 'TestKotlinCompiled'. Its dependency 'kotlin' was not found. Please, check whether 'kotlin' is loaded prior to 'TestKotlinCompiled'.");
    }
    root.TestKotlinCompiled = factory(typeof TestKotlinCompiled === 'undefined' ? {} : TestKotlinCompiled, kotlin);
  }
}(this, function (_, Kotlin) {
  'use strict';
  var Kind_CLASS = Kotlin.Kind.CLASS;
  function SomeInterface(id, value) {
    if (id === void 0)
      id = null;
    if (value === void 0)
      value = null;
    this.id = id;
    this.value = value;
  }
  SomeInterface.$metadata$ = {
    kind: Kind_CLASS,
    simpleName: 'SomeInterface',
    interfaces: []
  };
  SomeInterface.prototype.component1 = function () {
    return this.id;
  };
  SomeInterface.prototype.component2 = function () {
    return this.value;
  };
  SomeInterface.prototype.copy_rkkr90$ = function (id, value) {
    return new SomeInterface(id === void 0 ? this.id : id, value === void 0 ? this.value : value);
  };
  SomeInterface.prototype.toString = function () {
    return 'SomeInterface(id=' + Kotlin.toString(this.id) + (', value=' + Kotlin.toString(this.value)) + ')';
  };
  SomeInterface.prototype.hashCode = function () {
    var result = 0;
    result = result * 31 + Kotlin.hashCode(this.id) | 0;
    result = result * 31 + Kotlin.hashCode(this.value) | 0;
    return result;
  };
  SomeInterface.prototype.equals = function (other) {
    return this === other || (other !== null && (typeof other === 'object' && (Object.getPrototypeOf(this) === Object.getPrototypeOf(other) && (Kotlin.equals(this.id, other.id) && Kotlin.equals(this.value, other.value)))));
  };
  var package$com = _.com || (_.com = {});
  var package$example = package$com.example || (package$com.example =     {});
  var package$test = package$example.test || (package$example.test = {});
  package$test.SomeInterface = SomeInterface;
  Kotlin.defineModule('TestKotlinCompiled', _);
  return _;
}));

在 package.json 中，我将 "kotlin": "^1.2.70", 添加到依赖项部分。在 Angular 组件中，我必须使用这样的代码进行导入。

import * as TestKotlinCompiled from "../../generated/TestKotlinCompiled";

// @ts-ignore
const SomeInterface = TestKotlinCompiled.com.example.test.SomeInterface;
// @ts-ignore
type SomeInterface = TestKotlinCompiled.com.example.test.SomeInterface;

这是使用生成到模块 TestKotlinCompiled 的包 com.example.test 中的类 SomeInterfac 的最少强制代码。

这里的问题如下。

//@ts-ignore 是必需的，因为在编译时 ts-comiler 看不到正在导入的模块的内容。

new SomeInterface()

需要

constlet x: SomeInterface;

需要

type

所有这些看起来都非常老套。我想要一些更简单的东西，比如使用命名空间 com.example.test 从 '../../generated/TestKotlinCompiled' 导入 {SomeInterface}，而不使用 const 和 type。那么，有没有办法简化我上面的代码呢？

Answer 1

我成功地在 Angular 中提高了 KotlinJs 的一点点可用性。我在 https://github.com/svok/kotlin-multiplatform-sample 中处理我的实验

首先，我们必须在 Gradle 中创建一个多平台子模块。我们生成 js 文件(在其他可能的平台中)。

然后我们添加到 package.json...

{
  "dependencies": {
    "kotlin": "^1.3.21",
    "proj-common": "file:../build/javascript-compiled"
  }
}

proj-common 是我们编译的 Kotlin 模块。那里的路径是构建 kotlin-js 文件的位置。

因此，在 typescript 中我们只使用了一个 npm 模块

import {sample} from 'proj-common/proj-common';

// For class Sample
sample = new sample.Sample();

// For object Platform
platform = sample.Platform;

编译顺利，无需使用//@ts-ignore

更新

在上面的解释中，子依赖存在问题。它们没有被导出，但并非所有子依赖项在 npm 存储库中都有它们的等价物。下面的代码解决了这个问题。

tasks {
    task<Sync>("assembleWeb") {
        val dependencies = configurations.get("jsMainImplementation").map {
            val file = it
            val (tDir, tVer) = "^(.*)-([\\d.]+-\\w+|[\\d.]+)\\.jar$"
                .toRegex()
                .find(file.name)
                ?.groupValues
                ?.drop(1)
                ?: listOf("", "")
            var jsFile: File? = null
            copy {
                from(zipTree(file.absolutePath), {
                    includeEmptyDirs = false
                    include { fileTreeElement ->
                        val path = fileTreeElement.path
                        val res = (path.endsWith(".js") || path.endsWith(".map"))
                                && (path.startsWith("META-INF/resources/") || !path.startsWith("META-INF/"))
                        if (res && path.endsWith(".js") && ! path.endsWith(".meta.js")) jsFile = fileTreeElement.file
                        res
                    }
                })
                into("$npmTarget/$tDir")
            }
            jsFile?.also { packageJson(tDir, it, tVer) }
            tDir to jsFile
        }
            .filter { it.second != null }
            .map { it.first to it.second!! }
            .toMap()

        packageJson(npmDir, File(jsOutputFile), project.version.toString(), dependencies)
        dependsOn("jsMainClasses")
    }

    assemble.get().dependsOn("assembleWeb")
}

fun packageJson(dir: String, jsFile: File, version: String, dependencies: Map<String, File> = emptyMap()) {
    val deps = dependencies.map {
        """"${js2Name(it.value)}": "file:../${it.key}""""
    }.joinToString(",\n            ")
    val text = """
        {
          "name": "${js2Name(jsFile)}",
          "version": "${version}",
          "main": "./${jsFile.name}",
          "dependencies": {
            ${deps}
          }
        }
    """.trimIndent()
    File("$npmTarget/$dir/package.json").apply {
        if (parentFile.exists()) {
            parentFile.delete()
        }
        parentFile.mkdirs()
        writeText(text)
    }
}

fun js2Name(jsFile: File) = jsFile.name.replace("""\.js$""".toRegex(), "")

然后，从前面的子模块导入:

{
  "dependencies": {
    "proj-common": "file:../build/npm"
  }
}

在 typescript 文件中:

import {sample} from 'proj-common';

// For class Sample
sample = new sample.Sample();

// For object Platform
platform = sample.Platform;

示例项目见 https://github.com/svok/kotlin-multiplatform-sample

更新 2

现在您可以使用 kotlin 通用子项目创建全栈项目，就像在 gradle 中附加插件一样简单

plugins {
    id("com.crowdproj.plugins.jar2npm")
}

这个插件会在编译过程中自动将你所有的 kotlin-js jar 包注入(inject)到你的 node_modules 中。

https://github.com/svok/kotlin-multiplatform-sample项目现在用这个插件重写。见 proj-angularfront子模块。