android-ci-demo/RELEASE_SETUP.md

Gitea Actions 自动发布配置指南

✅ 已完成

1. 创建了 Release workflow: .gitea/workflows/android-release.yml
2. 创建了 Gitea Token: gitea-actions-release

🔧 需要手动配置的步骤

步骤 1: 添加 GITEA_TOKEN Secret

1. 访问你的仓库：https://gitea.kg8.net/amos/android-ci-demo
2. 点击 Settings (设置)
3. 在左侧菜单选择 Secrets (密钥)
4. 点击 Add secret (添加密钥)
5. 填写：
   • Name: GITEA_TOKEN
   • Value: b4d3c4c6cd1b37b6a378970443781ee9eaeff8f5
6. 点击 Add secret 保存

步骤 2: （可选）配置 APK 签名

如果要签名 Release 版本：

1. 生成签名密钥（如果还没有）：

   keytool -genkey -v -keystore release.jks -keyalg RSA -keysize 2048 -validity 10000 -alias mykey
   

2. 在 Gitea Secrets 中添加签名信息：

   • KEYSTORE_PATH: /path/to/keystore/release.jks（在 Runner 上的路径）
   • KEYSTORE_PASSWORD: 你的密钥库密码
   • KEY_ALIAS: 你的密钥别名
   • KEY_PASSWORD: 你的密钥密码

3. 修改 app/build.gradle 添加签名配置：

   android {
       ...
       signingConfigs {
           release {
               storeFile file(System.getenv("KEYSTORE_PATH") ?: "keystore/release.jks")
               storePassword System.getenv("KEYSTORE_PASSWORD")
               keyAlias System.getenv("KEY_ALIAS")
               keyPassword System.getenv("KEY_PASSWORD")
           }
       }
       buildTypes {
           release {
               signingConfig signingConfigs.release
               minifyEnabled true
               shrinkResources true
               proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
           }
       }
   }
   

步骤 3: 测试自动发布

推送一个测试标签来触发自动发布：

cd /tmp/android-ci-demo-fixed
git tag v1.0.0-test
git push origin v1.0.0-test

然后访问：https://gitea.kg8.net/amos/android-ci-demo/actions

查看 Android Release workflow 的运行状态。

步骤 4: 正式发布

当准备发布正式版本时：

# 更新版本号（在 build.gradle 中）
# versionName "1.0.0"
# versionCode 1

git tag v1.0.0
git push origin v1.0.0

自动发布 workflow 会：

1. ✅ 编译 Release 版本的 APK
2. ✅ 创建 Gitea Release
3. ✅ 上传 APK 到 Release

📝 注意事项

1. Token 权限: 创建的 token 有 write:repository 权限，可以创建 Release
2. Token 安全: 不要将 token 提交到 Git，只通过 Gitea Secrets 使用
3. APK 大小: Release 版本经过混淆和压缩，通常比 Debug 版本小 30-50%
4. 签名: 未签名的 Release APK 无法安装到真机，仅用于测试

🎯 后续优化建议

1. 添加变更日志: 自动从 commit message 生成 CHANGELOG
2. 多版本支持: 同时生成 universal APK 和分架构 APK
3. 自动测试: 在发布前运行单元测试
4. 通知: 发布成功后通过飞书/邮件通知团队

---

Token 信息（仅首次配置需要）：

• Name: gitea-actions-release
• Token: b4d3c4c6cd1b37b6a378970443781ee9eaeff8f5
• 最后 8 位：eaeff8f5