Kotlin Multiplatform Development Help

发布你的应用程序

当你的应用程序准备就绪时,就可以通过发布将它们交付给用户了。

对于移动应用,每个平台都有多个应用商店可供选择。但在本文中,我们将聚焦官方渠道: Google Play 商店Apple App Store 。对于网页应用,我们将使用 GitHub Pages

你将学习如何为发布准备 Kotlin 多平台应用程序,并重点关注这一过程中需要特别注意的部分。

Android 应用

由于 Kotlin 是 Android 开发的主要语言, Kotlin 多平台对项目编译和 Android 应用构建没有明显影响。从共享模块生成的 Android 库和 Android 应用本身都是典型的 Android Gradle 模块;它们与其他 Android 库和应用并无不同。因此,从 Kotlin 多平台项目发布 Android 应用的过程与 Android 开发者文档 中描述的常规流程完全一致。

iOS 应用

Kotlin 多平台项目中的 iOS 应用是从典型的 Xcode 项目构建的,因此发布它的主要阶段与 iOS 开发者文档 中描述的相同。

Kotlin 多平台项目的特殊性在于将共享的 Kotlin 模块编译为框架并与 Xcode 项目链接。通常,共享模块与 Xcode 项目之间的集成是由 Android Studio 的 Kotlin 多平台插件 自动完成的。但如果你不使用该插件,在 Xcode 中构建和打包 iOS 项目时需要注意以下几点:

  • 共享的 Kotlin 库会被编译为原生框架。

  • 你需要将为特定平台编译的框架连接到 iOS 应用项目。

  • 在 Xcode 项目设置中,指定框架的路径以便构建系统查找。

  • 项目构建完成后,应启动并测试应用,确保在运行时使用框架时没有问题。

有两种方法可以将共享的 Kotlin 模块连接到 iOS 项目:

  • 使用 Kotlin/Native CocoaPods 插件 ,它允许你将带有原生目标的多平台项目作为 CocoaPods 依赖项用于 iOS 项目。

  • 手动配置你的多平台项目以创建 iOS 框架,并配置 Xcode 项目以获取其最新版本。 Kotlin 多平台向导或 Android Studio 的 Kotlin 多平台插件通常会完成此配置。 参阅 将框架连接到你的 iOS 项目 了解如何在 Xcode 中直接添加框架。

配置你的 iOS 应用

你可以不通过 Xcode 来配置影响最终应用的基本属性。

包标识符

包标识符 在操作系统中唯一标识你的应用。要更改它, 在 Android Studio 中打开 iosApp/Configuration/Config.xcconfig 文件并更新 BUNDLE_ID

应用名称

应用名称设置目标可执行文件和应用程序包的名称。要更改你的应用名称:

  • 如果你尚未在 Android Studio 中打开项目,可以直接在任何文本编辑器中修改 iosApp/Configuration/Config.xcconfig 文件中的 APP_NAME 选项。

  • 如果你已经在 Android Studio 中打开了项目,请执行以下操作:

    1. 关闭项目。

    2. 在任何文本编辑器中,修改 iosApp/Configuration/Config.xcconfig 文件中的 APP_NAME 选项。

    3. 在 Android Studio 中重新打开项目。

如果你需要配置其他设置,请使用 Xcode:在 Android Studio 中打开项目后, 在 Xcode 中打开 iosApp/iosApp.xcworkspace 文件并在那里进行更改。

符号化崩溃报告

为了帮助开发者改进应用,iOS 提供了分析应用崩溃的方法。为了进行详细的崩溃分析, 它使用特殊的调试符号 (.dSYM) 文件,将崩溃报告中的内存地址与源代码中的位置(如函数或行号)匹配。

默认情况下,从共享 Kotlin 模块生成的 iOS 框架的发布版本会附带一个 .dSYM 文件。这有助于你分析共享模块代码中发生的崩溃。

当 iOS 应用从位码重建时,其 dSYM 文件将失效。对于这种情况,你可以将共享模块编译为静态框架,将调试信息存储在框架内部。有关在 Kotlin 模块生成的二进制文件中设置崩溃报告符号化的说明,请参阅 Kotlin/Native 文档

网页应用

要发布你的网页应用,需要创建包含构成应用的编译文件和资源的工件。这些工件是部署应用到 GitHub Pages 等网页托管平台所必需的。

生成工件

为运行 wasmJsBrowserDistribution 任务创建一个运行配置:

  1. 选择 Run | Edit Configurations 菜单项。

  2. 点击加号按钮并从下拉列表中选择 Gradle

  3. Tasks and arguments 字段中,粘贴以下命令:

    wasmJsBrowserDistribution
  4. 点击 OK

现在,你可以使用此配置来运行任务:

运行 Wasm 分发任务

任务完成后,你可以在 composeApp/build/dist/wasmJs/productionExecutable 目录中找到生成的工件:

工件目录

在 GitHub Pages 上发布你的应用

准备好工件后,你可以将应用部署到网页托管平台上:

  1. productionExecutable 目录的内容复制到你想要创建站点的仓库中。

  2. 按照 GitHub 的 创建站点 说明操作。

  3. 在浏览器中导航到你的 GitHub Pages 域名。

    导航到 GitHub Pages

    恭喜!你已成功在 GitHub Pages 上发布了你的工件。

调试网页应用

你可以直接在浏览器中调试网页应用,无需额外配置。要了解如何在浏览器中调试, 请参阅 Kotlin 文档中的 在浏览器中调试 指南。

22 四月 2025