cd: add release workflow for automated builds and artifact publishing across platforms

.github/workflows/release.yml

@@ -1,7 +1,21 @@
-name: Build All Platforms
+name: Release
 
 on:
   workflow_dispatch:
+    inputs:
+      release_type:
+        description: 'Release type'
+        required: true
+        type: choice
+        default: 'stable'
+        options:
+          - stable
+          - nightly
+      dry_run:
+        description: 'Dry run (build & upload artifacts only, skip creating release)'
+        required: false
+        type: boolean
+        default: false
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
@@ -74,6 +88,8 @@ jobs:
     name: Android
     needs: prepare-deps
     runs-on: ubuntu-latest
+    env:
+      GRADLE_FLAGS: ${{ inputs.release_type == 'nightly' && '-PversionName=nightly' || '' }}
     steps:
       - uses: actions/checkout@v4
 
@@ -97,8 +113,23 @@ jobs:
 
       - name: Set up Gradle
         uses: gradle/actions/setup-gradle@v4
+
+      - name: Decode keystore
+        run: |
+          echo '${{ secrets.KEYSTORE }}' | base64 --decode > "${{ github.workspace }}/composeApp/upload-keystore.jks"
+
+      - name: Configure Android signing
+        working-directory: composeApp
+        run: |
+          cat >> local.properties <<EOF
+          release.signing.storeFile=${{ github.workspace }}/composeApp/upload-keystore.jks
+          release.signing.storePassword=${{ secrets.KEYSTORE_PASSWORD }}
+          release.signing.keyAlias=${{ secrets.KEYSTORE_KEY_ALIAS }}
+          release.signing.keyPassword=${{ secrets.KEYSTORE_KEY_PASSWORD }}
+          EOF
+
       - name: Assemble Release
-        run: ./gradlew :composeApp:assembleRelease
+        run: ./gradlew :composeApp:assembleRelease ${{ env.GRADLE_FLAGS }}
 
       - name: Upload APK
         uses: actions/upload-artifact@v4
@@ -116,6 +147,8 @@ jobs:
     name: Linux Desktop
     needs: prepare-deps
     runs-on: ubuntu-latest
+    env:
+      GRADLE_FLAGS: ${{ inputs.release_type == 'nightly' && '-PversionName=nightly' || '' }}
     steps:
       - uses: actions/checkout@v4
 
@@ -146,13 +179,13 @@ jobs:
         uses: gradle/actions/setup-gradle@v4
 
       - name: Package DEB
-        run: ./gradlew :composeApp:packageReleaseDeb
+        run: ./gradlew :composeApp:packageReleaseDeb ${{ env.GRADLE_FLAGS }}
 
       - name: Package RPM
-        run: ./gradlew :composeApp:packageReleaseRpm
+        run: ./gradlew :composeApp:packageReleaseRpm ${{ env.GRADLE_FLAGS }}
 
       - name: Package AppImage
-        run: ./gradlew :composeApp:packageReleaseAppImage
+        run: ./gradlew :composeApp:packageReleaseAppImage ${{ env.GRADLE_FLAGS }}
 
       - name: Upload DEB
         uses: actions/upload-artifact@v4
@@ -176,6 +209,8 @@ jobs:
     name: Windows Desktop
     needs: prepare-deps
     runs-on: windows-latest
+    env:
+      GRADLE_FLAGS: ${{ inputs.release_type == 'nightly' && '-PversionName=nightly' || '' }}
     steps:
       - uses: actions/checkout@v4
 
@@ -201,10 +236,10 @@ jobs:
         uses: gradle/actions/setup-gradle@v4
 
       - name: Package MSI
-        run: ./gradlew :composeApp:packageReleaseMsi
+        run: ./gradlew :composeApp:packageReleaseMsi ${{ env.GRADLE_FLAGS }}
 
       - name: Package EXE
-        run: ./gradlew :composeApp:packageReleaseExe
+        run: ./gradlew :composeApp:packageReleaseExe ${{ env.GRADLE_FLAGS }}
 
       - name: Upload MSI
         uses: actions/upload-artifact@v4
@@ -222,6 +257,8 @@ jobs:
     name: macOS Desktop
     needs: prepare-deps
     runs-on: macos-latest
+    env:
+      GRADLE_FLAGS: ${{ inputs.release_type == 'nightly' && '-PversionName=nightly' || '' }}
     steps:
       - uses: actions/checkout@v4
 
@@ -247,7 +284,7 @@ jobs:
         uses: gradle/actions/setup-gradle@v4
 
       - name: Package DMG
-        run: ./gradlew :composeApp:packageReleaseDmg
+        run: ./gradlew :composeApp:packageReleaseDmg ${{ env.GRADLE_FLAGS }}
 
       - name: Upload DMG
         uses: actions/upload-artifact@v4
@@ -255,53 +292,67 @@ jobs:
           name: macos-dmg
           path: composeApp/build/compose/binaries/main-release/**/*.dmg
 
-  build-ios:
+  create-release:
-    name: iOS
+    name: Create GitHub Release
-    needs: prepare-deps
+    if: ${{ !inputs.dry_run }}
-    runs-on: macos-latest
+    needs:
+      - build-android
+      - build-linux
+      - build-windows
+      - build-macos
+    runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
 
