跳到主要内容

build

此命令用于为分发打包 Flet 应用程序。你可以在这里找到它的指南。

用法:flet build [-h] [-v] [--arch TARGET_ARCH [TARGET_ARCH...]] [--exclude EXCLUDE [EXCLUDE...]] [-o OUTPUT_DIR] [--clear-cache] [--project PROJECT_NAME] [--description DESCRIPTION] [--product PRODUCT_NAME] [--org ORG_NAME] [--bundle-id BUNDLE_ID] [--company COMPANY_NAME] [--copyright COPYRIGHT] [--android-adaptive-icon-background ANDROID_ADAPTIVE_ICON_BACKGROUND] [--splash-color SPLASH_COLOR] [--splash-dark-color SPLASH_DARK_COLOR] [--no-web-splash] [--no-ios-splash] [--no-android-splash] [--ios-team-id IOS_TEAM_ID] [--ios-export-method IOS_EXPORT_METHOD] [--ios-provisioning-profile IOS_PROVISIONING_PROFILE] [--ios-signing-certificate IOS_SIGNING_CERTIFICATE] [--base-url BASE_URL] [--web-renderer {canvaskit,html}] [--use-color-emoji] [--route-url-strategy {path,hash}] [--pwa-background-color PWA_BACKGROUND_COLOR] [--pwa-theme-color PWA_THEME_COLOR] [--split-per-abi] [--compile-app] [--compile-packages] [--cleanup-app] [--cleanup-app-files [CLEANUP_APP_FILES...]] [--cleanup-packages] [--cleanup-package-files [CLEANUP_PACKAGE_FILES...]] [--flutter-build-args [FLUTTER_BUILD_ARGS...]] [--source-packages SOURCE_PACKAGES [SOURCE_PACKAGES...]] [--info-plist INFO_PLIST [INFO_PLIST...]] [--macos-entitlements MACOS_ENTITLEMENTS [MACOS_ENTITLEMENTS...]] [--android-features ANDROID_FEATURES [ANDROID_FEATURES...]] [--android-permissions ANDROID_PERMISSIONS [ANDROID_PERMISSIONS...]] [--android-meta-data ANDROID_META_DATA [ANDROID_META_DATA...]] [--permissions {location,camera,microphone,photo_library} [{location,camera,microphone,photo_library}...]] [--deep-linking-scheme DEEP_LINKING_SCHEME] [--deep-linking-host DEEP_LINKING_HOST] [--android-signing-key-store ANDROID_SIGNING_KEY_STORE] [--android-signing-key-store-password ANDROID_SIGNING_KEY_STORE_PASSWORD] [--android-signing-key-password ANDROID_SIGNING_KEY_PASSWORD] [--android-signing-key-alias ANDROID_SIGNING_KEY_ALIAS] [--build-number BUILD_NUMBER] [--build-version BUILD_VERSION] [--module-name MODULE_NAME] [--template TEMPLATE] [--template-dir TEMPLATE_DIR] [--template-ref TEMPLATE_REF] [--show-platform-matrix] [--no-rich-output] [--skip-flutter-doctor] {macos,linux,windows,web,apk,aab,ipa} [python_app_path]

构建可执行应用程序或安装包。

位置参数:
{macos,linux,windows,web,apk,aab,ipa}
要构建的包类型或目标平台。
python_app_path
包含 Python 程序的目录路径。

选项:
-h, --help
显示此帮助消息并退出。
-v, --verbose
-v 用于详细输出,-vv 用于更详细的输出。
--arch TARGET_ARCH [TARGET_ARCH...]
仅为特定架构打包。仅用于 Android 和 macOS 构建。
--exclude EXCLUDE [EXCLUDE...]
从 Python 应用程序包中排除文件和目录。
-o OUTPUT_DIR, --output OUTPUT_DIR
放置生成的可执行文件或包的位置(默认为<python_app_directory>/build/<target_platform>)。
--clear-cache
清除构建缓存。
--project PROJECT_NAME
可执行文件或包的项目名称。
--description DESCRIPTION
可执行文件或包的描述。
--product PRODUCT_NAME
项目显示名称,显示在窗口标题和关于应用程序对话框中。
--org ORG_NAME
以反向域名表示法表示的组织名称,例如“com.mycompany”——与项目名称结合使用,并用作 iOS 和 Android 捆绑包 ID。
--bundle-id BUNDLE_ID
应用程序的捆绑包 ID,例如“com.mycompany.app-name”——用作 iOS、Android、macOS 和 Linux 捆绑包 ID。
--company COMPANY_NAME
要在关于应用程序对话框中显示的公司名称。
--copyright COPYRIGHT
要在关于应用程序对话框中显示的版权文本。
--android-adaptive-icon-background ANDROID_ADAPTIVE_ICON_BACKGROUND
用于填充自适应图标的背景颜色。
--splash-color SPLASH_COLOR
iOS、Android 和 Web 上应用程序启动屏幕的背景颜色。
--splash-dark-color SPLASH_DARK_COLOR
iOS、Android 和 Web 上应用程序启动屏幕在深色模式下的背景颜色。
--no-web-splash
禁用 Web 应用程序启动屏幕。
--no-ios-splash
禁用 iOS 应用程序启动屏幕。
--no-android-splash
禁用 Android 应用程序启动屏幕。
--ios-team-id IOS_TEAM_ID
用于签署 iOS 捆绑包(仅 ipa)的团队 ID。
--ios-export-method IOS_EXPORT_METHOD
iOS 应用程序的导出方法。默认为“debugging”。
--ios-provisioning-profile IOS_PROVISIONING_PROFILE
用于签署和导出 iOS 应用程序的配置文件名称或 UUID。
--ios-signing-certificate IOS_SIGNING_CERTIFICATE
提供用于签署 iOS 应用程序捆绑包的证书名称、SHA-1 哈希或自动选择器。
--base-url BASE_URL
应用程序的基本 URL(仅 Web)。
--web-renderer {canvaskit,html}
要使用的渲染器(仅 Web)。
--use-color-emoji
在 CanvasKit 渲染器下启用彩色表情符号(仅 Web)。
--route-url-strategy {path,hash}
URL 路由策略(仅 Web)。
--pwa-background-color PWA_BACKGROUND_COLOR
你的 Web 应用程序的初始背景颜色。
--pwa-theme-color PWA_THEME_COLOR
你的 Web 应用程序用户界面的默认颜色。
--split-per-abi
是否按 ABI 分割 APK。
--compile-app
将应用程序的.py 文件编译为.pyc。
--compile-packages
将站点包的.py 文件编译为.pyc。
--cleanup-app
在打包时删除不必要的应用程序文件。
--cleanup-app-files [CLEANUP_APP_FILES...]
要删除的额外应用程序文件和目录的 glob 列表。
--cleanup-packages
在打包时删除不必要的包文件。
--cleanup-package-files [CLEANUP_PACKAGE_FILES...]
要删除的额外包文件和目录的 glob 列表。
--flutter-build-args [FLUTTER_BUILD_ARGS...]
flutter build 命令的附加参数。
--source-packages SOURCE_PACKAGES [SOURCE_PACKAGES...]
要从源分发安装的 Python 包列表。
--info-plist INFO_PLIST [INFO_PLIST...]
要添加到 macOS 和 iOS 构建的 Info.plist 中的“<key>=<value>|True|False”对列表。
--macos-entitlements MACOS_ENTITLEMENTS [MACOS_ENTITLEMENTS...]
要添加到 macOS 构建的权限列表中的“<key>=<value>|True|False”权限列表。
--android-features ANDROID_FEATURES [ANDROID_FEATURES...]
要添加到 AndroidManifest.xml 中的“<feature_name>=True|False”功能列表。
--android-permissions ANDROID_PERMISSIONS [ANDROID_PERMISSIONS...]
要添加到 AndroidManifest.xml 中的“<permission_name>=True|False”权限列表。
--android-meta-data ANDROID_META_DATA [ANDROID_META_DATA...]
要添加到 AndroidManifest.xml 中的“<name>=<value>”应用程序元数据条目列表。
--permissions {location,camera,microphone,photo_library} [{location,camera,microphone,photo_library}...]
iOS、Android 和 macOS 应用程序的跨平台权限列表。
--deep-linking-scheme DEEP_LINKING_SCHEME
要为 iOS 和 Android 构建配置的深度链接 URL 方案,例如“https”或“myapp”。
--deep-linking-host DEEP_LINKING_HOST
iOS 和 Android 构建的深度链接 URL 主机。
--android-signing-key-store ANDROID_SIGNING_KEY_STORE
Android 应用程序的上传密钥库.jks 文件的路径。
--android-signing-key-store-password ANDROID_SIGNING_KEY_STORE_PASSWORD
Android 签名存储密码。
--android-signing-key-password ANDROID_SIGNING_KEY_PASSWORD
Android 签名密钥密码。
--android-signing-key-alias ANDROID_SIGNING_KEY_ALIAS
Android 签名密钥别名。默认为“upload”。
--build-number BUILD_NUMBER
构建编号——用作内部版本号的标识符。
--build-version BUILD_VERSION
构建版本——用作向用户显示的版本号的“x.y.z”字符串。
--module-name MODULE_NAME
带有应用程序入口点的 Python 模块名称。
--template TEMPLATE
包含 Flutter 引导模板的目录,或指向 Git 存储库模板的 URL。
--template-dir TEMPLATE_DIR
存储库中 Flutter 引导模板的相对路径。
--template-ref TEMPLATE_REF
克隆带有 Flutter 引导模板的存储库后要检出的分支、标签或提交 ID。
--show-platform-matrix
在表格中显示构建平台矩阵,然后退出。
--no-rich-output
禁用丰富输出并使用纯文本。
--skip-flutter-doctor
是否在构建失败时跳过运行 Flutter doctor。