bitboxonline/docker-flutter-android

DockerFlutterAndroid 镜像文档

镜像概述

DockerFlutterAndroid是一个基于Ubuntu的Docker容器，预安装了Flutter和Android SDK，专为CI/CD系统设计。该镜像还集成了Fastlane和Firebase CLI工具，提供移动应用开发全流程的自动化支持，包括构建、测试、打包和部署。

核心功能和特性

• 基础环境：基于Ubuntu系统，提供稳定的运行环境
• Flutter环境：已配置Flutter开发环境，路径为/flutter
• Android SDK：包含完整Android SDK，路径为/android-sdk
• CI/CD工具：集成Fastlane（自动化构建和发布工具）和Firebase CLI（Firebase服务管理工具）
• 开箱即用：无需手动配置开发环境，可直接用于移动应用开发流程

使用场景

• 移动应用的CI/CD流水线：自动化构建、测试和发布Flutter Android应用
• 多环境一致性开发：确保开发、测试和生产环境的工具版本统一
• 快速原型开发：无需本地配置复杂开发环境，直接使用容器进行开发和调试
• 持续集成测试：与Jenkins、GitHub Actions等CI/CD平台集成，执行自动化测试

使用方法和配置说明

基本使用

交互式运行

bash
docker run -it --rm dockerflutterandroid /bin/bash

进入容器后，可直接使用Flutter和Android SDK命令：

bash
# 查看Flutter版本
/flutter/bin/flutter --version

# 查看Android SDK版本
/android-sdk/tools/bin/sdkmanager --list

构建Flutter应用

挂载本地项目目录并执行构建命令：

bash
docker run -v $(pwd):/app -w /app dockerflutterandroid /flutter/bin/flutter build appbundle

CI/CD集成示例

GitHub Actions配置示例

在.github/workflows/build.yml中使用该镜像：

yaml
name: Flutter Build
on: [push]
jobs:
  build:
    runs-on: ubuntu-latest
    container:
      image: dockerflutterandroid
    steps:
      - uses: actions/checkout@v3
      - name: Build Flutter app
        run: /flutter/bin/flutter build appbundle
      - name: Deploy with Fastlane
        run: fastlane deploy

路径说明

• Flutter安装路径：/flutter
• Android SDK路径：/android-sdk

工具使用

Fastlane

容器中已预安装Fastlane，可直接在项目目录中执行Fastlane命令：

bash
docker run -v $(pwd):/app -w /app dockerflutterandroid fastlane [lane_name]

Firebase CLI

使用Firebase CLI管理Firebase服务：

bash
docker run -v $(pwd):/app -w /app dockerflutterandroid firebase deploy