OpenSkillIndex← back to search
claude-codedevops

Claude-skill-registry creating-upgrade-test-version

Creates test version branches for testing app upgrade functionality. Use when preparing upgrade test builds, testing version migration, or when the user mentions test version, 9005.x.x version numbers, upgrade testing, or version upgrade QA. Automates branch creation, version bumping, and build number hardcoding for upgrade flow verification.

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/creating-upgrade-test-version" ~/.claude/skills/majiayu000-claude-skill-registry-creating-upgrade-test-version && rm -rf "$T"
manifest: skills/data/creating-upgrade-test-version/SKILL.md
tags
#version-management#branch-creation#build-configuration#upgrade-testing
source content

Creating Upgrade Test Version

Automates the creation of test version branches with hardcoded build configurations for testing app upgrade functionality and version migration flows.

Workflow

Step 1: Gather Version Information

Ask the user for the test version number using AskUserQuestion:

Question: "What test version number should be used?"
Options:
- "9005.20.0" (example format)
- Custom input

The version should follow the pattern 

9XXX.YY.Z
where:

  • 9XXX
    indicates a test version (e.g., 9005)
  • YY.Z
    matches the production version being tested

Step 2: Calculate Build Number

Calculate the build number as: current date (YYYYMMDD) + "00" suffix + 30

The build number must be 10 digits in format: 

YYYYMMDD00 + 30 = YYYYMMDD30

Example: If today is 

20260113
, the build number is 
2026011300 + 30 = 2026011330

# Calculate build number (10 digits)
DATE=$(date +%Y%m%d)
BUILD_NUMBER=$((${DATE}00 + 30))
echo "Build number: $BUILD_NUMBER"  # Output: 2026011330

Step 3: Create and Checkout Branch

Create a new branch named after the test version:

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

Step 4: Modify Configuration Files

Modify the following files in order:

4.1 Update 
.env.version

Change the 

VERSION
field to the test version:

VERSION=<test_version>
BUNDLE_VERSION=1

4.2 Update 
.github/actions/shared-env/action.yml

In the "Setup ENV BUILD_NUMBER" steps, replace ALL build number logic with a hardcoded value. Remove the if/else conditions and simplify to:

- name: Setup ENV BUILD_NUMBER
  shell: bash
  run: |
    echo "BUILD_NUMBER=<calculated_build_number>" >> $GITHUB_ENV

Remove both:

  • "Setup ENV BUILD_NUMBER to 1" step
  • "Setup ENV BUILD_NUMBER by workflow_run" step

Replace with single step that hardcodes the build number.

4.3 Update 
.github/workflows/release-android.yml

In the "Write .env.version" step, change:

echo "BUILD_NUMBER=${{ env.BUILD_NUMBER }}" >> .env.version

To:

echo "BUILD_NUMBER=<calculated_build_number>" >> .env.version

4.4 Update 
apps/mobile/android/app/build.gradle

In the 

defaultConfig
block, update:

versionCode <calculated_build_number>
versionName "<test_version>"

Example:

versionCode 2026011330
versionName "9005.20.0"

Step 5: Commit and Push

git add -A
git commit -m "chore: prepare test version <test_version> with build number <build_number>"
git push -u origin <test_version>

File Locations Summary

FileChange
.env.version
Update VERSION
.github/actions/shared-env/action.yml
Hardcode BUILD_NUMBER, remove conditionals
.github/workflows/release-android.yml
Hardcode BUILD_NUMBER in .env.version write
apps/mobile/android/app/build.gradle
Update versionCode and versionName

Example Execution

For test version 

9005.20.0
on date 
2026-01-13
:

  1. Build number = 
    2026011300 + 30
    = 
    2026011330
    (10 digits)
  2. Create branch 
    9005.20.0
  3. Set VERSION=
    9005.20.0
    in 
    .env.version
  4. Hardcode BUILD_NUMBER=
    2026011330
    in shared-env action
  5. Hardcode BUILD_NUMBER=
    2026011330
    in release-android workflow
  6. Set versionCode=
    2026011330
    , versionName=
    "9005.20.0"
    in build.gradle
  7. Commit and push

Validation Checklist

Before pushing, verify:

  • Branch name matches test version
  • .env.version
    VERSION field updated
  • Build number conditionals removed from shared-env
  • Build number hardcoded in release-android workflow
  • versionCode is numeric (build number)
  • versionName is quoted string (test version)