跨平台开发 / 系统课时
自动生成 Android 构建产物
自动生成 Android 构建产物
本篇介绍如何在 CI/CD 流程中自动生成 Android 构建文件,并在指定分支或标签触发后保存产物。完成后可以让团队通过固定流程获得可追踪、可下载的 APK 或 App Bundle。
学习目标
- 理解 Android CI 构建任务的触发条件和产物管理方式
- 掌握使用 GitHub Actions 自动执行 Flutter Android 构建
- 学会验证构建结果并处理常见构建失败问题
设计 Android 自动构建流程
移动应用发布通常需要经过代码检出、依赖安装、环境准备、构建和产物归档几个阶段。将这些步骤放入 CI 后,开发者不需要依赖本地环境,也能生成一致的 Android 构建结果。
常见触发方式包括主分支合并、release 分支更新或 Git 标签创建。例如,团队可以规定创建 v<版本号> 标签时自动生成发布包。

使用 GitHub Actions 构建 Android 包
下面示例使用 GitHub Actions 在标签触发时构建 Android App Bundle。实际项目需要根据 Flutter 版本和签名配置调整环境变量。
yaml
name: Android Release Build
on:
push:
tags:
- 'v*'
jobs:
build-android:
runs-on: ubuntu-latest
steps:
- name: Checkout source
uses: actions/checkout@v4
- name: Setup Flutter
uses: subosito/flutter-action@v2
with:
flutter-version: '3.24.0'
- name: Install dependencies
run: flutter pub get
- name: Build Android App Bundle
run: flutter build appbundle --release
- name: Upload build artifact
uses: actions/upload-artifact@v4
with:
name: android-release-bundle
path: build/app/outputs/bundle/release/app-release.aab预期结果
text
Workflow triggered by tag v<版本号>
Flutter dependencies installed
Android App Bundle generated
Artifact android-release-bundle uploaded successfully该流程生成的 .aab 文件适合上传到 Google Play 等应用分发渠道。如果团队发布的是内部测试包,也可以将构建命令替换为 flutter build apk --release。
管理签名和构建产物
正式 Android 包通常需要签名。签名文件和密码不应该直接提交到代码仓库,而应该通过 CI 平台的 Secrets 注入构建环境。
产物保存时需要关注两个问题:一是文件路径是否稳定,二是构建记录是否能关联到源码版本。通常会把 Git 标签、提交哈希和 CI 运行编号作为发布追踪信息。
验证自动构建结果
完成构建后,需要检查以下内容:
- CI 任务是否只在预期分支或标签执行
- 生成文件是否存在且大小合理
- 构建产物是否来自正确提交
- 测试设备安装或上传流程是否正常
自动生成 Android 构建产物的核心价值不是减少一次命令输入,而是让每次发布都经过相同的验证路径,降低人工环境差异导致的问题。
按自己的节奏,确认真正理解。