Introduction

This Flutter package provides a one-step CI/CD solution for Flutter apps. For a project without any Fastlane setup, it automatically configures all necessary Fastlane settings, builds your Android and iOS apps, and deploys them to Google Play and the App Store with zero manual setup. Developers only need to provide six essential configuration values for iOS deployment in GitHub Secrets.

[!TIP] If you are new to Fastlane or CI/CD, use GitHub Wiki - Basic-Settings to learn the basic concepts and usage, and follow along to apply them to your project.

Tested And Supported Runners

🟢 Stable 🟡 Testing...

Useage

Before using this action, the GitHub Actions runner must have the following setup: - A Flutter SDK compatible with your app is installed and configured

subosito/flutter-action - Java is installed for Android builds

actions/setup-java - Android SDK is installed and properly configured

android-actions/setup-android - SSH keys are configured to access your Fastlane match repository

webfactory/ssh-agent

Example

If you want to see an example or reference a template, check the templates/basic_deploy.yml or templates/advanced_depoy.yml files.

- name: Deploy Android and iOS
  uses: MTtankkeo/flutter-fastlane-action@v1.4
  with:
    version-name: ${{ github.event.inputs.VERSION_NAME }}
    build-number: ${{ github.event.inputs.BUILD_NUMBER }}
    release-note: ${{ github.event.inputs.RELEASE_NOTE }}
    match-repository: {...}
    match-password: ${{ secrets.MATCH_PASSWORD }}
    appstore-connect-issuer-id: ${{ secrets.APP_STORE_CONNECT_ISSUER_ID }}
    appstore-connect-key-id: ${{ secrets.APP_STORE_CONNECT_KEY_ID }}
    appstore-connect-key: ${{ secrets.APP_STORE_CONNECT_KEY }}
    appstore-team-id: ${{ secrets.APP_STORE_TEAM_ID }}

How to set additional Flutter build options?

Sometimes you may need to provide extra build options to Flutter, like choosing a flavor or specifying a different main entrypoint.

You can do this easily with the build-extra input, which passes any additional arguments directly to the Flutter build command.

# Build a production flavor with a custom entrypoint.
build-extra: --flavor prod --target "lib/main_prod.dart"

How to build only one platform?

You can control which platforms to build using the platform input:

# Build only Android
platform: android

# Build only iOS
platform: ios

# Build both platforms
platform: all

GitHub Actions Inputs

These are the input parameters for the GitHub Actions workflow.

🔹Required