-      - name: Download compose-webview artifacts
+      - name: Set release variables
-        uses: actions/download-artifact@v4
+        id: vars
-        with:
-          name: maven-local-composewebview
-          path: ~/.m2/repository/io/github/kdroidfilter/
-
-      - name: Download gradle-plugin artifacts
-        uses: actions/download-artifact@v4
-        with:
-          name: maven-local-gradle-plugin
-          path: ~/.m2/repository/dev/krtirtho/spotube/
-
-      - name: Set up JDK 21
-        uses: actions/setup-java@v4
-        with:
-          distribution: temurin
-          java-version: 21
-
-      - name: Set up Gradle
-        uses: gradle/actions/setup-gradle@v4
-
-      - name: Build Kotlin framework
-        run: ./gradlew :composeApp:linkReleaseFrameworkIosArm64
-
-      - name: Build iOS app
         run: |
-          xcodebuild \
+          if [ "${{ inputs.release_type }}" = "stable" ]; then
-            -project iosApp/iosApp.xcodeproj \
+            VERSION=$(grep 'versionName' composeApp/build.gradle.kts | head -1 | sed 's/.*"\(.*\)".*/\1/')
-            -scheme iosApp \
+            TAG="v${VERSION}"
-            -sdk iphoneos \
+            echo "is_prerelease=false" >> "$GITHUB_OUTPUT"
-            -configuration Release \
+            echo "is_draft=true" >> "$GITHUB_OUTPUT"
-            -destination 'generic/platform=iOS' \
+            echo "release_name=Spotube ${TAG}" >> "$GITHUB_OUTPUT"
-            CODE_SIGN_IDENTITY="" \
+          else
-            CODE_SIGNING_REQUIRED=NO \
+            TAG="nightly"
-            CODE_SIGNING_ALLOWED=NO \
+            VERSION="$(date +%Y-%m-%d)"
-            CONFIGURATION_BUILD_DIR="${{ github.workspace }}/build/ios" \
+            echo "is_prerelease=true" >> "$GITHUB_OUTPUT"
-            build
+            echo "is_draft=false" >> "$GITHUB_OUTPUT"
+            echo "release_name=Nightly ${VERSION}" >> "$GITHUB_OUTPUT"
+          fi
+          echo "tag=${TAG}" >> "$GITHUB_OUTPUT"
 
-      - name: Upload .app
+      - name: Download all artifacts
-        uses: actions/upload-artifact@v4
+        uses: actions/download-artifact@v4
+
+      - name: Generate release notes
+        run: |
+          echo "## Downloads" > release-notes.md
+          echo "" >> release-notes.md
+          for dir in android-apk android-aab linux-deb linux-rpm linux-appimage windows-msi windows-exe macos-dmg; do
+            if [ -d "$dir" ]; then
+              echo "### $dir" >> release-notes.md
+              for f in "$dir"/*; do
+                echo "- \`$(basename "$f")\`" >> release-notes.md
+              done
+              echo "" >> release-notes.md
+            fi
+          done
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v2
         with:
-          name: ios-app
+          tag_name: ${{ steps.vars.outputs.tag }}
-          path: build/ios/*.app
+          name: ${{ steps.vars.outputs.release_name }}
+          body_path: release-notes.md
+          draft: ${{ steps.vars.outputs.is_draft }}
+          prerelease: ${{ steps.vars.outputs.is_prerelease }}
+          files: |
+            android-apk/*.apk
+            android-aab/*.aab
+            linux-deb/*.deb
+            linux-rpm/*.rpm
+            linux-appimage/*.AppImage
+            windows-msi/*.msi
+            windows-exe/*.exe
+            macos-dmg/*.dmg

AGENTS.md

@@ -40,4 +40,15 @@
 - Foojay toolchain resolver in use (`plugins { id("org.gradle.toolchains.foojay-resolver-convention") }`).
 
 ## Current testing reality
-- No committed `*Test*.kt` files; test tasks may run zero tests unless new tests are added.
+- No committed `*Test*.kt` files; test tasks may run zero tests unless new tests are added.
+
+## Release workflow (`.github/workflows/release.yml`)
+- Triggered by `workflow_dispatch` with a `release_type` choice input (`stable` | `nightly`).
+- `prepare-deps` job checks out & publishes to `mavenLocal`:
+  - `kdroidFilter/ComposeNativeWebview` (compose-webview)
+  - `team-spotube/gradle-plugin` (spotubeGradle + vlcjBundler plugins)
+- Build jobs per platform (Android, Linux, Windows, macOS), all `needs: prepare-deps`.
+- **Stable**: reads `versionName` from `composeApp/build.gradle.kts`, tag = `v{version}`, draft release.
+- **Nightly**: builds with `-PversionName=nightly`, tag = `nightly` (updates existing), prerelease.
+- **Android signing**: decodes `secrets.KEYSTORE` (base64) → `composeApp/upload-keystore.jks`, writes signing config into `local.properties` from secrets.
+- `create-release` job (depends on all builds) uses `softprops/action-gh-release@v2` to create the GitHub release with all artifacts attached.

composeApp/build.gradle.kts

@@ -228,7 +228,7 @@ android {
         minSdk = libs.versions.android.minSdk.get().toInt()
         targetSdk = libs.versions.android.targetSdk.get().toInt()
         versionCode = 1
-        versionName = "1.0"
+        versionName = project.findProperty("versionName") as String? ?: "1.0"
     }
     packaging {
         resources {
@@ -289,7 +289,7 @@ compose.desktop {
 
         nativeDistributions {
             packageName = "dev.krtirtho.spotube"
-            packageVersion = "6.0.0"
+            packageVersion = project.findProperty("versionName") as String? ?: "6.0.0"
             licenseFile = project.file("../LICENSE")
 
             targetFormats(