Flutter-action 项目中的 Android SDK 依赖优化实践

在 Flutter 项目持续集成过程中，Android SDK 相关依赖的下载和配置往往是构建时间过长的罪魁祸首。本文将通过实际案例，深入分析如何优化这一环节，显著提升 CI/CD 流水线的执行效率。

问题现象分析

在 MacOS 环境的 GitHub Actions 中执行 Flutter APK 构建时，发现 assembleRelease 任务耗时高达 230 秒，远高于本地开发的 20 秒。通过日志分析，主要瓶颈在于：

1. Android NDK、Build Tools 和 CMake 等依赖项的重复下载
2. Gradle 依赖未有效缓存
3. 项目配置强制使用旧版本工具链

核心优化方案

1. 基础环境配置优化

首先推荐使用 Ubuntu 作为构建环境而非 MacOS，因为 GitHub 提供的 Ubuntu 镜像已预装较新版本的 Android 工具链。基础配置示例如下：

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - uses: actions/setup-java@v4
        with:
          distribution: "temurin"
          java-version: "21"
          cache: "gradle"
          cache-dependency-path: |
            android/gradle/wrapper/gradle-wrapper.properties
            android/build.gradle.kts
            android/app/build.gradle.kts

2. Gradle 依赖缓存

利用 setup-java 动作的缓存功能，可以显著减少重复下载依赖的时间。关键配置包括：

• 指定缓存类型为 gradle
• 正确配置缓存依赖路径
• 注意不同 Flutter 版本生成的构建文件可能是 .gradle 或 .gradle.kts 后缀

3. Android 工具链管理

对于必须使用 MacOS 或需要特定版本工具链的场景，可采用以下优化手段：

# 强制使用镜像中预装的最新 NDK 版本
if [[ -n "$ANDROID_NDK_LATEST_HOME" ]]; then
  ndkVersion=$(basename "$ANDROID_NDK_LATEST_HOME")
  find . -type f -name "*.gradle*" -exec sed -i '' 's/flutter\.ndkVersion/"'"$ndkVersion"'"/g' {} +
fi

4. 智能缓存策略

实现精细化的 Android 工具缓存机制：

- name: Cache Android tools
  uses: actions/cache@v4
  with:
    key: android-${{ runner.os }}-${{ runner.arch }}-$hash
    path: |
      $ANDROID_HOME/cmake/*
      $ANDROID_HOME/ndk/*
      $ANDROID_HOME/platforms/*
      !$ANDROID_HOME/cmake/旧版本目录
      !$ANDROID_HOME/ndk/旧版本目录

项目配置最佳实践

1. 保持 Flutter 项目更新：定期执行 flutter upgrade 确保使用最新工具链
2. 检查构建文件：确认 android/app/build.gradle 中未硬编码旧版本工具
3. 日志分析：构建时添加 --verbose 参数识别耗时环节
4. 依赖对齐：确保项目要求的 NDK、CMake 版本与 CI 环境预装版本一致

效果评估

通过上述优化措施，典型改进效果包括：

• 构建时间从 364.8 秒降至 281.9 秒（MacOS 环境）
• Ubuntu 环境下构建时间可进一步缩短至 200 秒以内
• 缓存命中后二次构建时间可减少 30-50%

这些优化不仅适用于 GitHub Actions，其原理同样可以应用于其他 CI/CD 平台，帮助开发团队显著提升交付效率。