Fvm Flutter Release

FVM Flutter Release

Overview

Pin Flutter SDK per-project with fvm, then build and upload to both App Store and Google Play using fvm-aware scripts.

FVM Setup Workflow

1. Find Latest Compatible Version

# Check project SDK constraint
grep 'sdk:' pubspec.yaml
# e.g. sdk: ^3.10.7 → needs Dart >= 3.10.7

# List locally cached versions with Dart info
fvm list

Match rule: pick the highest version number whose Dart SDK satisfies pubspec constraint.

2. Pin Version

echo "y" | fvm use 
# Creates .fvmrc, adds .fvm/ to .gitignore

3. Update Project Commands

All flutter/dart commands become fvm flutter/fvm dart:

fvm flutter run
fvm flutter test
fvm flutter gen-l10n
fvm flutter build ipa --release
fvm flutter build appbundle --release
fvm dart run flutter_launcher_icons

Update CLAUDE.md to reflect fvm prefix — search-replace all flutter commands.

4. Verify

fvm flutter doctor
fvm flutter test

Dual-Platform Release

Quick Start

# Copy scripts to project
cp -r ~/.claude/skills/fvm-flutter-release/scripts/ ./scripts/
chmod +x scripts/*.sh

# iOS
export TEAM_ID=xxx CERT_HASH=xxx API_KEY=xxx API_ISSUER=xxx
export PROVISIONING_PROFILE="$HOME/Library/MobileDevice/Provisioning Profiles/xxx.mobileprovision"
./scripts/fvm_ios_upload.sh

# Android
./scripts/fvm_android_upload.sh [track]
# track: internal | alpha | beta | production (default: production)

# Both
./scripts/fvm_release_all.sh

Environment Variables

| Variable | Platform | Description | |----------|----------|-------------| | TEAM_ID | iOS | Apple Developer Team ID | | CERT_HASH | iOS | Distribution cert hash (security find-identity -p codesigning) | | PROVISIONING_PROFILE | iOS | Path to .mobileprovision file | | API_KEY | iOS | App Store Connect API Key ID | | API_ISSUER | iOS | App Store Connect Issuer ID | | DART_DEFINES | Both | Extra --dart-define flags (space-separated KEY=VALUE pairs) |

Android requires android/key.properties + android/fastlane/ setup with service account JSON.

Advanced Deployment

For Xcode 26.x exportArchive bug workaround, macOS, or Firebase web deploy, see skill flutter-deploy.

Common Mistakes

| Mistake | Fix | |---------|-----| | Using flutter instead of fvm flutter | Check .fvmrc exists → always prefix with fvm | | Picking fvm version by Flutter number | Match by Dart SDK version against pubspec sdk: constraint | | Forgetting --dart-define for release | Pass API keys via env vars, never hardcode | | Uploading APK to Play Store | Always use appbundle (AAB) |

Related skills

• release-preflight → flutter-verify → release-app → mobile-store-upload-cli — use fvm-flutter-release during the preflight and verify stages to build release artifacts with specific Flutter versions.
• flutter-pub-get-stuck — if flutter pub get hangs when using FVM, use this skill to diagnose the issue.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ImL1s
• Source: ImL1s/flutter-claude-skills
• License: MIT

Install and usage instructions live in the source repository linked above.