From 55b61e8d0b99a6e7b959d4f69b914f267d9fc92b Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 8 Dec 2025 14:14:27 +0000
Subject: [PATCH 1/8] Initial plan


From 56ef0b8a4b78e8637982194ccd72f29e3f943bfd Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 8 Dec 2025 14:18:04 +0000
Subject: [PATCH 2/8] Add release workflow with version validation and artifact
 publishing

Co-authored-by: wysaid <1430725+wysaid@users.noreply.github.com>
---
 .github/workflows/release.yml | 259 ++++++++++++++++++++++++++++++++++
 1 file changed, 259 insertions(+)
 create mode 100644 .github/workflows/release.yml

diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
new file mode 100644
index 00000000..e094b1f1
--- /dev/null
+++ b/.github/workflows/release.yml
@@ -0,0 +1,259 @@
+name: Build and Release
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'  # Official release tags (e.g., v3.1.1)
+
+jobs:
+  validate-and-release:
+    name: Validate Version and Build Release
+    runs-on: ubuntu-latest
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+    
+    - name: Setup NDK
+      uses: nttld/setup-ndk@v1.4.2
+      id: setup-ndk
+      with:
+        ndk-version: r26d
+        link-to-sdk: true
+        add-to-path: true
+    
+    - name: Install Ninja
+      run: sudo apt-get update && sudo apt-get install -y ninja-build
+    
+    - name: Set up JDK 17
+      uses: actions/setup-java@v3
+      with:
+        java-version: '17'
+        distribution: 'temurin'
+        cache: gradle
+    
+    - name: Grant execute permission for scripts
+      run: chmod +x gradlew tasks.sh publish.sh
+    
+    - name: Extract tag version
+      id: tag_version
+      run: |
+        TAG_NAME="${GITHUB_REF#refs/tags/}"
+        echo "tag_name=$TAG_NAME" >> $GITHUB_OUTPUT
+        
+        # Extract version numbers (e.g., v3.1.1 -> 3.1.1)
+        if [[ $TAG_NAME =~ ^v([0-9]+)\.([0-9]+)\.([0-9]+)$ ]]; then
+          VERSION="${BASH_REMATCH[1]}.${BASH_REMATCH[2]}.${BASH_REMATCH[3]}"
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "✅ Valid version tag: $TAG_NAME (version: $VERSION)"
+        else
+          echo "❌ Invalid tag format: $TAG_NAME"
+          echo "Tag must be in format: v\${major}.\${minor}.\${patch} (e.g., v3.1.1)"
+          exit 1
+        fi
+    
+    - name: Validate version matches project version
+      run: |
+        PROJECT_VERSION=$(grep -E '^\s*versionName\s*:' build.gradle | sed -E 's/.*versionName\s*:\s*"([^"]+)".*/\1/')
+        TAG_VERSION="${{ steps.tag_version.outputs.version }}"
+        
+        echo "Project version: $PROJECT_VERSION"
+        echo "Tag version: $TAG_VERSION"
+        
+        if [ "$PROJECT_VERSION" != "$TAG_VERSION" ]; then
+          echo "❌ Version mismatch!"
+          echo "Tag version ($TAG_VERSION) does not match project version ($PROJECT_VERSION)"
+          echo "Please update the versionName in build.gradle to match the tag, or use the correct tag."
+          exit 1
+        fi
+        
+        echo "✅ Version validation passed: $TAG_VERSION"
+    
+    - name: Setup local.properties for publishing
+      run: |
+        # Create local.properties with necessary configurations
+        mkdir -p /tmp/maven-repo
+        cat > local.properties << EOF
+        usingCMakeCompile=true
+        usingCMakeCompileDebug=false
+        deployArtifacts=true
+        localRepoDir=/tmp/maven-repo
+        EOF
+        
+        echo "✅ local.properties configured for publishing"
+        cat local.properties
+    
+    - name: Build all artifact variants
+      run: |
+        echo "🔨 Building all 4 artifact variants..."
+        bash -e ./publish.sh
+        
+        echo "✅ All artifacts built successfully"
+        echo "📦 Generated artifacts:"
+        find /tmp/maven-repo -type f -name "*.aar" -o -name "*.pom" | sort
+    
+    - name: Build demo APK with video module
+      run: |
+        echo "🔨 Building demo APK with video module (default configuration)..."
+        ./tasks.sh --enable-cmake --release --enable-video-module --build
+        
+        # Find and copy the APK
+        APK_PATH=$(find "cgeDemo/build" -name "*.apk" | grep -i release | head -1)
+        if [ -z "$APK_PATH" ]; then
+          echo "❌ APK not found!"
+          exit 1
+        fi
+        
+        mkdir -p /tmp/release-artifacts
+        cp "$APK_PATH" /tmp/release-artifacts/cgeDemo-${{ steps.tag_version.outputs.version }}.apk
+        
+        echo "✅ Demo APK built successfully"
+        ls -lh /tmp/release-artifacts/
+    
+    - name: Package AAR artifacts
+      run: |
+        echo "📦 Packaging AAR artifacts..."
+        
+        VERSION="${{ steps.tag_version.outputs.version }}"
+        MAVEN_REPO="/tmp/maven-repo"
+        ARTIFACTS_DIR="/tmp/release-artifacts"
+        
+        # Find all AAR files
+        find "$MAVEN_REPO" -name "*.aar" | while read aar_file; do
+          # Extract variant info from path
+          if [[ $aar_file =~ gpuimage-plus-([0-9.]+(-[^/]+)?)/gpuimage-plus-[0-9.]+(-[^/]+)?\.aar ]]; then
+            VARIANT="${BASH_REMATCH[1]}"
+            # Normalize variant name for file
+            VARIANT_NAME=$(echo "$VARIANT" | sed 's/\./-/g')
+            cp "$aar_file" "$ARTIFACTS_DIR/gpuimage-plus-${VARIANT}.aar"
+            echo "  ✓ Packaged: gpuimage-plus-${VARIANT}.aar"
+          fi
+        done
+        
+        echo "✅ All AAR artifacts packaged"
+        echo "📦 Final artifacts:"
+        ls -lh "$ARTIFACTS_DIR/"
+    
+    - name: Generate release notes
+      id: release_notes
+      run: |
+        cat > /tmp/release_notes.md << 'EOF'
+        ## 🚀 Android GPUImage Plus ${{ steps.tag_version.outputs.tag_name }}
+        
+        ### 📦 Downloads
+        
+        **Demo APK:**
+        - `cgeDemo-${{ steps.tag_version.outputs.version }}.apk` - Demo application with full video features
+        
+        **AAR Library Artifacts:**
+        
+        Four variants are available for different use cases:
+        
+        1. **gpuimage-plus-${{ steps.tag_version.outputs.version }}.aar**
+           - Page size: 4KB (default)
+           - Full-featured with FFmpeg bundled
+           - Architectures: armeabi-v7a, arm64-v8a, x86, x86_64
+        
+        2. **gpuimage-plus-${{ steps.tag_version.outputs.version }}-16k.aar**
+           - Page size: 16KB
+           - Full-featured with FFmpeg bundled
+           - Architectures: armeabi-v7a, arm64-v8a, x86, x86_64
+        
+        3. **gpuimage-plus-${{ steps.tag_version.outputs.version }}-min.aar**
+           - Page size: 4KB (default)
+           - Image-only version (no video features or FFmpeg)
+           - Architectures: armeabi-v7a, arm64-v8a, x86, x86_64
+        
+        4. **gpuimage-plus-${{ steps.tag_version.outputs.version }}-16k-min.aar**
+           - Page size: 16KB
+           - Image-only version (no video features or FFmpeg)
+           - Architectures: armeabi-v7a, arm64-v8a, x86, x86_64
+        
+        ### 🔧 Gradle Dependency
+        
+        ```gradle
+        allprojects {
+            repositories {
+                maven {
+                    url 'https://maven.wysaid.org/'
+                }
+            }
+        }
+        
+        dependencies {
+            // Choose one of the following based on your needs:
+            
+            // Full-featured with FFmpeg (4KB page size)
+            implementation 'org.wysaid:gpuimage-plus:${{ steps.tag_version.outputs.version }}'
+            
+            // Full-featured with FFmpeg (16KB page size)
+            implementation 'org.wysaid:gpuimage-plus:${{ steps.tag_version.outputs.version }}-16k'
+            
+            // Image-only, no video (4KB page size)
+            implementation 'org.wysaid:gpuimage-plus:${{ steps.tag_version.outputs.version }}-min'
+            
+            // Image-only, no video (16KB page size)
+            implementation 'org.wysaid:gpuimage-plus:${{ steps.tag_version.outputs.version }}-16k-min'
+        }
+        ```
+        
+        ### 📋 System Requirements
+        
+        - **Minimum Android SDK**: API 21 (Android 5.0)
+        - **Target Android SDK**: API 25
+        - **NDK Version**: r26d
+        - **Supported Architectures**: armeabi-v7a, arm64-v8a, x86, x86_64
+        
+        ### 📚 Documentation
+        
+        - **GitHub Repository**: https://github.com/wysaid/android-gpuimage-plus
+        - **Wiki**: https://github.com/wysaid/android-gpuimage-plus/wiki
+        - **Filter Rule Documentation**: https://github.com/wysaid/android-gpuimage-plus/wiki/Parsing-String-Rule-(EN)
+        
+        ---
+        
+        For complete changelog, see the auto-generated content below.
+        EOF
+        
+        echo "✅ Release notes generated"
+    
+    - name: Create GitHub Release
+      uses: softprops/action-gh-release@v2
+      with:
+        tag_name: ${{ steps.tag_version.outputs.tag_name }}
+        name: Release ${{ steps.tag_version.outputs.tag_name }}
+        body_path: /tmp/release_notes.md
+        files: |
+          /tmp/release-artifacts/*.apk
+          /tmp/release-artifacts/*.aar
+        draft: false
+        prerelease: false
+        generate_release_notes: true
+        make_latest: true
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    
+    - name: Summary
+      run: |
+        echo "## 🎉 Release Created Successfully!" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "**Release**: ${{ steps.tag_version.outputs.tag_name }}" >> $GITHUB_STEP_SUMMARY
+        echo "**Version**: ${{ steps.tag_version.outputs.version }}" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "### ✅ Version Validation" >> $GITHUB_STEP_SUMMARY
+        echo "- ✅ Tag format validated: v\${major}.\${minor}.\${patch}" >> $GITHUB_STEP_SUMMARY
+        echo "- ✅ Version matches project version in build.gradle" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "### 📦 Released Artifacts:" >> $GITHUB_STEP_SUMMARY
+        echo "**Demo APK:**" >> $GITHUB_STEP_SUMMARY
+        echo "- cgeDemo-${{ steps.tag_version.outputs.version }}.apk" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "**AAR Libraries:**" >> $GITHUB_STEP_SUMMARY
+        echo "- gpuimage-plus-${{ steps.tag_version.outputs.version }}.aar (4KB, with video)" >> $GITHUB_STEP_SUMMARY
+        echo "- gpuimage-plus-${{ steps.tag_version.outputs.version }}-16k.aar (16KB, with video)" >> $GITHUB_STEP_SUMMARY
+        echo "- gpuimage-plus-${{ steps.tag_version.outputs.version }}-min.aar (4KB, image-only)" >> $GITHUB_STEP_SUMMARY
+        echo "- gpuimage-plus-${{ steps.tag_version.outputs.version }}-16k-min.aar (16KB, image-only)" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "Release page: ${{ github.server_url }}/${{ github.repository }}/releases/tag/${{ steps.tag_version.outputs.tag_name }}" >> $GITHUB_STEP_SUMMARY

From 5cfce791c0a7469fc7259abd337bee42308aef2b Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 8 Dec 2025 14:20:54 +0000
Subject: [PATCH 3/8] Fix version extraction regex and update setup-java to v4

Co-authored-by: wysaid <1430725+wysaid@users.noreply.github.com>
---
 .github/workflows/release.yml | 20 ++++++++------------
 1 file changed, 8 insertions(+), 12 deletions(-)

diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index e094b1f1..c1b388f0 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -28,7 +28,7 @@ jobs:
       run: sudo apt-get update && sudo apt-get install -y ninja-build
     
     - name: Set up JDK 17
-      uses: actions/setup-java@v3
+      uses: actions/setup-java@v4
       with:
         java-version: '17'
         distribution: 'temurin'
@@ -56,7 +56,7 @@ jobs:
     
     - name: Validate version matches project version
       run: |
-        PROJECT_VERSION=$(grep -E '^\s*versionName\s*:' build.gradle | sed -E 's/.*versionName\s*:\s*"([^"]+)".*/\1/')
+        PROJECT_VERSION=$(grep -E 'versionName\s*:' build.gradle | sed -E 's/.*versionName\s*:\s*"([^"]+)".*/\1/')
         TAG_VERSION="${{ steps.tag_version.outputs.version }}"
         
         echo "Project version: $PROJECT_VERSION"
