Flutter Docker镜像

用于Flutter持续集成(CI)的Docker镜像。源码可在GitHub获取。

该镜像包含运行Flutter和构建应用所需的最小工具集，工具版本基于***Flutter仓库。最终目标是使Flutter在运行容器时无需下载任何工具或SDK。

目录

• 特性
• 运行容器
• 标签
• 本地构建
• 路线图
• 常见问题
  • 为什么镜像未发布到AWS ECR公共注册中心？
• 为什么没有latest这样的动态标签？
• 贡献
• 许可证

特性

• 已安装Flutter SDK 3.35.5。
• 默认禁用分析，若运行容器时传递ENABLE_ANALYTICS环境变量则可选择启用。
• 无root权限用户flutter:flutter，具备在GitHub工作流和GitLab CI中运行的权限。
• 缓存的Fastlane gem 2.228.0。
• 包含预下载SDK和工具的最小镜像，可直接运行Android平台的flutter命令。

Android平台预下载的SDK和工具：

• 已接受许可证
• Android SDK平台版本：36
• Android NDK：27.0.***
• Gradle：8.12

运行容器

终端运行

bash
# 从GitHub容器注册中心
docker run --rm -it ghcr.io/gmeligio/flutter-android:3.35.5 bash

GitHub Actions工作流

yaml
jobs:
  build:
    runs-on: ubuntu-22.04
    container:
      image: ghcr.io/gmeligio/flutter-android:3.35.5
    steps:
      - name: 检出代码
        uses: actions/checkout@v2
      - name: 构建APK
        run: flutter build apk

GitLab CI配置

yaml
build:
  image: ghcr.io/gmeligio/flutter-android:3.35.5
  script:
    - flutter build apk

Fastlane使用

bash
# 容器中已提供Ruby bundler
# Fastlane gem已缓存但未安装
# 更多信息参见[***]

# 使用--prefer-local仅在缓存中不存在时才下载gems
bundle install --prefer-local
bundle exec fastlane

标签

Flutter稳定通道的每个新标签都会触发构建。镜像标签由使用的Flutter版本组成：

• Docker镜像：gmeligio/flutter-android:3.35.5
• Flutter版本：3.35.5

本地构建

android.Dockerfile需要以下构建参数：

• flutter_version <string>: 构建时使用的Flutter版本。示例：3.35.5
• android_build_tools_version <string>: 要安装的Android SDK构建工具版本。示例：35.0.0
• android_platform_versions <list>: 要安装的Android SDK平台版本，空格分隔。示例：36

bash
# 构建Android镜像
docker build --target android --build-arg flutter_version=3.35.5 --build-arg fastlane_version=2.228.0 --build-arg android_build_tools_version=35.0.0 --build-arg android_platform_versions="36" -t android-test .

路线图

• 支持更多平台的最小镜像（包含预下载SDK和工具，可直接运行flutter命令）：
  • iOS
  • Linux
  • Windows
  • Web
• Android功能增强：
  • Android模拟器支持

常见问题

为什么镜像未发布到AWS ECR公共注册中心？

AWS ECR公共注册中心的免费套餐仅提供50GB存储空间，超出后开始收费。随着每次推送镜像，存储占用会增加，因此未在该平台发布。

为什么没有latest这样的动态标签？

刻意不设置latest Docker标签。您需要明确指定要使用的镜像版本，原因是latest标签可能导致CI作业在重新运行时使用新版本镜像，从而产生意外行为。相关解释可参考文章What's Wrong With The Docker :latest Tag?和The misunderstood Docker tag: latest。

贡献

参见贡献指南。

许可证

Flutter采用BSD 3-Clause "New" or "Revised"许可证。

与所有Docker镜像一样，本镜像可能包含其他软件，这些软件可能采用不同的许可证（如基础发行版中的Bash等，以及主要软件的任何直接或间接依赖项）。

对于任何预构建镜像的使用，镜像用户有责任确保其使用符合镜像中所有软件的相关许可证要求。

生成gmeligio/flutter-android Docker镜像的源码采用MIT许可证。