Android SDK 重构实施接管文档

更新时间：2026-07-17
分支：main
发布约束：Maven 制品只允许通过 https://jenkins.xuqinmin.com/ 发布。

当前目标

sdk-core 是配置、会话、网络、文件、时间等公共能力的唯一实现。
sdk-update 只提供更新领域 API；宿主与 RN 桥接不复制下载、校验和安装代码。
APK 更新必须支持 SHA-256、原子临时文件、进度、取消、有限重试、FileProvider、未知来源安装权限及确定错误码。
废弃的离线激活 sdk-license 已彻底删除，不得恢复反射初始化或兼容入口。

2026-07-17 已完成

FileSDK 新增详细下载进度、SHA-256 与哈希匹配公共 API。
下载改为 .part 临时文件完成后替换目标文件；HTTP 非 2xx 失败，协程取消会中断连接并清理临时文件。
sdk-core 自动合并 FileProvider，扩展 SDK 不再要求宿主重复声明 provider。
sdk-update 删除无版本 APK 兼容路径和弃用下载入口。
sdk-update 2.0.0-SNAPSHOT 强制要求合法 SHA-256，并提供下载重试、取消、缓存文件复验和确定错误码。
增加 Java/RN 可直接使用的 startDownloadAndInstall、UpdateInstallTask、进度/结果回调和安装权限设置 Intent。
sdk-core、sdk-update、sample-app 编译通过。
sdk-license 模块、源码、初始化反射、Gradle/Jenkins 参数和架构文档引用已全部删除。
sdk-core 1 个单元测试、sdk-update 2 个单元测试通过。
修复通知权限检查、MediaStore API 等级和 java.time minSdk 24 反向移植，core/update Release Lint 均通过。

下一步

补充 Android 仪器测试。
审计 Java 8 对外制品与内部 Java 21 集成边界，完成对应构建门禁。
通过 Jenkins 先发布 sdk-core Snapshot，再发布 sdk-update:2.0.0-SNAPSHOT。
在 RN SDK Android 宿主中编译并验证下载取消、错误码、权限跳转和安装器唤起。

已验证命令

./gradlew :sdk-core:compileReleaseKotlin :sdk-update:compileReleaseKotlin :sample-app:compileDebugKotlin
./gradlew :sdk-core:testDebugUnitTest :sdk-update:testDebugUnitTest :sample-app:compileDebugKotlin
./gradlew :sdk-core:lintRelease :sdk-update:lintRelease :sdk-update:assembleRelease

不得在开发机执行 Maven 发布。

2.3 KiB 原始文件 Blame 文件历史 Unescape Escape

Android SDK 重构实施接管文档

当前目标

2026-07-17 已完成

下一步

已验证命令

2.3 KiB

原始文件 Blame 文件历史