应用开发
项目注重开放性和可扩展性，欢迎社区开发者参与贡献完善应用相关功能。
环境要求
- Android Studio
- JDK 21
- Android SDK
项目结构
注意
项目从 2.x 版本起迁移至 Compose Multiplatform 多平台框架，采用 KMP（Kotlin Multiplatform）架构。Gradle 包含三个模块（androidApp、shared、desktopApp），iOS 通过 Xcode 构建独立的 iosApp 项目：
androidApp# Android 平台入口
shared# 跨平台共享模块（核心业务逻辑）
desktopApp# Desktop (JVM) 平台入口
iosApp# iOS 平台入口（Xcode 项目）
gradle
build.gradle.kts# 根项目插件声明
settings.gradle.kts# 模块包含配置
gradle.properties
应用入口
androidApp/MainActivity.kt— Android 平台入口，EdgeToEdge，Koin Applicationshared/commonMain/App.kt— 共享 Compose 入口，所有平台共用的 UI 与逻辑shared/commonMain/Navigation.kt— Navigation3 导航定义desktopApp/— Desktop (JVM) 平台入口iosApp/— iOS 平台入口（通过 Xcode 构建，调用 shared 模块的 iOS Framework）
跨平台源集
shared 模块按 KMP 约定划分源集：
| 源集 | 目标平台 | 说明 |
|---|---|---|
commonMain | 全平台 | 共享业务逻辑、UI、数据层 |
androidMain | Android | Android 特定实现（SQLite Framework、Ktor CIO） |
jvmMain | Desktop (JVM) | Desktop 特定实现（SQLite Bundled、Ktor CIO） |
iosMain | iOS | iOS 特定实现（SQLite Framework、Ktor Darwin） |
开发者模式
从 2.x 版本开始，项目不再区分正式版本和开发者版本。开发者功能通过在更多页面点击应用图标 5 次启用。
构建命令
# Android Debug
./gradlew :androidApp:assembleDebug
# Android Release
./gradlew :androidApp:assembleRelease
# Desktop (JVM) 运行
./gradlew :desktopApp:run
# Desktop (JVM) 打包
./gradlew :desktopApp:packageABI 分包
Android 构建产物按 CPU 架构分包：
arm64-v8aarmeabi-v7ax86_64
APK 命名格式：shiguangschedule-v{version}-{abi}-{buildType}.apk
签名文件配置
正式版发布前需在 androidApp/build.gradle.kts 中配置签名信息。项目当前 release 构建类型默认使用 debug 签名，发布时应替换为正式签名：
android {
signingConfigs {
create("release") {
storeFile = file("keystore.jks")
storePassword = "your-store-password"
keyAlias = "your-key-alias"
keyPassword = "your-key-password"
}
}
buildTypes {
release {
isMinifyEnabled = true
isShrinkResources = true
proguardFiles(
getDefaultProguardFile("proguard-android-optimize.txt"),
"proguard-rules.pro"
)
signingConfig = signingConfigs.getByName("release")
}
}
}签名文件（.jks / .keystore）应妥善保管，建议：
- 不提交到版本控制系统
- 使用环境变量或 CI 密钥管理服务注入密码
测试
# 运行 shared 模块单元测试
./gradlew :shared:desktopTest
# 运行 Android 插桩测试
./gradlew :androidApp:connectedDebugAndroidTest