跨平台开发 / 系统课时

自动生成 Android 构建产物

自动生成 Android 构建产物

本篇介绍如何在 CI/CD 流程中自动生成 Android 构建文件,并在指定分支或标签触发后保存产物。完成后可以让团队通过固定流程获得可追踪、可下载的 APK 或 App Bundle。

学习目标

  • 理解 Android CI 构建任务的触发条件和产物管理方式
  • 掌握使用 GitHub Actions 自动执行 Flutter Android 构建
  • 学会验证构建结果并处理常见构建失败问题

设计 Android 自动构建流程

移动应用发布通常需要经过代码检出、依赖安装、环境准备、构建和产物归档几个阶段。将这些步骤放入 CI 后,开发者不需要依赖本地环境,也能生成一致的 Android 构建结果。

常见触发方式包括主分支合并、release 分支更新或 Git 标签创建。例如,团队可以规定创建 v<版本号> 标签时自动生成发布包。

Android CI 构建流水线流程图

使用 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 构建产物的核心价值不是减少一次命令输入,而是让每次发布都经过相同的验证路径,降低人工环境差异导致的问题。

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

目录与阅读设置

阅读设置

17

记录一个想法

自动生成 Android 构建产物

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

登录哪都通