creating-upgrade-test-version

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

```bash

# 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:

```bash

git checkout -b

# 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=

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:

```yaml

• name: Setup ENV BUILD_NUMBER

shell: bash

run: |

echo "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:

```yaml

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

```

To:

```yaml

echo "BUILD_NUMBER=" >> .env.version

```

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

In the defaultConfig block, update:

```gradle

versionCode

versionName ""

```

Example:

```gradle

versionCode 2026011330

versionName "9005.20.0"

```

Step 5: Commit and Push

```bash

git add -A

git commit -m "chore: prepare test version with build number "

git push -u origin

```

| File | Change |

|------|--------|

| .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 |

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

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)