Skip to main content

App Bundle

This command builds your Flutter application as an Android App Bundle (AAB) file, which is the required format for publishing to the Google Play Store.

morpheme build appbundle

Description​

The appbundle command compiles your Flutter app into an Android App Bundle (.aab) file. By default, it builds a release version with the dev flavor.

After building, the AAB file will be located in:

  • build/app/outputs/bundle/
  • build/app/outputs/flutter-appbundle/
info

AAB vs APK: Android App Bundles are optimized for Play Store distribution. Google Play uses the AAB to generate and serve optimized APKs for each device configuration, reducing download sizes.

Usage​

Basic Build (Dev, Release)​

morpheme build appbundle

Build for Play Store (Production)​

morpheme build appbundle --flavor prod --release --obfuscate

Build with Custom Version​

morpheme build appbundle --build-number 42 --build-name "1.2.0"

Debug Build​

morpheme build appbundle --flavor dev --debug

Options​

morpheme build appbundle [options]

To see all available options and flags, run morpheme build appbundle --help.

Available Options​

OptionAbbrDescription
--flavor [env]-fBuild flavor (dev, stag, prod). Default: dev.
--debugBuild in debug mode.
--profileBuild in profile mode.
--releaseBuild in release mode (default).
--target [path]-tMain Dart entry file. Default: lib/main.dart.
--build-number [number]Override the build number (e.g., 42).
--build-name [version]Override the build name/version (e.g., 1.2.0).
--[no-]obfuscateEnable code obfuscation (requires --split-debug-info). Default: true in release.
--split-debug-info [dir]Store debug symbols separately. Default: ./.symbols/.
--[no-]l10nGenerate localization files before building. Default: true.
--morpheme-yaml [path]Path to a custom configuration file.
tip

For Play Store submissions, always use --flavor prod --release --obfuscate to ensure optimal performance and security.