@@ -120,16 +120,12 @@ jobs:
         MAVEN_REPO="/tmp/maven-repo"
         ARTIFACTS_DIR="/tmp/release-artifacts"
         
-        # Find all AAR files
-        find "$MAVEN_REPO" -name "*.aar" | while read aar_file; do
-          # Extract variant info from path
-          if [[ $aar_file =~ gpuimage-plus-([0-9.]+(-[^/]+)?)/gpuimage-plus-[0-9.]+(-[^/]+)?\.aar ]]; then
-            VARIANT="${BASH_REMATCH[1]}"
-            # Normalize variant name for file
-            VARIANT_NAME=$(echo "$VARIANT" | sed 's/\./-/g')
-            cp "$aar_file" "$ARTIFACTS_DIR/gpuimage-plus-${VARIANT}.aar"
-            echo "  ✓ Packaged: gpuimage-plus-${VARIANT}.aar"
-          fi
+        # Find and copy all AAR files from the maven repository
+        # Expected structure: /tmp/maven-repo/org/wysaid/gpuimage-plus/{version}/gpuimage-plus-{version}.aar
+        find "$MAVEN_REPO/org/wysaid/gpuimage-plus" -name "*.aar" | while read aar_file; do
+          filename=$(basename "$aar_file")
+          cp "$aar_file" "$ARTIFACTS_DIR/$filename"
+          echo "  ✓ Packaged: $filename"
         done
         
         echo "✅ All AAR artifacts packaged"

