Skip to content

开始使用 Kotlin/Wasm 和 Compose Multiplatform

Kotlin/Wasm 处于 Alpha 阶段。它可能随时更改。

加入 Kotlin/Wasm 社区。

本教程演示了如何在 IntelliJ IDEA 中使用 Kotlin/Wasm 运行 Compose Multiplatform 应用,并生成 artifact 以作为站点发布到 GitHub Pages

开始之前

使用 Kotlin Multiplatform 向导创建一个项目:

  1. 打开 Kotlin Multiplatform 向导

  2. New Project 选项卡上,根据你的偏好更改项目名称和 ID。在本教程中,我们将名称设置为 "WasmDemo",ID 设置为 "wasm.project.demo"。

    这些是项目目录的名称和 ID。你也可以保持它们不变。

  3. 选择 Web 选项。确保没有选择其他选项。

  4. 点击 Download 按钮并解压生成的归档文件。

    Kotlin Multiplatform wizard

在 IntelliJ IDEA 中打开项目

  1. 下载并安装最新版本的 IntelliJ IDEA
  2. 在 IntelliJ IDEA 的欢迎界面上,点击 Open 或在菜单栏中选择 File | Open
  3. 导航到解压后的 "WasmDemo" 文件夹并点击 Open

运行应用程序

  1. 在 IntelliJ IDEA 中,通过选择 View | Tool Windows | Gradle 打开 Gradle 工具窗口。

    项目加载后,你可以在 Gradle 工具窗口中找到 Gradle 任务。

    你需要至少 Java 11 作为 Gradle JVM,以便任务成功加载。

  2. wasmdemo | Tasks | kotlin browser 中,选择并运行 wasmJsBrowserDevelopmentRun 任务。

    Run the Gradle task

    或者,你可以在终端中从 WasmDemo 根目录运行以下命令:

    bash
    ./gradlew wasmJsBrowserDevelopmentRun -t
  3. 应用程序启动后,在浏览器中打开以下 URL:

    bash
    http://localhost:8080/

    端口号可能不同,因为 8080 端口可能不可用。你可以在 Gradle 构建控制台中找到实际的端口号。

    你会看到一个 "Click me!" 按钮。点击它:

    Click me

    现在你会看到 Compose Multiplatform 的徽标:

    Compose app in browser

生成 artifact

wasmdemo | Tasks | kotlin browser 中,选择并运行 wasmJsBrowserDistribution 任务。

Run the Gradle task

或者,你可以在终端中从 WasmDemo 根目录运行以下命令:

bash
./gradlew wasmJsBrowserDistribution

应用程序任务完成后,你可以在 composeApp/build/dist/wasmJs/productionExecutable 目录中找到生成的 artifact:

Artifacts directory

发布到 GitHub Pages

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

  2. 遵循 GitHub 关于 创建你的站点 的说明。

    在你将更改推送到 GitHub 后,你的站点更改最多可能需要 10 分钟才能发布。

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

    Navigate to GitHub pages

    恭喜!你已成功将你的 artifact 发布到 GitHub Pages。

接下来