feat: add versioning, auto-release, and clean APK naming to release workflow

Agent-Logs-Url: https://github.com/winnerspiros/osu/sessions/1d3c6971-e9fd-4074-9f8e-0bcb8c85965d

Co-authored-by: winnerspiros <1675249+winnerspiros@users.noreply.github.com>

Author: Copilot

.github/workflows/release.yml

@@ -6,6 +6,17 @@ on:
       - '*.*.*'
       - '!*-*'
   workflow_dispatch:
+    inputs:
+      version:
+        description: "Version number (e.g. 1.0.0). Leave empty for auto-increment."
+        required: false
+        default: ""
+        type: string
+      create_release:
+        description: "Create a GitHub Release with the APK?"
+        required: false
+        default: true
+        type: boolean
 
 jobs:
   build-android:
@@ -131,16 +142,28 @@ jobs:
           KEY_PASS_SECRET: ${{ secrets.ANDROID_SIGNING_KEY_PASSWORD }}
           STORE_PASS_SECRET: ${{ secrets.ANDROID_SIGNING_STORE_PASSWORD }}
 
-      - name: Set version
+      - name: Determine version
         id: version
         run: |
+          # Priority: manual input > tag name > auto-increment from run number
+          INPUT_VERSION="${{ inputs.version }}"
           REF="${{ github.ref_name }}"
-          if [[ "$REF" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
-            echo "version=$REF" >> "$GITHUB_OUTPUT"
+
+          if [[ -n "$INPUT_VERSION" && "$INPUT_VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            VERSION="$INPUT_VERSION"
+            echo "📦 Using manually specified version: $VERSION"
+          elif [[ "$REF" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            VERSION="$REF"
+            echo "📦 Using version from tag: $VERSION"
           else
-            echo "version=0.0.0" >> "$GITHUB_OUTPUT"
+            # Auto-generate: YYYY.MMDD.run_number
+            VERSION="$(date -u +%Y).$(date -u +%-m%d).${{ github.run_number }}"
+            echo "📦 Auto-generated version: $VERSION"
           fi
 
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+          echo "tag=v$VERSION"    >> "$GITHUB_OUTPUT"
+
       - name: Build Android APK
         run: >
           dotnet publish -c Release
@@ -156,7 +179,7 @@ jobs:
           -p:AndroidSigningStorePass="${{ steps.keystore.outputs.store_pass }}"
           -p:CustomBeforeMicrosoftCommonTargets="${{ github.workspace }}/build/SuppressSubmoduleWarnings.targets"
 
-      - name: Find APK
+      - name: Find and rename APK
         id: find_apk
         run: |
           APK=$(find "osu.Android/bin/Release/net10.0-android/publish" -maxdepth 1 -name "*-Signed.apk" 2>/dev/null | head -1)
@@ -170,10 +193,15 @@ jobs:
             exit 1
           fi
 
-          APK_SIZE=$(stat -c %s "$APK" 2>/dev/null || stat -f %z "$APK" 2>/dev/null || wc -c < "$APK")
+          # Rename to a clean versioned filename for the release
+          VERSION="${{ steps.version.outputs.version }}"
+          FINAL_APK="$(dirname "$APK")/osu-lazer-$VERSION.apk"
+          cp "$APK" "$FINAL_APK"
+
+          APK_SIZE=$(stat -c %s "$FINAL_APK" 2>/dev/null || stat -f %z "$FINAL_APK" 2>/dev/null || wc -c < "$FINAL_APK")
           APK_SIZE_MB=$((APK_SIZE / 1048576))
-          echo "Found APK: $APK ($APK_SIZE_MB MB)"
-          echo "apk_path=$APK" >> "$GITHUB_OUTPUT"
+          echo "Found APK: $FINAL_APK ($APK_SIZE_MB MB)"
+          echo "apk_path=$FINAL_APK" >> "$GITHUB_OUTPUT"
 
       - name: Verify APK signature
         run: |
@@ -190,7 +218,7 @@ jobs:
       - name: Upload APK artifact
         uses: actions/upload-artifact@v7
         with:
-          name: osu-android-${{ github.ref_name }}
+          name: osu-android-${{ steps.version.outputs.version }}
           path: ${{ steps.find_apk.outputs.apk_path }}
           if-no-files-found: error
 
@@ -235,11 +263,25 @@ jobs:
           echo "     same keystore automatically — no more setup needed."
           echo "=================================================================="
 
+      # Create a GitHub Release with the APK attached.
+      # Works for both tag pushes and manual workflow_dispatch runs.
+      # For manual runs: creates a tag automatically.
       - name: Create GitHub Release
-        if: startsWith(github.ref, 'refs/tags/')
+        if: inputs.create_release != false
         uses: softprops/action-gh-release@v2
         with:
+          tag_name: ${{ steps.version.outputs.tag }}
+          name: "osu! Android ${{ steps.version.outputs.version }}"
           files: ${{ steps.find_apk.outputs.apk_path }}
           generate_release_notes: true
+          body: |
+            ## osu! Android v${{ steps.version.outputs.version }}
+
+            ### Download
+            Grab the APK below and install it on your Android device.
+
+            > **Minimum Android version:** 13 (API 33)
+            > **Architecture:** arm64-v8a
+          make_latest: true
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}