App store release for Flutter apps

What is the App Store release in Flutter?

App Store release in Flutter is the process of building a signed, production-ready binary and publishing it to Google Play Store or Apple App Store. Flutter generates native apps, but store rules, signing, metadata, and privacy requirements are enforced by the platforms, not by Flutter itself.

Flutter versioning: pubspec.yaml is the source of truth (CRITICAL)

In Flutter, versioning must be done in pubspec.yaml, not manually in Xcode.

version: 1.0.2+15

This maps to:

• App Store version (user-facing) → 1.0.2
• Build number (internal) → 15

Rules

• Always update version and build number in pubspec.yaml.
• Run flutter build ios after changing it.
• Do not edit version numbers manually in Xcode (they may be overwritten on next build).

Incorrect version sync is one of the most common App Store rejection causes.

How to publish Flutter app on App Store (iOS)

Requirements

• Apple Developer account
• macOS machine (or Cloud CI/CD like Codemagic)
• correct Bundle ID, certificates, and provisioning profiles

Build

flutter build ipa

Upload options

• Xcode → Product → Archive → Upload
• Transporter app (recommended) for more stable uploads and clearer errors

TestFlight is strongly recommended before public release.

Privacy, permissions, and Info.plist (REJECTION #1 CAUSE)

Apple requires explicit explanations for every permission that your app or any plugin may use.

Examples

• NSCameraUsageDescription
• NSPhotoLibraryUsageDescription
• NSLocationWhenInUseUsageDescription

Important

• Even if you don’t use the camera directly, a plugin like image_picker might.
• Missing keys → automatic rejection

Since 2024+, some APIs also require Privacy Manifests.

Always review plugin documentation and ensure Info.plist is complete.

App icon pitfalls (Alpha channel error)

App Store icons:

• Must not contain transparency
• Must be fully opaque (no alpha channel)

Fix

• Flatten the 1024×1024 icon
• Add a solid background (often white)
• Re-export without transparency

How to publish Flutter app on Play Store (Android)

Steps

• Update version in pubspec.yaml
• Generate App Bundle:

flutter build appbundle

• Upload .aab to Google Play Console.
• Configure store listing and privacy policy.
• Submit for review.

Using AAB is mandatory and enables automatic size optimization.

Flutter update app without Play Store or App Store (Reality check)

You cannot update Flutter/Dart code outside the stores.

Allowed

• Remote Config (texts, colors, feature flags)
• backend-driven content
• server-controlled UI behavior

Not allowed

• shipping new Dart code
• modifying logic without store review
• OTA code updates (forbidden on iOS, restricted on Android)

Debug vs Release builds (Avoid false panic)

Debug builds are huge and slow.

Release builds use:

• AOT compilation
• tree shaking
• symbol stripping

Never judge:

• app size
• performance
• startup time

…based on Debug builds.

Best practices

• Test Release builds on real devices.
• Increment build number on every submission.
• Use TestFlight / internal testing tracks.
• Prefer Transporter for iOS uploads.
• Automate builds via CI/CD.
• Monitor crashes immediately after release (Crashlytics).

Flutter app size vs native apps

Flutter apps:

• Are slightly larger than pure native at baseline.
• Benefit from store-level optimizations.
• Scale well in production.