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 - ビルドおよびリリースコマンド