meshcore-sar/.github/workflows

CI/CD Workflows

Build Multi-Platform Workflow

Automatically builds the MeshCore SAR app for Android, iOS, macOS, and Windows.

Triggers

• Push to main/develop: Builds with version 1.0.0+1 (from pubspec.yaml)
• Pull requests to main: Test builds only
• Version tags (e.g., v1.2.3): Release builds with versioned artifacts
• Manual: Via GitHub Actions UI

Creating a Release

1. Ensure your local version is 1.0.0:

   # pubspec.yaml should show:
   version: 1.0.0+1
   

2. Commit all changes:

   git add .
   git commit -m "Prepare for release"
   git push origin main
   

3. Create and push a version tag:

   git tag v1.2.3
   git push origin v1.2.3
   

4. GitHub Actions will:

   • Temporarily patch version to 1.2.3+<timestamp> in builds only
   • Build Android APK & App Bundle
   • Build iOS app (unsigned - configure secrets for signed IPA)
   • Build macOS DMG
   • Build Windows executable (ZIP)
   • Create a draft GitHub release with all artifacts

5. Publish the release:

   • Go to GitHub Releases
   • Edit the draft release
   • Add release notes
   • Publish

Build Artifacts

Platform	Artifact	Location
Android APK	app-release.apk	artifacts/android-apk/
Android Bundle	app-release.aab	artifacts/android-appbundle/
macOS	MeshCore-SAR.dmg	artifacts/macos-dmg/
iOS	Runner.app	artifacts/ios-build/ (unsigned)
Windows	MeshCore-SAR-Windows.zip	artifacts/windows-executable/

iOS Code Signing (Optional)

To build signed IPA files, add these repository secrets:

1. IOS_P12_BASE64: Base64-encoded .p12 certificate

   base64 -i Certificate.p12 | pbcopy
   

2. IOS_P12_PASSWORD: Password for the .p12 certificate

3. IOS_PROVISION_PROFILE_BASE64: Base64-encoded provisioning profile

   base64 -i Profile.mobileprovision | pbcopy
   

Then uncomment the signing steps in the workflow.

Version Numbering

• Local: Always keep pubspec.yaml at version: 1.0.0+1
• CI builds: Uses 1.0.0+1 for regular commits
• Release builds: Uses <tag>+<timestamp> (e.g., 1.2.3+1729512345)
• No commits: Version changes are temporary and never committed back

Troubleshooting

Build fails on macOS DMG creation:

• The workflow tries create-dmg first, then falls back to hdiutil
• Check if app icon path exists at macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_512.png

Windows build fails:

• Ensure Windows desktop is properly configured in project
• Run locally: flutter config --enable-windows-desktop && flutter build windows

iOS build fails:

• Check CocoaPods version and dependencies
• Review code signing configuration (currently set to --no-codesign)

Android build fails:

• Verify Java 17 is compatible with your Gradle version
• Check android/build.gradle for minimum SDK requirements