From 262722b2a5509d8ee4e37f13164014577665c073 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 8 Dec 2025 14:22:18 +0000
Subject: [PATCH 4/8] Add explicit permissions to release workflow for security

Co-authored-by: wysaid <1430725+wysaid@users.noreply.github.com>
---
 .github/workflows/release.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index c1b388f0..ae47cbb0 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -10,6 +10,9 @@ jobs:
     name: Validate Version and Build Release
     runs-on: ubuntu-latest
     
+    permissions:
+      contents: write  # Required for creating releases and uploading artifacts
+    
     steps:
     - name: Checkout code
       uses: actions/checkout@v4

From 9a83ea566367d6b1e05bf0e69f75204f08c0d8a2 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 8 Dec 2025 14:23:28 +0000
Subject: [PATCH 5/8] Add release process documentation to README

Co-authored-by: wysaid <1430725+wysaid@users.noreply.github.com>
---
 README.md | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/README.md b/README.md
index 4ed9db89..915f5570 100644
--- a/README.md
+++ b/README.md
@@ -239,6 +239,57 @@ Some utils are available for creating filters: [https://github.com/wysaid/cge-to
 
 [![Tool](https://raw.githubusercontent.com/wysaid/cge-tools/master/screenshots/0.jpg "cge-tool")](https://github.com/wysaid/cge-tools)
 
+## Release Process
+
+This project uses an automated release workflow that is triggered by version tags.
+
+### Creating a Release
+
+1. **Update the version** in `build.gradle`:
+   ```gradle
+   ext {
+       android = [
+           ...
+           versionName: "3.1.1",  // Update this version
+           ...
+       ]
+   }
+   ```
+
+2. **Commit and push** the version change:
+   ```bash
+   git add build.gradle
+   git commit -m "Bump version to 3.1.1"
+   git push
+   ```
+
+3. **Create and push a tag** matching the version:
+   ```bash
+   git tag v3.1.1
+   git push origin v3.1.1
+   ```
+
+### What Happens Automatically
+
+When you push a tag in the format `v*.*.*` (e.g., `v3.1.1`), the release workflow will:
+
+1. **Validate** that the tag version matches the `versionName` in `build.gradle`
+2. **Build** all four AAR variants:
+   - `gpuimage-plus-{version}.aar` - Full-featured with FFmpeg (4KB page size)
+   - `gpuimage-plus-{version}-16k.aar` - Full-featured with FFmpeg (16KB page size)
+   - `gpuimage-plus-{version}-min.aar` - Image-only, no video (4KB page size)
+   - `gpuimage-plus-{version}-16k-min.aar` - Image-only, no video (16KB page size)
+3. **Build** the demo APK with video module
+4. **Create** a GitHub release with all artifacts and release notes
+
+### Requirements
+
+- Tag must be in the format: `v{major}.{minor}.{patch}` (e.g., `v3.1.1`)
+- Tag version must exactly match the `versionName` in `build.gradle`
+- All version parts must be pure numbers
+
+If the validation fails, the workflow will report an error and stop.
+
 ## License
 
 [MIT License](https://github.com/wysaid/android-gpuimage-plus/blob/master/LICENSE)

From d2ac74d7456c1364e09b5c67474f225be27771b7 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 8 Dec 2025 14:24:50 +0000
Subject: [PATCH 6/8] Improve APK detection and fix AAR packaging loop for
 robustness

Co-authored-by: wysaid <1430725+wysaid@users.noreply.github.com>
---
 .github/workflows/release.yml | 22 +++++++++++++++-------
 1 file changed, 15 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index ae47cbb0..92d8fa74 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -102,10 +102,16 @@ jobs:
         echo "🔨 Building demo APK with video module (default configuration)..."
         ./tasks.sh --enable-cmake --release --enable-video-module --build
         
-        # Find and copy the APK
-        APK_PATH=$(find "cgeDemo/build" -name "*.apk" | grep -i release | head -1)
+        # Find and copy the APK (look specifically for release build output)
+        APK_PATH=$(find "cgeDemo/build/outputs/apk/release" -name "*-release.apk" -o -name "*-release-unsigned.apk" | head -1)
+        if [ -z "$APK_PATH" ]; then
+          # Fallback: search in build directory
+          APK_PATH=$(find "cgeDemo/build" -path "*/release/*" -name "*.apk" | head -1)
+        fi
         if [ -z "$APK_PATH" ]; then
           echo "❌ APK not found!"
+          echo "Searched locations:"
+          find "cgeDemo/build" -name "*.apk" || echo "No APK files found"
           exit 1
         fi
         
@@ -125,11 +131,13 @@ jobs:
         
         # Find and copy all AAR files from the maven repository
         # Expected structure: /tmp/maven-repo/org/wysaid/gpuimage-plus/{version}/gpuimage-plus-{version}.aar
-        find "$MAVEN_REPO/org/wysaid/gpuimage-plus" -name "*.aar" | while read aar_file; do
-          filename=$(basename "$aar_file")
-          cp "$aar_file" "$ARTIFACTS_DIR/$filename"
-          echo "  ✓ Packaged: $filename"
-        done
+        while IFS= read -r aar_file; do
+          if [ -n "$aar_file" ]; then
+            filename=$(basename "$aar_file")
+            cp "$aar_file" "$ARTIFACTS_DIR/$filename"
+            echo "  ✓ Packaged: $filename"
+          fi
+        done < <(find "$MAVEN_REPO/org/wysaid/gpuimage-plus" -name "*.aar")
         
         echo "✅ All AAR artifacts packaged"
         echo "📦 Final artifacts:"

From 4032fc27956861cc04a7371c2286e9f6e5b74703 Mon Sep 17 00:00:00 2001
From: "wangyang (wysaid)" <wysaid@gmail.com>
Date: Tue, 9 Dec 2025 01:20:33 +0800
Subject: [PATCH 7/8] Fix PR review comments and add manual workflow trigger
 support

Fixes:
- Fix find command operator precedence with proper parentheses
- Fix heredoc delimiter to allow variable interpolation
- Add --disable-16kb-page-size flag to demo APK build
- Add validation for exactly 4 AAR files

Features:
- Add workflow_dispatch trigger for manual builds
- Manual builds upload artifacts instead of creating releases
- Differentiate manual vs tag-triggered builds in logs and summary
---
 .github/workflows/release.yml | 172 +++++++++++++++++++++++++---------
 1 file changed, 129 insertions(+), 43 deletions(-)

diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 92d8fa74..cd696ad9 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -4,6 +4,12 @@ on:
   push:
     tags:
       - 'v*.*.*'  # Official release tags (e.g., v3.1.1)
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version number (e.g., 3.1.1) - Manual trigger will NOT publish to Release page'
+        required: true
+        type: string
 
 jobs:
   validate-and-release:
@@ -43,19 +49,39 @@ jobs:
     - name: Extract tag version
       id: tag_version
       run: |
-        TAG_NAME="${GITHUB_REF#refs/tags/}"
-        echo "tag_name=$TAG_NAME" >> $GITHUB_OUTPUT
-        
-        # Extract version numbers (e.g., v3.1.1 -> 3.1.1)
-        if [[ $TAG_NAME =~ ^v([0-9]+)\.([0-9]+)\.([0-9]+)$ ]]; then
-          VERSION="${BASH_REMATCH[1]}.${BASH_REMATCH[2]}.${BASH_REMATCH[3]}"
-          echo "version=$VERSION" >> $GITHUB_OUTPUT
-          echo "✅ Valid version tag: $TAG_NAME (version: $VERSION)"
+        # Determine if this is a manual trigger or tag push
+        if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+          # Manual trigger - use input version
+          VERSION="${{ github.event.inputs.version }}"
+          TAG_NAME="v$VERSION"
+          IS_MANUAL="true"
+          echo "🔧 Manual trigger detected"
         else
-          echo "❌ Invalid tag format: $TAG_NAME"
-          echo "Tag must be in format: v\${major}.\${minor}.\${patch} (e.g., v3.1.1)"
+          # Tag push - extract from ref
+          TAG_NAME="${GITHUB_REF#refs/tags/}"
+          IS_MANUAL="false"
+          
+          # Extract version numbers (e.g., v3.1.1 -> 3.1.1)
+          if [[ $TAG_NAME =~ ^v([0-9]+)\.([0-9]+)\.([0-9]+)$ ]]; then
+            VERSION="${BASH_REMATCH[1]}.${BASH_REMATCH[2]}.${BASH_REMATCH[3]}"
+          else
+            echo "❌ Invalid tag format: $TAG_NAME"
+            echo "Tag must be in format: v\${major}.\${minor}.\${patch} (e.g., v3.1.1)"
+            exit 1
+          fi
+        fi
+        
+        # Validate version format
+        if [[ ! $VERSION =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+          echo "❌ Invalid version format: $VERSION"
+          echo "Version must be in format: \${major}.\${minor}.\${patch} (e.g., 3.1.1)"
           exit 1
         fi
+        
+        echo "tag_name=$TAG_NAME" >> $GITHUB_OUTPUT
+        echo "version=$VERSION" >> $GITHUB_OUTPUT
+        echo "is_manual=$IS_MANUAL" >> $GITHUB_OUTPUT
+        echo "✅ Valid version: $VERSION (tag: $TAG_NAME, manual: $IS_MANUAL)"
     
     - name: Validate version matches project version
       run: |
@@ -95,15 +121,15 @@ jobs:
         
         echo "✅ All artifacts built successfully"
         echo "📦 Generated artifacts:"
-        find /tmp/maven-repo -type f -name "*.aar" -o -name "*.pom" | sort
+        find /tmp/maven-repo -type f \( -name "*.aar" -o -name "*.pom" \) | sort
     
     - name: Build demo APK with video module
       run: |
         echo "🔨 Building demo APK with video module (default configuration)..."
-        ./tasks.sh --enable-cmake --release --enable-video-module --build
+        ./tasks.sh --enable-cmake --release --enable-video-module --disable-16kb-page-size --build
         
         # Find and copy the APK (look specifically for release build output)
-        APK_PATH=$(find "cgeDemo/build/outputs/apk/release" -name "*-release.apk" -o -name "*-release-unsigned.apk" | head -1)
+        APK_PATH=$(find "cgeDemo/build/outputs/apk/release" \( -name "*-release.apk" -o -name "*-release-unsigned.apk" \) | head -1)
         if [ -z "$APK_PATH" ]; then
           # Fallback: search in build directory
           APK_PATH=$(find "cgeDemo/build" -path "*/release/*" -name "*.apk" | head -1)
@@ -139,48 +165,57 @@ jobs:
           fi
         done < <(find "$MAVEN_REPO/org/wysaid/gpuimage-plus" -name "*.aar")
         
-        echo "✅ All AAR artifacts packaged"
+        # Validate that we have exactly 4 AAR files
+        AAR_COUNT=$(find "$ARTIFACTS_DIR" -name "*.aar" | wc -l)
+        if [ "$AAR_COUNT" -ne 4 ]; then
+          echo "❌ Expected 4 AAR files but found $AAR_COUNT"
+          exit 1
+        fi
+        
+        echo "✅ All AAR artifacts packaged ($AAR_COUNT files)"
         echo "📦 Final artifacts:"
         ls -lh "$ARTIFACTS_DIR/"
     
     - name: Generate release notes
       id: release_notes
       run: |
-        cat > /tmp/release_notes.md << 'EOF'
-        ## 🚀 Android GPUImage Plus ${{ steps.tag_version.outputs.tag_name }}
+        VERSION="${{ steps.tag_version.outputs.version }}"
+        TAG_NAME="${{ steps.tag_version.outputs.tag_name }}"
+        cat > /tmp/release_notes.md << EOF
+        ## 🚀 Android GPUImage Plus $TAG_NAME
         
         ### 📦 Downloads
         
         **Demo APK:**
-        - `cgeDemo-${{ steps.tag_version.outputs.version }}.apk` - Demo application with full video features
+        - \`cgeDemo-$VERSION.apk\` - Demo application with full video features
         
         **AAR Library Artifacts:**
         
         Four variants are available for different use cases:
         
-        1. **gpuimage-plus-${{ steps.tag_version.outputs.version }}.aar**
+        1. **gpuimage-plus-$VERSION.aar**
            - Page size: 4KB (default)
            - Full-featured with FFmpeg bundled
            - Architectures: armeabi-v7a, arm64-v8a, x86, x86_64
         
-        2. **gpuimage-plus-${{ steps.tag_version.outputs.version }}-16k.aar**
+        2. **gpuimage-plus-$VERSION-16k.aar**
            - Page size: 16KB
            - Full-featured with FFmpeg bundled
            - Architectures: armeabi-v7a, arm64-v8a, x86, x86_64
         
-        3. **gpuimage-plus-${{ steps.tag_version.outputs.version }}-min.aar**
+        3. **gpuimage-plus-$VERSION-min.aar**
            - Page size: 4KB (default)
            - Image-only version (no video features or FFmpeg)
            - Architectures: armeabi-v7a, arm64-v8a, x86, x86_64
         
-        4. **gpuimage-plus-${{ steps.tag_version.outputs.version }}-16k-min.aar**
+        4. **gpuimage-plus-$VERSION-16k-min.aar**
            - Page size: 16KB
            - Image-only version (no video features or FFmpeg)
            - Architectures: armeabi-v7a, arm64-v8a, x86, x86_64
         
         ### 🔧 Gradle Dependency
         
-        ```gradle
+        \`\`\`gradle
         allprojects {
             repositories {
                 maven {
@@ -193,18 +228,18 @@ jobs:
             // Choose one of the following based on your needs:
             
             // Full-featured with FFmpeg (4KB page size)
-            implementation 'org.wysaid:gpuimage-plus:${{ steps.tag_version.outputs.version }}'
+            implementation 'org.wysaid:gpuimage-plus:$VERSION'
             
             // Full-featured with FFmpeg (16KB page size)
-            implementation 'org.wysaid:gpuimage-plus:${{ steps.tag_version.outputs.version }}-16k'
+            implementation 'org.wysaid:gpuimage-plus:$VERSION-16k'
             
             // Image-only, no video (4KB page size)
-            implementation 'org.wysaid:gpuimage-plus:${{ steps.tag_version.outputs.version }}-min'
+            implementation 'org.wysaid:gpuimage-plus:$VERSION-min'
             
             // Image-only, no video (16KB page size)
-            implementation 'org.wysaid:gpuimage-plus:${{ steps.tag_version.outputs.version }}-16k-min'
+            implementation 'org.wysaid:gpuimage-plus:$VERSION-16k-min'
         }
-        ```
+        \`\`\`
         
         ### 📋 System Requirements
         
@@ -227,6 +262,7 @@ jobs:
         echo "✅ Release notes generated"
     
     - name: Create GitHub Release
+      if: steps.tag_version.outputs.is_manual != 'true'
       uses: softprops/action-gh-release@v2
       with:
         tag_name: ${{ steps.tag_version.outputs.tag_name }}
@@ -242,25 +278,75 @@ jobs:
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
     
+    - name: Upload artifacts (Manual trigger)
+      if: steps.tag_version.outputs.is_manual == 'true'
+      uses: actions/upload-artifact@v4
+      with:
+        name: release-artifacts-${{ steps.tag_version.outputs.version }}
+        path: /tmp/release-artifacts/
+        retention-days: 7
+    
+    - name: Manual trigger success message
+      if: steps.tag_version.outputs.is_manual == 'true'
+      run: |
+        echo "🎉 ============================================" 
+        echo "🎉 Manual build completed successfully!"
+        echo "🎉 ============================================"
+        echo ""
+        echo "📦 Version: ${{ steps.tag_version.outputs.version }}"
+        echo "📦 Artifacts are available for download from the workflow run."
+        echo ""
+        echo "⚠️  Note: This is a manual trigger build."
+        echo "⚠️  Artifacts are NOT published to the Release page."
+        echo "⚠️  To create an official release, push a tag (e.g., git tag v${{ steps.tag_version.outputs.version }} && git push origin v${{ steps.tag_version.outputs.version }})"
+        echo ""
+        echo "📦 Built artifacts:"
+        ls -lh /tmp/release-artifacts/
+    
     - name: Summary
       run: |
-        echo "## 🎉 Release Created Successfully!" >> $GITHUB_STEP_SUMMARY
-        echo "" >> $GITHUB_STEP_SUMMARY
-        echo "**Release**: ${{ steps.tag_version.outputs.tag_name }}" >> $GITHUB_STEP_SUMMARY
-        echo "**Version**: ${{ steps.tag_version.outputs.version }}" >> $GITHUB_STEP_SUMMARY
-        echo "" >> $GITHUB_STEP_SUMMARY
-        echo "### ✅ Version Validation" >> $GITHUB_STEP_SUMMARY
-        echo "- ✅ Tag format validated: v\${major}.\${minor}.\${patch}" >> $GITHUB_STEP_SUMMARY
-        echo "- ✅ Version matches project version in build.gradle" >> $GITHUB_STEP_SUMMARY
-        echo "" >> $GITHUB_STEP_SUMMARY
-        echo "### 📦 Released Artifacts:" >> $GITHUB_STEP_SUMMARY
+        IS_MANUAL="${{ steps.tag_version.outputs.is_manual }}"
+        VERSION="${{ steps.tag_version.outputs.version }}"
+        TAG_NAME="${{ steps.tag_version.outputs.tag_name }}"
+        
+        if [ "$IS_MANUAL" = "true" ]; then
+          echo "## 🔧 Manual Build Completed Successfully!" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "**Version**: $VERSION" >> $GITHUB_STEP_SUMMARY
+          echo "**Trigger**: Manual (workflow_dispatch)" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "### ⚠️ Note" >> $GITHUB_STEP_SUMMARY
+          echo "This is a **manual trigger build**. Artifacts are **NOT published** to the Release page." >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "To create an official release, push a tag:" >> $GITHUB_STEP_SUMMARY
+          echo "\`\`\`bash" >> $GITHUB_STEP_SUMMARY
+          echo "git tag v$VERSION && git push origin v$VERSION" >> $GITHUB_STEP_SUMMARY
+          echo "\`\`\`" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "### 📦 Built Artifacts (available for download):" >> $GITHUB_STEP_SUMMARY
+        else
+          echo "## 🎉 Release Created Successfully!" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "**Release**: $TAG_NAME" >> $GITHUB_STEP_SUMMARY
+          echo "**Version**: $VERSION" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "### ✅ Version Validation" >> $GITHUB_STEP_SUMMARY
+          echo "- ✅ Tag format validated: v\${major}.\${minor}.\${patch}" >> $GITHUB_STEP_SUMMARY
+          echo "- ✅ Version matches project version in build.gradle" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "### 📦 Released Artifacts:" >> $GITHUB_STEP_SUMMARY
+        fi
+        
         echo "**Demo APK:**" >> $GITHUB_STEP_SUMMARY
-        echo "- cgeDemo-${{ steps.tag_version.outputs.version }}.apk" >> $GITHUB_STEP_SUMMARY
+        echo "- cgeDemo-$VERSION.apk" >> $GITHUB_STEP_SUMMARY
         echo "" >> $GITHUB_STEP_SUMMARY
         echo "**AAR Libraries:**" >> $GITHUB_STEP_SUMMARY
-        echo "- gpuimage-plus-${{ steps.tag_version.outputs.version }}.aar (4KB, with video)" >> $GITHUB_STEP_SUMMARY
-        echo "- gpuimage-plus-${{ steps.tag_version.outputs.version }}-16k.aar (16KB, with video)" >> $GITHUB_STEP_SUMMARY
-        echo "- gpuimage-plus-${{ steps.tag_version.outputs.version }}-min.aar (4KB, image-only)" >> $GITHUB_STEP_SUMMARY
-        echo "- gpuimage-plus-${{ steps.tag_version.outputs.version }}-16k-min.aar (16KB, image-only)" >> $GITHUB_STEP_SUMMARY
+        echo "- gpuimage-plus-$VERSION.aar (4KB, with video)" >> $GITHUB_STEP_SUMMARY
+        echo "- gpuimage-plus-$VERSION-16k.aar (16KB, with video)" >> $GITHUB_STEP_SUMMARY
+        echo "- gpuimage-plus-$VERSION-min.aar (4KB, image-only)" >> $GITHUB_STEP_SUMMARY
+        echo "- gpuimage-plus-$VERSION-16k-min.aar (16KB, image-only)" >> $GITHUB_STEP_SUMMARY
         echo "" >> $GITHUB_STEP_SUMMARY
-        echo "Release page: ${{ github.server_url }}/${{ github.repository }}/releases/tag/${{ steps.tag_version.outputs.tag_name }}" >> $GITHUB_STEP_SUMMARY
+        
+        if [ "$IS_MANUAL" != "true" ]; then
+          echo "Release page: ${{ github.server_url }}/${{ github.repository }}/releases/tag/$TAG_NAME" >> $GITHUB_STEP_SUMMARY
+        fi

From 8f60628b7cf667b712ec81efd7e09c02f48d46e9 Mon Sep 17 00:00:00 2001
From: "wangyang (wysaid)" <wysaid@gmail.com>
Date: Tue, 9 Dec 2025 01:46:03 +0800
Subject: [PATCH 8/8] chore: sync release artifacts to maven repo

---
 .github/workflows/release.yml | 80 +++++++++++++++++++++++++++++++++++
 1 file changed, 80 insertions(+)

diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index cd696ad9..825064e0 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -175,6 +175,79 @@ jobs:
         echo "✅ All AAR artifacts packaged ($AAR_COUNT files)"
         echo "📦 Final artifacts:"
         ls -lh "$ARTIFACTS_DIR/"
+
+    - name: Sync artifacts to maven repo and open PR
+      if: steps.tag_version.outputs.is_manual != 'true'
+      id: sync_maven_repo
+      run: |
+        set -euo pipefail
+
+        VERSION="${{ steps.tag_version.outputs.version }}"
+        TAG_NAME="${{ steps.tag_version.outputs.tag_name }}"
+        ARTIFACT_REPO_TOKEN="${{ secrets.ARTIFACT_REPO_TOKEN }}"
+
+        if [[ -z "${ARTIFACT_REPO_TOKEN:-}" ]]; then
+          echo "❌ Missing secret: ARTIFACT_REPO_TOKEN (repo:write to android-gpuimage-plus-maven)"
+          exit 1
+        fi
+
+        ARTIFACT_REPO="wysaid/android-gpuimage-plus-maven"
+        WORKDIR="/tmp/maven-repo-target"
+        SOURCE_REPO="/tmp/maven-repo"
+        BRANCH="sync/v${VERSION}"
+
+        echo "🔄 Cloning artifact repo..."
+        git clone --depth 1 "https://${ARTIFACT_REPO_TOKEN}@github.com/${ARTIFACT_REPO}.git" "$WORKDIR"
+
+        echo "🚚 Syncing generated Maven artifacts..."
+        mkdir -p "$WORKDIR/org/wysaid/gpuimage-plus"
+        rsync -av --delete "${SOURCE_REPO}/org/wysaid/gpuimage-plus/" "$WORKDIR/org/wysaid/gpuimage-plus/"
+
+        echo "🧭 Regenerating index pages"
+        pushd "$WORKDIR"
+        chmod +x genSites.sh
+        ./genSites.sh
+
+        git config user.name "github-actions[bot]"
+        git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+        git checkout -b "$BRANCH"
+        git add org/wysaid/gpuimage-plus || true
+
+        echo "artifact_pr_url=" >> $GITHUB_OUTPUT
+
+        if git diff --cached --quiet; then
+          echo "ℹ️ No changes to publish; skipping PR."
+          exit 0
+        fi
+
+        git commit -m "Publish artifacts ${TAG_NAME}"
+        git push origin "$BRANCH"
+
+        echo "📝 Creating pull request..."
+        PR_BODY="Automated artifact sync for ${TAG_NAME}.\n\nGenerated by main repo release workflow."
+        API_JSON=$(jq -n --arg title "Publish ${TAG_NAME} artifacts" \
+                        --arg head "$BRANCH" \
+                        --arg base "master" \
+                        --arg body "$PR_BODY" \
+                        '{title:$title, head:$head, base:$base, body:$body}')
+
+        PR_RESPONSE=$(curl -sS -X POST \
+          -H "Authorization: token ${ARTIFACT_REPO_TOKEN}" \
+          -H "Accept: application/vnd.github+json" \
+          -d "$API_JSON" \
+          "https://api.github.com/repos/${ARTIFACT_REPO}/pulls")
+
+        echo "PR response: $PR_RESPONSE"
+        PR_URL=$(echo "$PR_RESPONSE" | jq -r '.html_url')
+        if [[ "$PR_URL" == "null" || -z "$PR_URL" ]]; then
+          echo "❌ Failed to create PR"
+          exit 1
+        fi
+
+        echo "✅ PR created: $PR_URL"
+        echo "artifact_pr_url=$PR_URL" >> $GITHUB_OUTPUT
+        popd
     
     - name: Generate release notes
       id: release_notes
@@ -350,3 +423,10 @@ jobs:
         if [ "$IS_MANUAL" != "true" ]; then
           echo "Release page: ${{ github.server_url }}/${{ github.repository }}/releases/tag/$TAG_NAME" >> $GITHUB_STEP_SUMMARY
         fi
+
+        ARTIFACT_PR_URL="${{ steps.sync_maven_repo.outputs.artifact_pr_url }}"
+        if [ -n "$ARTIFACT_PR_URL" ]; then
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "### 📮 Artifact Repository PR" >> $GITHUB_STEP_SUMMARY
+          echo "- $ARTIFACT_PR_URL" >> $GITHUB_STEP_SUMMARY
+        fi