FlutterCI/CD实践_GitLabRunner自动化部署

最近在尝试用GitLab Runner做Flutter项目的CI/CD自动化部署，但在配置过程中遇到几个问题想请教大家：

  1. 环境配置：在GitLab Runner中安装Flutter SDK时，是否需要额外配置环境变量？还是直接使用官方镜像就可以？

  2. 构建问题：Android和iOS的构建步骤差异较大，如何在同一个.gitlab-ci.yml文件中高效处理不同平台的构建？有没有通用脚本可以参考？

  3. 依赖缓存：每次构建都会重新下载依赖，导致时间较长。有没有办法缓存Flutter的第三方库和插件，比如pub cache？

  4. iOS代码签名：自动化部署iOS应用时，如何安全地处理证书和描述文件？是否必须用MacOS Runner？

  5. 部署阶段：成功构建后，如何自动发布到Firebase App Distribution或TestFlight？需要哪些关键配置？

希望有经验的大佬能分享一下最佳实践或避坑指南，谢谢！


更多关于FlutterCI/CD实践_GitLabRunner自动化部署的实战教程也可以访问 https://www.itying.com/category-92-b0.html

3 回复

作为屌丝程序员，要实现Flutter项目的CI/CD，首先在GitLab上配置GitLab Runner，选择shell执行器。在项目根目录创建.gitlab-ci.yml文件，定义流水线阶段。例如：

stages:
  - build
  - test
  - deploy

build:
  stage: build
  script:
    - flutter build apk

test:
  stage: test
  script:
    - flutter test

deploy:
  stage: deploy
  script:
    - scp build/app/outputs/flutter-apk/app-release.apk user@server:/path/

需确保GitLab Runner服务器已安装必要的依赖如Flutter和Dart。通过环境变量存储敏感信息如服务器IP、用户名密码等。每次提交代码时自动触发构建、测试和部署流程。为节省资源，可将Runner注册为服务模式，并定期清理旧APK。整个过程无需高配设备，屌丝也能高效完成自动化部署！

更多关于FlutterCI/CD实践_GitLabRunner自动化部署的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


在Flutter项目中实现GitLab Runner的CI/CD自动化部署，首先需要在GitLab中配置.gitlab-ci.yml文件。该文件定义了流水线的各个阶段。

  1. 安装GitLab Runner：在服务器上安装并注册GitLab Runner，确保其能与GitLab项目关联。
  2. 配置.gitlab-ci.yml：例如：
stages:
  - build
  - test
  - deploy

build:
  stage: build
  script:
    - flutter build apk

test:
  stage: test
  script:
    - flutter test

deploy:
  stage: deploy
  script:
    - scp build/app/outputs/flutter-apk/app-release.apk user@server:/path/to/deploy/
  1. 设置环境变量：在GitLab项目的设置里添加部署所需的敏感信息（如服务器IP、SSH密钥等）。
  2. 测试流水线：提交后触发CI/CD流程，检查各阶段是否正常运行。
  3. 增强安全性：使用.gitlab-ci-secret-variables存储敏感数据，并通过SSH免密码登录优化部署脚本。

这样即可实现从代码构建到自动部署的完整流程。

Flutter CI/CD 实践 - GitLab Runner 自动化部署

基本配置步骤

  1. 安装并注册 GitLab Runner
# 安装 GitLab Runner
sudo apt-get install gitlab-runner

# 注册 Runner
sudo gitlab-runner register
  1. 创建 .gitlab-ci.yml 文件

这是一个基本的 Flutter CI/CD 配置示例：

stages:
  - test
  - build
  - deploy

variables:
  FLUTTER_VERSION: "stable"

before_script:
  - git clone https://github.com/flutter/flutter.git -b $FLUTTER_VERSION
  - export PATH="$PATH:`pwd`/flutter/bin"

test:
  stage: test
  script:
    - flutter doctor
    - flutter pub get
    - flutter test

build_android:
  stage: build
  script:
    - flutter build apk --release
  artifacts:
    paths:
      - build/app/outputs/flutter-apk/*.apk
  only:
    - master

build_ios:
  stage: build
  script:
    - flutter build ios --release --no-codesign
  artifacts:
    paths:
      - build/ios/iphoneos/Runner.app
  only:
    - master

deploy:
  stage: deploy
  script:
    - echo "Deploying to your chosen platform..."
    # 这里添加你的部署脚本
  only:
    - master

进阶优化建议

  1. 依赖缓存：添加缓存配置加速构建
cache:
  key: flutter
  paths:
    - .pub-cache/
    - flutter/
  1. 矩阵构建：针对不同平台/架构
build_apk:
  script:
    - flutter build apk --release --target-platform android-arm,android-arm64
  1. 代码静态分析：在测试阶段添加
analyze:
  stage: test
  script:
    - flutter analyze
  1. 环境变量管理：使用 GitLab CI/CD 变量存储敏感信息

常见问题解决

  • Runner 权限问题：确保 Runner 有足够的权限执行构建命令
  • Flutter 版本冲突：明确指定 Flutter 版本
  • iOS 签名问题：需要配置正确的证书和配置文件

注意：根据你的具体项目需求调整配置，特别是部署阶段需要根据你的目标平台(如Firebase、App Store等)进行定制。

回到顶部