跨平台开发 / 系统课时

在流水线注入环境变量

在流水线注入环境变量

本篇解决 CI/CD 中敏感参数和环境差异配置管理的问题。通过流水线环境变量和 Secret 注入机制,可以让签名参数、服务地址和构建选项与代码仓库分离。

学习目标

  • 理解 Flutter CI 中环境变量和 Secret 的职责区别
  • 学会在流水线中安全注入构建参数
  • 掌握验证环境变量是否正确传递的方法

为什么需要环境变量注入

移动应用通常存在多个环境,例如测试环境、预发布环境和生产环境。不同环境可能使用不同接口地址、密钥配置或构建参数。

如果直接把这些值写入代码,会导致敏感信息泄露,也会增加环境切换成本。CI 流水线更适合负责在构建阶段注入这些动态值。

常见需要注入的内容包括:

类型 示例 是否敏感
服务配置 API 地址 通常不是
构建参数 环境名称 通常不是
签名信息 密钥密码 是

使用 CI Secret 传递参数

以 GitHub Actions 为例,可以将敏感值保存到仓库 Secret,然后在构建步骤中读取。

yaml
name: flutter-build

on:
  workflow_dispatch:

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: subosito/flutter-action@v2
        with:
          flutter-version: '<FLUTTER_VERSION>'

      - name: Build apk
        env:
          API_BASE_URL: ${{ secrets.API_BASE_URL }}
          BUILD_ENV: production
        run: |
          flutter build apk --dart-define=API_BASE_URL=$API_BASE_URL --dart-define=BUILD_ENV=$BUILD_ENV

预期结果

text
Running flutter build apk with injected dart-define values.
APK build completes successfully when signing configuration is valid.

这里使用 --dart-define 将构建参数传入 Flutter 应用。代码中不保存真实环境值,只在 CI 执行期间临时注入。

在 Flutter 中读取构建参数

Flutter 应用可以通过 String.fromEnvironment 获取编译期变量。

dart
const apiBaseUrl = String.fromEnvironment(
  'API_BASE_URL',
  defaultValue: 'https://example.invalid',
);

void main() {
  print(apiBaseUrl);
}

预期结果

text
https://api.example.com

实际构建时,如果没有传入对应参数,会使用默认值。因此生产环境通常应检查关键变量是否存在,避免生成错误配置的安装包。

环境变量管理注意事项

CI 环境变量需要明确区分公开配置和敏感信息:

  • API 地址、版本号等可考虑普通变量管理。
  • 签名文件密码、令牌等必须使用 Secret。
  • 日志中不要主动输出敏感变量内容。
  • 不同环境使用不同 Secret 集合。

当流水线出现配置不生效的问题,应先检查变量是否注入成功,再检查 Flutter 构建参数是否正确传递。通过让代码、配置和 Secret 分离,可以让同一套 CI 流程稳定支持多个发布环境。

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

目录与阅读设置

阅读设置

17

记录一个想法

在流水线注入环境变量

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

登录哪都通