Flutter Build macOS

Composite action to build, sign (Developer ID & Sparkle), package (.dmg or .zip), notarize, and generate auto-updater metadata for macOS Flutter desktop applications.

Inputs

Name	Description	Required	Default
`working_directory`	Path to the Flutter app package directory.	No	`.`
`app_name`	Display name of the `.app` bundle (auto-detected if empty).	No	`''`
`build_args`	Extra arguments passed to `flutter build macos`.	No	`''`
`disable_spm`	Disable Flutter Swift Package Manager before building.	No	`true`
`run_pod_install`	Run `pod install` inside `working_directory/macos` before building.	No	`false`
`package_type`	Packaging format to produce: `dmg`, `zip`, or `both`.	No	`dmg`
`dmg_filename`	Output DMG filename.	No	`''`
`zip_filename`	Output ZIP path/filename when `package_type` is `zip` or `both`.	No	`''`
`entitlements_path`	Path to entitlements plist relative to `working_directory`.	No	`macos/Runner/Release.entitlements`
`signing_identity`	Fallback Developer ID Application signing identity.	No	`''`
`certificate_base64`	Base64-encoded Apple `.p12` certificate.	No	`''`
`certificate_password`	Password for the Apple `.p12` certificate.	No	`''`
`certificate_file`	Fallback path to local `.p12` certificate file in repository.	No	`signing/macos/certificate.p12`
`metadata_txt_file`	Fallback path to `metadata.txt` containing p12/notarization credentials.	No	`signing/macos/metadata.txt`
`provisioning_profile_base64`	Optional Base64-encoded `.provisionprofile`.	No	`''`
`notarize_apple_id`	Apple ID email for DMG notarization.	No	`''`
`notarize_password`	Apple ID App-Specific Password for DMG notarization.	No	`''`
`notarize_team_id`	Apple Developer 10-character Team ID for DMG notarization.	No	`''`
`sparkle_private_key`	Sparkle EdDSA private key content for signing DMG updates.	No	`''`
`sparkle_key_file`	Fallback path to Sparkle EdDSA private key file.	No	`signing/sparkle/sparkle_key.pem`
`generate_metadata_json`	Whether to generate `macos_metadata.json` and `macos_signature.txt`.	No	`false`
`asc_key_id`	Optional App Store Connect API Key ID for `.pkg` upload.	No	`''`
`asc_issuer_id`	Optional App Store Connect API Issuer ID for `.pkg` upload.	No	`''`
`asc_private_key`	Optional App Store Connect API Private Key (`.p8`) for `.pkg` upload.	No	`''`

Outputs

Name	Description
`version`	Resolved package version from `pubspec.yaml`.
`dmg_path`	Path to generated DMG installer.
`zip_path`	Path to generated ZIP archive.
`signature`	Sparkle EdDSA signature if generated.
`metadata_path`	Path to generated `macos_metadata.json`.

Example Usage

- name: Build & Package macOS Release
  uses: rodydavis/shared-actions/flutter-build-macos@main
  with:
    working_directory: packages/sfw_desktop
    app_name: Slides for Worship
    package_type: dmg
    dmg_filename: slides-for-worship-macos-universal.dmg
    run_pod_install: 'true'
    build_args: --dart-define=API_BASE_URL=https://slidesforworship.app
    certificate_base64: ${{ secrets.MACOS_CERTIFICATE }}
    certificate_password: ${{ secrets.MACOS_CERTIFICATE_PWD }}
    notarize_apple_id: ${{ secrets.AC_USERNAME }}
    notarize_password: ${{ secrets.AC_PASSWORD }}
    notarize_team_id: ${{ secrets.AC_TEAM_ID }}
    sparkle_private_key: ${{ secrets.SPARKLE_PRIVATE_KEY }}
    generate_metadata_json: 'true'