boot 旨在通过默认的网络、存储、依赖注入、插件实现,简化kmp跨平台应用开发.

boot-app-kmp 参考 Spring Boot Starter 理念设计，核心等价关系:

自动发现通过 SweetSPI (KMP ServiceLoader) 实现:

1. 各模块定义 BootModule 实现类
2. SweetSPI KSP 处理器在编译时生成 META-INF/services/com.yuanjingtech.boot.app.kmp.BootModule 文件
3. PluginManager 通过 ServiceLoader.load(BootModule) 在运行时加载所有模块
4. pluginModule 统一将所有模块注册到 Koin

参考 docs/plugin.md

参考 Spring Boot 官方 Starter 设计，映射到 KMP 模块:

聚焦 80/20 法则: P0/P1 模块覆盖 80% 企业场景，优先实现。

• [x] 图标 material icons
• [x] 字体 LXGWWenKaiMono

封装常用组件 ui/src/commonMain/kotlin/com/yuanjingtech/boot/app/kmp/ui 组件定义 ui/src/commonMain/kotlin/com/yuanjingtech/boot/app/kmp/ui/liquidgalass LiquidGlass组件实现 ui/src/commonMain/kotlin/com/yuanjingtech/boot/app/kmp/ui/material3 Material3组件实现

• [x] 跨平台统一的界面风格(默认LiquidGlass,可选Material3)
• [] 支持平台单独定制(ios/Android/Desktop/Web), 如默认LiquidGlass,但是在Android上使用Material3

• [x] 日志 logging(kotlin-logging)
• [x] 网络请求 ktor (network 模块)
• [x] sqldelight 数据存储
• [x] wasm sqldelight (sqlite-wasm-worker)
• [] store 数据源
• [x] 插件框架
  • [x] sweet-spi 自动发现
  • [x] koin 依赖注入
• [x] coil 图像加载 (ui 模块依赖)
• [x] webview (webview 模块)
  • [x] https://klibs.io/project/parkwoocheol/compose-webview
  • [x] https://klibs.io/project/KevinnZou/compose-webview-multiplatform

• [] 多租户 tenant
• [] 认证 auth

• [x] wasm/js 中文显示乱码问题

gradle/libs.version.toml

[ versions ]
  boot = "0.0.2-alpha.15"
  [ libraries ]
  boot-shared = { module = "com.yuanjingtech.boot.app.kmp:shared", version.ref = "boot" }
  [ bundles ]
  feature = [
  "boot-shared",
]

feature/build.gradle.kts

kotlin {
    sourceSets {
        commonMain.dependencies {
            api(libs.bundles.feature)
        }
    }
}

App.kt

@Composable
@Preview
fun App() {
    BootApp(config = KoinConfiguration {
        printLogger()
    }) {
        Content()
    }
}

This is a Kotlin Multiplatform project targeting Android, iOS, Web, Desktop (JVM), Server.

• /composeApp is for code that will be shared across your Compose Multiplatform applications. It contains several subfolders:

  • commonMain is for code that’s common for all targets.
  • Other folders are for Kotlin code that will be compiled for only the platform indicated in the folder name. For example, if you want to use Apple’s CoreCrypto for the iOS part of your Kotlin app, the iosMain folder would be the right place for such calls. Similarly, if you want to edit the Desktop (JVM) specific part, the jvmMain folder is the appropriate location.

• /iosApp contains iOS applications. Even if you’re sharing your UI with Compose Multiplatform, you need this entry point for your iOS app. This is also where you should add SwiftUI code for your project.

• /server is for the Ktor server application.

• /shared is for the code that will be shared between all targets in the project. The most important subfolder is commonMain. If preferred, you can add code to the platform-specific folders here too.

To build and run the development version of the Android app, use the run configuration from the run widget in your IDE’s toolbar or build it directly from the terminal:

• on macOS/Linux

  ./gradlew :composeApp:assembleDebug

• on Windows

  .\gradlew.bat :composeApp:assembleDebug

To build and run the development version of the desktop app, use the run configuration from the run widget in your IDE’s toolbar or run it directly from the terminal:

• on macOS/Linux

  ./gradlew :composeApp:run

• on Windows

  .\gradlew.bat :composeApp:run

To build and run the development version of the server, use the run configuration from the run widget in your IDE’s toolbar or run it directly from the terminal:

• on macOS/Linux

  ./gradlew :server:run

• on Windows

  .\gradlew.bat :server:run

To build and run the development version of the web app, use the run configuration from the run widget in your IDE's toolbar or run it directly from the terminal:

• for the Wasm target (faster, modern browsers):
  • on macOS/Linux

    ./gradlew :composeApp:wasmJsBrowserDevelopmentRun

  • on Windows

    .\gradlew.bat :composeApp:wasmJsBrowserDevelopmentRun

• for the JS target (slower, supports older browsers):
  • on macOS/Linux

    ./gradlew :composeApp:jsBrowserDevelopmentRun

  • on Windows

    .\gradlew.bat :composeApp:jsBrowserDevelopmentRun

To build and run the development version of the iOS app, use the run configuration from the run widget in your IDE’s toolbar or open the /iosApp directory in Xcode and run it from there.

Learn more about Kotlin Multiplatform, Compose Multiplatform, Kotlin/Wasm…

We would appreciate your feedback on Compose/Web and Kotlin/Wasm in the public Slack channel #compose-web. If you face any issues, please report them on YouTrack.