kotlin - 将 Gradle 子项目与 Kotlin 多平台一起使用

Question

我正在使用 Kotlin 多平台(JVM & JS)，它在 IDEA 中创建了三个项目:demo、demo-js 和 demo-jvm .

我想将通用代码拆分成更多的子项目/子模块。假设我添加了 commonmod;如何编译？

gradle run -p demo-jvm 现在的错误是:

demo/demo-js/src/main/kotlin/demo/commonmod/example.kt: (3, 12): Actual function 'getPlatform' has no corresponding expected declaration

但我认为我这样做从根本上是错误的，因为我不知道什么应该取决于什么(尽管我尝试了很多迭代)。如果我解决了这个错误，我会得到其他错误，然后再次出现其他错误，直到我回到这个错误。

---

作为最小但仍然很大的 example ，我有:

demo/settings.gradle:

rootProject.name = 'demo'

include 'demo-jvm', 'demo-js', 'commonmod'

demo/build.gradle:

buildscript { ... }

apply plugin: 'kotlin-platform-common'

repositories {
    mavenCentral()
}

dependencies {
    compile "org.jetbrains.kotlin:kotlin-stdlib-common:$kotlin_version"
    testCompile "org.jetbrains.kotlin:kotlin-test-annotations-common:$kotlin_version"
    testCompile "org.jetbrains.kotlin:kotlin-test-common:$kotlin_version"
    compile project(':commonmod')
}

demo/demo-jvm/settings.gradle:

rootProject.name = 'demo'

demo/demo-jvm/build.gradle:

buildscript { ... }

apply plugin: 'kotlin-platform-jvm'
apply plugin: 'application'

repositories {
    mavenCentral()
}

mainClassName = "demo.MainKt"

dependencies {
    compile "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
    expectedBy project(":")
    testCompile "junit:junit:4.12"
    testCompile "org.jetbrains.kotlin:kotlin-test-junit:$kotlin_version"
    testCompile "org.jetbrains.kotlin:kotlin-test:$kotlin_version"
}

demo/demo-js/settings.gradle:

rootProject.name = 'demo'

demo/demo-js/build.gradle:

buildscript { ... }

apply plugin: 'kotlin-platform-js'

repositories {
    mavenCentral()
}

dependencies {
    compile "org.jetbrains.kotlin:kotlin-stdlib-js:$kotlin_version"
    expectedBy project(":")
    testCompile "org.jetbrains.kotlin:kotlin-test-js:$kotlin_version"
}

demo/commonmod/settings.gradle:

rootProject.name = 'demo'

include 'demo-jvm', 'demo-js'

demo/commonmod/build.gradle:

buildscript { ... }

apply plugin: 'kotlin-platform-common'

repositories {
    mavenCentral()
}

dependencies {
    compile "org.jetbrains.kotlin:kotlin-stdlib-common:$kotlin_version"
    testCompile "org.jetbrains.kotlin:kotlin-test-annotations-common:$kotlin_version"
    testCompile "org.jetbrains.kotlin:kotlin-test-common:$kotlin_version"
    compile project(':demo-js')
    compile project(':demo-jvm')
}

Answer 1

这花了很多时间，所以我希望这对某人有用!

Github 上有一个功能示例:kotlin_multiplatform_gradle_demo

有几个来源提供了帮助，但其中很多都是反复试验，所以如果有什么不好的做法，请告诉我!

---

对于最小的例子，结构是这样的:

├── alpha
│   ├── alpha-js
│   │   └── build.gradle
│   ├── alpha-jvm
│   │   └── build.gradle
│   ├── build.gradle
│   └── src
│       └── main
│           ├── kotlin
│           │   └── demo
│           │       └── alpha
│           │           └── main.kt
├── beta
│   ├── beta-js
│   │   ├── build.gradle
│   │   └── src
│   │       └── main
│   │           └── kotlin
│   │               └── demo
│   │                   └── beta
│   │                       └── platform.kt
│   ├── beta-jvm
│   │   ├── build.gradle
│   │   └── src
│   │       └── main
│   │           └── kotlin
│   │               └── demo
│   │                   └── beta
│   │                       └── platform.kt
│   ├── build.gradle
│   └── src
│       └── main
│           └── kotlin
│               └── demo
│                   └── beta
│                       └── platform.kt
├── build.gradle
└── settings.gradle

通用模块(alpha 和 beta)需要每个平台的平台模块至少有一个`build.gradle`。

settings.gradle 文件导入所有模块，包括平台模块。

依赖项，例如从 alpha on beta，在通用 alpha 模块和所有 alpha 平台模块中声明。

---

我学到的一些模式:

• 每个“普通”(通用)模块都有一个用于每个平台的平台模块。
• 对于普通模块alpha，javascript平台模块必须叫alpha-js(-jvm类似)。
• 如果没有特定平台的代码，这个模块可以只是一个目录中的 gradle 文件。
• 平台模块可以方便地放置在通用模块目录中(所以 alpha:alpha-js)。
• 通用模块不应指代平台模块；平台模块有一个依赖expectedBy project(":the_common_module")。

• 如果模块alpha依赖于beta，那么

  • alpha 必须有 dependencies { compile project(":beta") }
  • alpha-js 必须有 dependencies { compile project(":beta:beta-js") }(除了expectedBy)
  • alpha-jvm 必须有 dependencies { compile project(":beta:beta-jvm") }(除了expectedBy)等等

• 只有顶层模块有settings.gradle，其中包括所有子模块(包括平台的)。

• 确保名称正确，因为不正确的名称不会导致错误，它们只会默默地失败。 (看起来很可笑，但我想是有原因的。)
• 不要将所有输出放到一个共享的构建目录中 - 这会导致一些奇怪的非确定性错误。

---

我以前在这里有完整的配置文件，但最好只检查 Github 上的代码因为它真的很长。