# 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

1. Update version in `flutter_app/pubspec.yaml`:
   ```yaml
   version: 1.2.3+4  # Update this line
   ```

2. Push changes to main branch:
   ```bash
   git add flutter_app/pubspec.yaml
   git commit -m "Bump version to 1.2.3"
   git push origin main
   ```

3. 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 Development Build

To trigger a manual dev build (debug versions):

1. Go to Actions tab in your repository
2. Select "Flutter Dev Build" workflow
3. Click "Run workflow"

This will create debug builds for both Windows and Android.

## 🏗️ Local Development

### Windows
```bash
cd flutter_app
flutter pub get
flutter run -d windows
```

### Android
```bash
cd flutter_app
flutter pub get
flutter run -d android  # Requires connected device/emulator
```

### Build Release Locally
```bash
cd flutter_app
flutter build windows --release  # Windows
flutter build apk --release      # Android
```

## 📋 Requirements

- Gitea Actions enabled on repository
- Runners configured for `windows-latest` and `ubuntu-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 app
- `rmtPocketWatcher-Android-v{version}.apk` - Android mobile app
- Detailed release notes with installation instructions