Flutter Firebase 如何为iOS、Android、Web配置多环境独立部署目标
Flutter多环境多Firebase对接标准化配置方案
基础框架搭建
- 项目内统一抽离环境配置抽象类,固定
envName、apiBaseUrl、firebaseProjectId等通用字段,分别为dev、staging、prod三个场景实现独立配置类,从源头避免不同环境的配置项缺失 - 拆分独立入口文件:在项目
lib/目录下分别创建main_dev.dart、main_staging.dart、main_prod.dart作为不同环境的启动入口,每个入口仅负责加载对应环境的配置对象,再传入公共的App根组件逻辑,杜绝在公共入口里写环境判断逻辑的坏实践 - 入口文件示例代码:
// main_dev.dart 示例 import 'app.dart'; import 'config/env_dev.dart'; void main() { runApp(const App(envConfig: DevEnvConfig())); }
多独立Firebase实例的分平台对接
注意:不要在同一个Firebase项目内靠字段隔离开发、预发布、生产环境,必须使用完全独立的项目实例,从权限层面避免开发调试操作误删生产库数据
核心原则:不要在工程全局目录存放单一Firebase配置,避免不同环境加载错实例。
- Android端适配
- 为三个环境创建独立的资源目录:
android/app/src/dev、android/app/src/staging、android/app/src/prod,把对应环境从Firebase控制台下载的google-services.json分别存入对应目录 - 在
android/app/build.gradle中配置产品风味(productFlavors),每个风味绑定对应的维度、应用ID后缀、应用名称配置,示例配置片段:productFlavors { dev { dimension "env" applicationIdSuffix ".dev" resValue "string", "app_name", "XXApp(开发版)" } staging { dimension "env" applicationIdSuffix ".staging" resValue "string", "app_name", "XXApp(预发布版)" } prod { dimension "env" resValue "string", "app_name", "XXApp" } }
- 为三个环境创建独立的资源目录:
- iOS端适配
- 同样按照dev/staging/prod的维度创建Xcode配置集,把对应环境的
GoogleService-Info.plist分别存入对应配置集的关联目录 - 在Xcode的构建配置中,为每个环境设置独立的Bundle Identifier(dev、staging环境加对应后缀),保证三个版本的App可以同时安装在同一台测试设备上
- 注意:不要把
GoogleService-Info.plist放在全局的Supporting Files目录,这是最常出现Firebase连错实例的配置坑
- 同样按照dev/staging/prod的维度创建Xcode配置集,把对应环境的
- Web端适配
- 把每个环境对应的Firebase Web初始化配置,分别存入
web/env/目录下的独立js文件,不要把配置硬编码在全局index.html里 - 打包时通过构建脚本,根据传入的环境参数,把对应环境的Firebase配置注入到
index.html的初始化位置,避免构建出的Web包连错Firebase项目
- 把每个环境对应的Firebase Web初始化配置,分别存入
三平台差异化部署配置适配
- Android端专属配置
- 为不同环境匹配对应的签名证书:dev、staging环境使用调试签名,prod环境使用正式上线的签名文件,避免上线时签名错配
- 差异化开启构建优化:dev环境关闭代码混淆与资源压缩,方便调试;prod环境开启全量混淆、资源压缩、R8裁剪,优化包体大小
- iOS端专属配置
- 为不同环境匹配对应的APNs推送证书、Universal Link域名、ATS安全规则:dev环境对接开发版APNs服务,prod环境对接生产版APNs
- 匹配对应的打包描述文件,dev环境用开发证书打包,staging、prod环境分别用对应的分发证书打包
- Web端专属配置
- 为不同环境设置差异化的页面标题、favicon、静态资源缓存策略:dev环境关闭资源缓存,避免调试时的缓存干扰;prod环境开启静态资源长期缓存,提升页面加载速度
- 配置对应环境的路由基础路径,比如预发布环境部署在测试服务器时,设置路由前缀为
/staging/,避免和生产环境的路由规则冲突
校验兜底机制
- 构建时通过
--dart-define参数传入当前环境标识,和入口文件的环境配置做双重校验,示例构建命令:# 构建Android开发版APK flutter build apk --flavor dev -t lib/main_dev.dart --dart-define=ENV=dev - App启动时增加配置校验逻辑:将Dart侧传入的环境标识,和原生层加载的Firebase项目ID做匹配校验,如果不一致直接抛出启动异常,从机制上避免串环境导致的生产数据误操作风险
内容的提问来源于stack exchange,提问作者YEG
相关产品推荐
相关产品推荐

