Files
class-schedule/starschedule/docs/构建与发布.md
T
2026-09-20 13:33:09 +08:00

3.0 KiB
Raw Permalink Blame History

构建与发布

1. 版本

定义在 app/build.gradle.kts:

versionCode = 1
versionName = "1.0.0"
applicationId = "com.starschedule"
namespace = "com.xingheyuzhuan.shiguangschedule"

升版本时两处一起改。versionCode 必须递增才能覆盖安装。

2. 常用命令

在 starschedule/ 目录:

gradlew.bat :app:assembleDebug
gradlew.bat :app:assembleRelease
gradlew.bat :app:installDebug

Debug / Release APK 文件名:

starschedule-v{versionName}-{abi}-{buildType}.apk

ABI:armeabi-v7a、arm64-v8a、x86_64。未打 universal 包。

输出目录:app/build/outputs/apk/<buildType>/。

3. 镜像

settings.gradle.kts:

  1. 腾讯云 https://mirrors.cloud.tencent.com/nexus/repository/maven-public/(优先)
  2. google()(仅 androidx / com.android / com.google)
  3. mavenCentral()
  4. 插件仓库额外还有 gradlePluginPortal()

gradle/wrapper/gradle-wrapper.properties:

distributionUrl=https://mirrors.cloud.tencent.com/gradle/gradle-9.7.1-bin.zip

模块内禁止再声明仓库(FAIL_ON_PROJECT_REPOS)。

4. 关键 Gradle 开关

gradle.properties:

  • 配置缓存、构建缓存、并行
  • JVM 堆 4096M
  • android.nonTransitiveRClass=true
  • kotlin.native.ignoreDisabledTargets=true(即使当前无 native 目标也无妨)

app:

  • localeFilters: zh, zh-rCN
  • generateLocaleConfig = false
  • Release:minify + shrinkResources,当前 signingConfig 暂用 debug 签名,正式上架前必须换成正式 keystore。

5. 依赖版本目录

统一写在 gradle/libs.versions.toml。不要在子模块写死版本号。

主要库(版本以 libs.versions.toml 为准):Compose Multiplatform 1.11.1、Material 3、Navigation3、Room 3.0.1、DataStore 1.2.1、Koin 4.2.2、Ktor 3.5.2、Wire 6.4.5、Okio、Coil 3、kotlinx-serialization / datetime、WorkManager 2.11.2。

6. ProGuard

Release 开启混淆。app/proguard-rules.pro 已 keep:

  • Koin 模块、@Single / @Factory / @KoinViewModel 构造
  • ListenableWorker 子类、AppWidgetProvider
  • Kotlinx Serialization、Wire
  • data.db、data.model、shared 命名空间下部分类

WebView 的 NativeBridge.postMessage(@JavascriptInterface)包名不在上述 keep 前缀里。打正式包后必须真机验证正方导入;若 JS 调不通,在 ProGuard 中 keep @JavascriptInterface 方法。修改 Bridge 或序列化模型后用 assembleRelease 再跑:正方导入、JSON 往返、ZIP 恢复。

7. 发布检查清单

  • versionName / versionCode 已升
  • 使用正式签名而非 debug
  • assembleRelease 三个 ABI 均成功
  • 冷启动、导入正方、JSON 往返、ZIP 恢复、提醒、四种小组件
  • 无英文界面入口
  • 隐私:不采集账号;网络权限仅网页、WebDAV、节假日

8. 许可证

根目录 LICENSE 为 Apache 2.0,版权声明沿用原项目 XingHeYuZhuan。对外分发时保留许可证与 NOTICE 要求。