mirror of https://github.com/dz0ny/meshcore-sar.git synced 2026-08-12 00:40:28 +00:00

Files

Janez T 963bd8a8aa fix: Move checkout step before artifact downloads in R2 upload job

The actions/checkout@v4 step was running after downloading artifacts,
causing it to wipe out the downloaded files. This resulted in empty
build directories and missing artifacts in the index.html.

By moving checkout to the beginning of the upload-to-r2 job, artifacts
are downloaded after the repository is cloned, preserving all build
files for proper R2 upload.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-10-22 20:39:34 +02:00

build-multiplatform.yml

fix: Move checkout step before artifact downloads in R2 upload job

2025-10-22 20:39:34 +02:00

README.md

Refactor SAR marker handling and add template management

2025-10-21 23:44:49 +02:00

README.md

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

Ensure your local version is 1.0.0:

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

Commit all changes:

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

Create and push a version tag:
```
git tag v1.2.3
git push origin v1.2.3
```
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
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:

IOS_P12_BASE64: Base64-encoded .p12 certificate
```
base64 -i Certificate.p12 | pbcopy
```
IOS_P12_PASSWORD: Password for the .p12 certificate
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