opendance
68783c37b6
依据 Gitea v1.27.3 modules/charset/escape_stream.go 的判定规则 （analyzeDetectResults：仅当左右相邻字符都不是非 ASCII 时才标记， 且 _common 表恒定生效），把说明文档中会被标记的全角标点 （，：；？！（） 等）改为半角，并保证成对括号宽度一致。 中文语境中的全角标点（左右均为中文）保持原样，不动代码与契约语义。
75 lines
2.3 KiB
Markdown
75 lines
2.3 KiB
Markdown
# T-AND-009 APK 打包
|
|
|
|
- **状态**: done
|
|
- **依赖**: T-AND-001 ~ 008
|
|
|
|
## 目标
|
|
|
|
产出可安装的签名 APK，并提供命令行与 Android Studio 两条路径。
|
|
|
|
## load
|
|
|
|
```
|
|
DSH.md
|
|
build/build-apk.sh
|
|
build/gen-keystore.sh
|
|
build/verify.sh
|
|
app/build.gradle.kts
|
|
```
|
|
|
|
## 交付物
|
|
|
|
| 文件 | 说明 |
|
|
|--|--|
|
|
| `build/gen-keystore.sh` | 生成发布签名密钥库(**不入库**) |
|
|
| `build/build-apk.sh` | 构建 + 校验产物（魔数、签名方案） |
|
|
| `build/verify.sh` | 单元测试 -> 构建 -> 产物校验 一条龙 |
|
|
|
|
## 签名设计
|
|
|
|
`app/build.gradle.kts` 按优先级读取签名信息：
|
|
|
|
```
|
|
1. keystore.properties(build/gen-keystore.sh 生成，已 gitignore)
|
|
2. 环境变量 KEYSTORE_PATH / KEYSTORE_PASSWORD / KEY_ALIAS / KEY_PASSWORD
|
|
3. 两者都缺失 -> 回退 debug 签名，保证 CI 上 assembleRelease 也能产出已签名 APK
|
|
```
|
|
|
|
正式发布必须走 1 或 2；回退路径仅为让 CI/验收可跑通，并在构建日志中给出提示。
|
|
|
|
## Android Studio 图形界面路径
|
|
|
|
```
|
|
1. Android Studio 打开 opendance-android/
|
|
2. Build -> Generate Signed Bundle / APK
|
|
3. 选择 APK -> 选择或创建 keystore -> 选择 release
|
|
4. 生成 app-release.apk
|
|
```
|
|
|
|
## 验收(文档 6.3 T-AND-009)
|
|
|
|
| 验收项 | 结果 |
|
|
|--|--|
|
|
| Android Studio 可 Build -> Generate Signed APK | ✅ 工程为标准 AGP 结构，`keystore.properties` 就位即可 |
|
|
| `./gradlew assembleRelease` 成功生成签名 APK | ✅ 见下 |
|
|
| APK 在 Android 10+ 设备可安装运行 | ⚠️ 本环境无 Android 设备/模拟器，未实机安装 |
|
|
| 关于页包含开源项目声明 | ✅ `CreditsTest` 覆盖，且声明随包分发 |
|
|
|
|
## 实测产物
|
|
|
|
```
|
|
app-release.apk 55.5 MiB apksigner: Verifies(v2 方案)
|
|
Signer #1 DN: CN=OpenDance Studio Dev, OU=OpenDance, O=OpenDance Studio, C=CN
|
|
package: com.opendance.studio versionName 0.1.0
|
|
minSdk 29(Android 10) targetSdk 34
|
|
ABI: arm64-v8a, armeabi-v7a, x86, x86_64
|
|
assets/pose_landmarker_lite.task 5.7 MB(Stored 未压缩)
|
|
```
|
|
|
|
## 环境记录
|
|
|
|
- JDK 17(本地安装路径，示例 `<JDK 17 路径>`)
|
|
- Android SDK: `platforms;android-34`、`build-tools;34.0.0`
|
|
- 构建期修复的问题：`proguard-rules.pro` 缺失导致 R8 配置告警（已补全 keep 规则）、
|
|
androidTest 的 `androidx.test.runner` 依赖补齐
|