Gitea Actions - Flutter Release Workflow
This workflow automatically builds and releases rmtPocketWatcher Flutter app for Windows and Android when you push a version tag.
🚀 Current Build Targets
- Windows: Native desktop application (.zip)
- Android: APK package (.apk)
📱 Migration from Electron
⚠️ ELECTRON VERSION DEPRECATED: The Electron version has been replaced with Flutter for better cross-platform support, native performance, and mobile compatibility.
How to Trigger a Release
-
Update version in
flutter_app/pubspec.yaml:version: 1.2.3+4 # Update this line -
Push changes to main branch:
git add flutter_app/pubspec.yaml git commit -m "Bump version to 1.2.3" git push origin main -
The workflow will automatically:
- Build Windows desktop application
- Build Android APK
- Create a GitHub/Gitea release with both binaries
- Include release notes with download instructions
🔧 Manual Release Build
To trigger a manual release build:
- Go to Actions tab in your repository
- Select "Flutter Release" workflow
- Click "Run workflow"
This will create production builds for both Windows and Android and publish a release.
🏗️ Local Development
Windows
cd flutter_app
flutter pub get
flutter run -d windows
Android
cd flutter_app
flutter pub get
flutter run -d android # Requires connected device/emulator
Build Release Locally
cd flutter_app
flutter build windows --release # Windows
flutter build apk --release # Android
📋 Requirements
- Gitea Actions enabled on repository
- Runners configured for
windows-latestandubuntu-latest - Repository write permissions for releases
- Flutter 3.24.0+ installed on runners
- Java 17 for Android builds
🔍 Troubleshooting
If the workflow fails:
- Check Flutter version compatibility
- Verify all dependencies in
pubspec.yaml - Ensure Android SDK is properly configured
- Check Gitea Actions logs for specific errors
- Verify GITHUB_TOKEN permissions
📦 Release Assets
Each release includes:
rmtPocketWatcher-Windows-v{version}.zip- Windows desktop apprmtPocketWatcher-Android-v{version}.apk- Android mobile app- Detailed release notes with installation instructions