1k-app-upgrade-test

测试版本创建

自动创建测试版本分支，并写入硬编码的构建配置，用于测试应用升级功能和版本迁移流程。

快速参考

版本格式

测试版本遵循以下格式：9XXX.YY.Z

• 9XXX - 测试版本标识符（例如，9005）
• YY.Z - 与所测试的生产版本一致

示例：测试生产版本 5.20.0 时，使用 9005.20.0

构建号计算公式

构建号按以下公式计算：

DATE=$(date +%Y%m%d)
BUILD_NUMBER=$((${DATE}00 + 30))

格式：10 位数字 = YYYYMMDD00 + 30

示例：如果今天是 20260130，构建号为 2026013030

工作流

步骤 1：获取版本信息

询问用户测试版本号：

• 格式：9XXX.YY.Z
• 示例：9005.20.0

步骤 2：计算构建号

DATE=$(date +%Y%m%d)
BUILD_NUMBER=$((${DATE}00 + 30))
echo "Build number: $BUILD_NUMBER"

步骤 3：创建分支

git checkout -b <test_version>
# Example: git checkout -b 9005.20.0

步骤 4：修改配置文件

按以下顺序更新这些文件：

1. .env.version

   • 将 VERSION 设置为测试版本

2. .github/actions/shared-env/action.yml

   • 更新 outputs 部分中的版本

3. .github/workflows/release-android.yml

   • 在 "Write .env.version" 步骤中硬编码 BUILD_NUMBER

4. .github/workflows/release-ios.yml

   • 在 "Write .env.version" 步骤中硬编码 BUILD_NUMBER

5. .github/workflows/daily-build.yml

   • 在 "Setup ENV" 步骤中硬编码 BUILD_NUMBER

6. apps/mobile/android/app/build.gradle

   • 更新 versionCode
   • 更新 versionName

步骤 5：提交并推送

git add .
git commit -m "chore: create test version <version>"
git push origin <test_version>

要修改的文件

文件	更新内容
.env.version	VERSION
.github/actions/shared-env/action.yml	硬编码 BUILD_NUMBER，移除条件判断
.github/workflows/release-android.yml	在写入 .env.version 时硬编码 BUILD_NUMBER
.github/workflows/release-ios.yml	在写入 .env.version 时硬编码 BUILD_NUMBER
.github/workflows/daily-build.yml	在 Setup ENV 步骤中硬编码 BUILD_NUMBER
apps/mobile/android/app/build.gradle	versionCode、versionName

详细指南

有关完整的测试版本创建工作流和示例，请参阅 upgrade-test-version.md。

涵盖的主题：

• 版本号格式和约定
• 构建号计算公式
• 逐步修改文件的说明
• 配置文件示例
• 测试版本的 Git 工作流
• QA 测试注意事项

何时使用此技能

• 创建用于 QA 升级测试的测试构建
• 测试版本迁移流程
• 验证应用升级功能
• 创建带有指定构建号的候选发布版本
• 测试特定版本的功能或修复

相关技能

• /1k-dev-commands - Git 和开发工作流约定
• /1k-dev-commands - 构建和发布命令