开始使用 Kotlin/Wasm 和 Compose Multiplatform
Kotlin/Wasm 处于 Alpha 阶段。它可能随时更改。
本教程演示了如何在 IntelliJ IDEA 中使用 Kotlin/Wasm 运行 Compose Multiplatform 应用,并生成 artifact 以作为站点发布到 GitHub Pages。
开始之前
使用 Kotlin Multiplatform 向导创建一个项目:
在 New Project 选项卡上,根据你的偏好更改项目名称和 ID。在本教程中,我们将名称设置为 "WasmDemo",ID 设置为 "wasm.project.demo"。
这些是项目目录的名称和 ID。你也可以保持它们不变。
选择 Web 选项。确保没有选择其他选项。
点击 Download 按钮并解压生成的归档文件。
在 IntelliJ IDEA 中打开项目
- 下载并安装最新版本的 IntelliJ IDEA。
- 在 IntelliJ IDEA 的欢迎界面上,点击 Open 或在菜单栏中选择 File | Open。
- 导航到解压后的 "WasmDemo" 文件夹并点击 Open。
运行应用程序
在 IntelliJ IDEA 中,通过选择 View | Tool Windows | Gradle 打开 Gradle 工具窗口。
项目加载后,你可以在 Gradle 工具窗口中找到 Gradle 任务。
你需要至少 Java 11 作为 Gradle JVM,以便任务成功加载。
在 wasmdemo | Tasks | kotlin browser 中,选择并运行 wasmJsBrowserDevelopmentRun 任务。
或者,你可以在终端中从
WasmDemo
根目录运行以下命令:bash./gradlew wasmJsBrowserDevelopmentRun -t
应用程序启动后,在浏览器中打开以下 URL:
bashhttp://localhost:8080/
端口号可能不同,因为 8080 端口可能不可用。你可以在 Gradle 构建控制台中找到实际的端口号。
你会看到一个 "Click me!" 按钮。点击它:
现在你会看到 Compose Multiplatform 的徽标:
生成 artifact
在 wasmdemo | Tasks | kotlin browser 中,选择并运行 wasmJsBrowserDistribution 任务。
或者,你可以在终端中从 WasmDemo
根目录运行以下命令:
./gradlew wasmJsBrowserDistribution
应用程序任务完成后,你可以在 composeApp/build/dist/wasmJs/productionExecutable
目录中找到生成的 artifact:
发布到 GitHub Pages
将
productionExecutable
目录中的所有内容复制到你想要创建站点的版本库中。遵循 GitHub 关于 创建你的站点 的说明。
在你将更改推送到 GitHub 后,你的站点更改最多可能需要 10 分钟才能发布。
在浏览器中,导航到你的 GitHub Pages 域名。
恭喜!你已成功将你的 artifact 发布到 GitHub Pages。
接下来
尝试更多 Kotlin/Wasm 示例:
加入 Kotlin Slack 中的 Kotlin/Wasm 社区: