跨平台开发 / 系统课时

生成 Android 发布构建

生成 Android 发布构建

本篇介绍 Flutter 应用从开发调试状态进入 Android 发布阶段的过程,理解 debug 与 release 构建差异,并通过命令生成可安装 APK 或用于应用商店发布的 App Bundle 文件。

学习目标

  • 理解 Flutter Android 构建模式的区别。
  • 使用 Flutter 命令生成发布产物。
  • 掌握构建结果验证与常见问题处理方法。

区分 debug、profile 和 release 构建

Flutter 提供不同构建模式满足开发和发布需求。

构建模式 主要用途 特点
debug 日常开发调试 保留调试能力,方便热重载
profile 性能分析 接近发布环境,可分析性能
release 正式发布 优化代码,关闭调试功能

发布应用时通常使用 release 模式,因为它会进行优化,并生成面向最终用户的安装包。

生成 Android APK

如果需要直接安装到设备进行测试,可以生成 APK。

bash
flutter build apk --release

预期输出

text
Running Gradle task 'assembleRelease'...
Built build/app/outputs/flutter-apk/app-release.apk

生成完成后,APK 通常位于 build/app/outputs/flutter-apk/ 目录。实际路径可能因 Flutter 版本和项目配置不同而变化。

生成 Android App Bundle

如果目标是发布到 Google Play,通常使用 App Bundle 格式。

bash
flutter build appbundle --release

预期输出

text
Running Gradle task 'bundleRelease'...
Built build/app/outputs/bundle/release/app-release.aab

App Bundle 不直接安装到手机,而是由应用商店根据设备情况生成对应 APK。

检查发布构建配置

正式构建前,需要确认 Android 工程配置完整,包括应用签名、版本号和包名。

常见检查项:

  • android/app/build.gradle 中的版本配置是否正确。
  • 是否配置 release 签名。
  • 应用图标、名称和权限是否符合发布要求。

如果没有配置签名,某些发布流程会失败或生成无法上传的构建文件。

处理常见构建失败

构建失败时,可以按照以下顺序检查:

  1. 执行 flutter doctor 检查 Flutter、Android SDK 和开发环境。
  2. 确认依赖可以正常解析。
  3. 清理旧构建缓存后重新生成。
bash
flutter clean
flutter pub get
flutter build apk --release

预期输出

text
Running "flutter pub get"...
Running Gradle task 'assembleRelease'...
Built build/app/outputs/flutter-apk/app-release.apk

发布构建的目标不是简单生成文件,而是得到经过优化、签名正确并可以交付用户的应用产物。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

生成 Android 发布构建

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通