fastlane-knowledge

Fastlane for Flutter

Configure and use Fastlane for automated Flutter app deployment.

Directory Structure

project/
├── ios/
│   └── fastlane/
│       ├── Fastfile          # iOS lanes
│       ├── Appfile           # App identifier config
│       ├── Matchfile         # Code signing config
│       └── metadata/         # App Store metadata
├── android/
│   └── fastlane/
│       ├── Fastfile          # Android lanes
│       ├── Appfile           # Package name config
│       └── metadata/         # Play Store metadata
└── Gemfile                   # Ruby dependencies

Setup Commands

# Install Fastlane
gem install fastlane

# Initialize for iOS
cd ios && fastlane init

# Initialize for Android
cd android && fastlane init

# Initialize match (iOS code signing)
cd ios && fastlane match init

iOS Fastfile Template

default_platform(:ios)

platform :ios do
  before_all do
    setup_ci if ENV['CI']
  end

  desc "Build and upload to TestFlight"
  lane :beta do
    match(type: "appstore", readonly: true)

    build_app(
      workspace: "Runner.xcworkspace",
      scheme: "Runner",
      export_method: "app-store",
      output_directory: "./build"
    )

    upload_to_testflight(
      skip_waiting_for_build_processing: true
    )
  end

  desc "Deploy to App Store"
  lane :release do
    match(type: "appstore", readonly: true)

    build_app(
      workspace: "Runner.xcworkspace",
      scheme: "Runner",
      export_method: "app-store"
    )

    upload_to_app_store(
      submit_for_review: true,
      automatic_release: false,
      force: true
    )
  end
end

Android Fastfile Template

default_platform(:android)

platform :android do
  desc "Deploy to internal testing"
  lane :internal do
    upload_to_play_store(
      track: "internal",
      aab: "../build/app/outputs/bundle/release/app-release.aab",
      json_key_data: ENV["PLAY_STORE_JSON_KEY"]
    )
  end

  desc "Promote to beta"
  lane :beta do
    upload_to_play_store(
      track: "beta",
      track_promote_to: "beta"
    )
  end

  desc "Deploy to production"
  lane :release do
    upload_to_play_store(
      track: "production",
      aab: "../build/app/outputs/bundle/release/app-release.aab",
      json_key_data: ENV["PLAY_STORE_JSON_KEY"]
    )
  end
end