Kotlin Multiplatform项目推荐 | 太空人分布图

Kotlin Multiplatform项目推荐 | 太空人分布图

项目简介

Kotlin Multiplatform项目是一种跨平台开发技术，它可以同时使用SwiftUI、Jetpack Compose、Compose for Wear OS、Compose for Desktop、Compose for Web、Kotlin/JS + React等客户端框架，并且使用Ktor作为后端。太空人分布图项目目前可以在以下平台上运行：

• Android（Jetpack Compose）
• Android小部件（基于Compose的Glance API - 由https://github.com/yschimke贡献）
• Wear OS（Compose for Wear OS - 主要由https://github.com/yschimke开发）
• iOS（SwiftUI）
• iOS（Compose for iOS - 实验性支持！）
• iOS小部件（SwiftUI）
• watchOS（SwiftUI）（由https://github.com/nealsanche贡献）
• macOS（SwiftUI）
• Swift可执行包
• 桌面应用（Compose for Desktop）
• Web应用（基于JS的Compose for Web）
• Web应用（基于Wasm的Compose for Web）
• Web应用（Kotlin/JS + React封装）（由https://github.com/PatilShreyas贡献）
• JVM（小型的Ktor后端服务 + 共享模块中的Main.kt）

该项目利用了Open Notify PeopleInSpace API (http://open-notify.org/Open-Notify-API/People-In-Space/)，用于显示当前太空中的人员列表以及国际空间站的位置（灵感来自https://kousenit.org/2019/12/19/a-few-astronomical-examples-in-kotlin/）。

这个项目被包含在官方的Kotlin多平台移动文档 (https://kotlinlang.org/docs/mobile/samples.html#peopleinspace)和Google Dev Library (https://devlibrary.withgoogle.com/products/android) 中作为示例。

请注意，这个存储库非常注重简洁，以更清晰地说明Kotlin多平台项目的关键部分，并帮助刚开始探索KMP的人快速上手（当然主要专注于使用Jetpack Compose和SwiftUI）。如果你已经超过这个阶段，我强烈推荐你查看Touchlab的KaMPKit (https://github.com/touchlab/KaMPKit)。我还有以下示例，演示了各种Kotlin多平台库的使用（也使用了Jetpack Compose和SwiftUI）：

• BikeShare (https://github.com/joreilly/BikeShare)
• FantasyPremierLeague (https://github.com/joreilly/FantasyPremierLeague)
• MortyComposeKMM (https://github.com/joreilly/MortyComposeKMM)
• StarWars (https://github.com/joreilly/StarWars)
• Confetti (https://github.com/joreilly/Confetti)
• GalwayBus (https://github.com/joreilly/GalwayBus)
• Chip-8 (https://github.com/joreilly/chip-8)

构建

您需要使用至少Android Studio Flamingo（注意：Java 17是现在所需的最低版本）。需要Xcode 13.2或更高版本（因为使用了新的Swift 5.5并发API）。

打开PeopleInSpaceSwiftUI以查看iOS/watchOS/macOS项目。

要运行（基于React的）Web客户端，请运行./gradlew :web:browserDevelopmentRun。

要运行后端，可以运行./gradlew :backend:run，或者通过Android Studio直接运行Server.kt。然后，您应该能够在浏览器中打开http://localhost:9090/astros_local.json。

Compose for Web客户端（JS）

Compose for Web客户端位于compose-web模块中，可以通过调用./gradlew :compose-web:jsBrowserDevelopmentRun来运行。

Compose for Web客户端（Wasm）

类似地，对于基于Kotlin/Wasm的版本，可以使用./gradlew :compose-web-wasm:wasmBrowserDevelopmentRun 运行。

Compose for Desktop客户端

该客户端在compose-desktop模块中可用，并可以使用./gradlew :compose-desktop:run来运行。请注意，在运行时需要使用适当版本的JVM（例如Java 11）。

Compose for iOS客户端

可以使用例如./gradlew :compose-ios:iosDeployIPhone13ProDebug来运行。

后端代码

已在Google App Engine部署中测试过。使用shadowJar插件创建"uber" jar，然后按照下面的示例进行部署。也可以将此jar部署到其他服务上。

./gradlew :backend:shadowJar
gcloud app deploy backend/build/libs/backend-all.jar --appyaml=backend/src/jvmMain/appengine/app.yaml

GraphQL后端

有一个GraphQL模块（graphql-server），可以使用./gradlew :graphql-server:bootRun在本地运行，并在http://localhost:8080/playground上提供"playground"。

项目截图

iOS (SwiftUI)

Android (Jetpack Compose)

watchOS (SwiftUI)

Wear OS (Wear Compose)

macOS (SwiftUI)

Compose for Desktop

Compose for Web

Web App (Kotlin/JS + React)

技术栈

使用的语言、库和工具包括：

• Kotlin (https://kotlinlang.org/)
• Kotlin协程 (https://kotlinlang.org/docs/reference/coroutines-overview.html)
• Kotlinx序列化 (https://github.com/Kotlin/kotlinx.serialization)
• Ktor客户端库 (https://github.com/ktorio/ktor)
• Android架构组件 (https://developer.android.com/topic/libraries/architecture/index.html)
• Koin (https://github.com/InsertKoinIO/koin)
• SQLDelight (https://github.com/cashapp/sqldelight)
• Jetpack Compose (https://developer.android.com/jetpack/compose)
• SwiftUI (https://developer.apple.com/documentation/swiftui)
• KMP-NativeCoroutines (https://github.com/rickclephas/KMP-NativeCoroutines)
• Coil (https://coil-kt.github.io/coil/)

项目地址

https://github.com/joreilly/PeopleInSpace