flet build

Build Flet Python applications into platform-specific executables or installable bundles for desktop (macOS, Linux, Windows), web, Android (APK/AAB), and iOS (IPA).

Usage

flet build [TARGET_PLATFORM] [PYTHON_APP_PATH] [OPTIONS]

Positional Arguments

  • target_platform: The target platform or package type. Possible values: aab, apk, ipa, linux, macos, web, windows. (Required)
  • python_app_path: Path to the Flet Python program directory. Defaults to ..
  • Options

  • --android-adaptive-icon-background: Color for Android adaptive icon backgrounds.
  • --android-features: List of =True|False for AndroidManifest.xml.
  • --android-meta-data: List of = app meta-data entries for AndroidManifest.xml.
  • --android-permissions: List of =True|False for AndroidManifest.xml.
  • --android-signing-key-alias: Android signing key alias. Default: upload.
  • --android-signing-key-password: Android signing key password.
  • --android-signing-key-store: Path to Android .jks keystore file.
  • --android-signing-key-store-password: Android signing store password.
  • --arch: Target CPU architectures (macOS, Android only). Example: --arch arm64 x64.
  • --base-url: Base URL for serving the app (web only).
  • --build-number: Internal build number (integer).
  • --build-version: User-facing version string (e.g., x.y.z).
  • --bundle-id: Application bundle ID (iOS, Android, macOS, Linux).
  • --cleanup-app: Remove unnecessary app files.
  • --cleanup-app-files: Globs to delete extra app files/directories.
  • --cleanup-package-files: Globs to delete extra package files/directories.
  • --cleanup-packages: Remove unnecessary package files.
  • --clear-cache: Remove build cache before building.
  • --company: Company name for app dialogs.
  • --compile-app: Pre-compile app's .py files to .pyc.
  • --compile-packages: Pre-compile site packages' .py files to .pyc.
  • --copyright: Copyright text for app dialogs.
  • --deep-linking-host: Deep linking URL host (iOS, Android).
  • --deep-linking-scheme: Deep linking URL scheme (iOS, Android). Example: myapp.
  • --description: Short application description.
  • --exclude: Files and/or directories to exclude from the package.
  • --flutter-build-args: Additional arguments for flutter build.
  • --help (-h): Show help message.
  • --info-plist: Key-value pairs for Info.plist (macOS, iOS).
  • --ios-export-method: Export method for iOS app bundle. Default: debugging.
  • --ios-provisioning-profile: Provisioning profile name or UUID for iOS signing.
  • --ios-signing-certificate: Signing certificate name or SHA-1 hash for iOS.
  • --ios-team-id: Apple developer team ID (IPA only).
  • --macos-entitlements: Key-value pairs for macOS entitlements.
  • --module-name: Python module name with app entry point.
  • --no-android-splash: Disable Android splash screen.
  • --no-cdn: Disable loading CanvasKit, Pyodide, fonts from CDN.
  • --no-ios-splash: Disable iOS splash screen.
  • --no-rich-output: Disable rich output (prefer plain text).
  • --no-wasm: Disable WASM target for web build (web only).
  • --no-web-splash: Disable web splash screen.
  • --org: Organization name (reverse domain notation).
  • --output (-o): Output directory for the build. Default: /build/.
  • --permissions: Pre-defined cross-platform permissions (camera, location, microphone, photo_library).
  • --product: Display name of the app.
  • --project: Project name for the executable/bundle.
  • --pwa-background-color: Initial background color for PWA (web only).
  • --pwa-theme-color: Default UI theme color for PWA (web only).
  • --route-url-strategy: Base URL path for serving the app (web only). Possible values: hash, path.
  • --show-platform-matrix: Display build platform matrix and exit.
  • --skip-flutter-doctor: Skip flutter doctor on failed builds.
  • --source-packages: List of Python packages to install from source.
  • --splash-color: Background color for splash screens.
  • --splash-dark-color: Background color for dark mode splash screens.
  • --split-per-abi: Split APKs per ABIs (Android only).
  • --template: Directory or Git URL for Flutter bootstrap template.
  • --template-dir: Relative path to a template in a Git repository.
  • --template-ref: Branch, tag, or commit ID for the template repository.
  • --verbose (-v): Enable verbose output. Use -vv for more detail.
  • --web-renderer: Flutter web renderer. Possible values: auto, canvaskit, skwasm.
  • --yes: Answer yes to all prompts.
  • Supported Platforms

  • Desktop: macOS, Linux, Windows
  • Mobile: Android (APK/AAB), iOS (IPA)
  • Web