跨平台开发 / 系统课时
生成 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.aabApp Bundle 不直接安装到手机,而是由应用商店根据设备情况生成对应 APK。
检查发布构建配置
正式构建前,需要确认 Android 工程配置完整,包括应用签名、版本号和包名。
常见检查项:
android/app/build.gradle中的版本配置是否正确。- 是否配置 release 签名。
- 应用图标、名称和权限是否符合发布要求。
如果没有配置签名,某些发布流程会失败或生成无法上传的构建文件。
处理常见构建失败
构建失败时,可以按照以下顺序检查:
- 执行
flutter doctor检查 Flutter、Android SDK 和开发环境。 - 确认依赖可以正常解析。
- 清理旧构建缓存后重新生成。
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发布构建的目标不是简单生成文件,而是得到经过优化、签名正确并可以交付用户的应用产物。
按自己的节奏,确认真正理解。