跨平台开发 / 系统课时
在流水线注入环境变量
在流水线注入环境变量
本篇解决 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 流程稳定支持多个发布环境。
按自己的节奏,确认真正理解。