如何在iOS的Debug与Prod构建中差异化记录Firebase Analytics

针对生产/预发布环境Analytics数据聚合干扰，同时需要在预发布环境验证埋点的问题，这里提供三个实用解决方案：

方案1：为不同环境配置独立Firebase项目 #

这是最彻底的隔离方式，生产和预发布分别使用两个完全独立的Firebase项目，数据完全不互通，预发布的测试操作不会影响生产数据，同时预发布环境可以正常使用调试日志验证埋点。

实现步骤： #

1. 在Firebase控制台创建两个项目，分别对应生产和预发布环境。
2. 下载两个项目的GoogleService-Info.plist，重命名为GoogleService-Info-Prod.plist和GoogleService-Info-Staging.plist，添加到项目中。
3. 在App启动时根据当前环境初始化对应的Firebase配置：

import Firebase

func setupFirebase() {
    let environment = DatabaseClient.environment
    let plistName: String
    
    switch environment {
    case .production:
        plistName = "GoogleService-Info-Prod"
    case .staging:
        plistName = "GoogleService-Info-Staging"
    }
    
    guard let plistPath = Bundle.main.path(forResource: plistName, ofType: "plist"),
          let options = FirebaseOptions(contentsOfFile: plistPath) else {
        assertionFailure("Firebase配置文件不存在")
        return
    }
    
    FirebaseApp.configure(options: options)
}

4. 埋点代码无需额外判断，直接调用Analytics.logEvent即可，两个环境的数据会分别进入各自的Firebase项目后台。

方案2：为事件添加环境标记，后台过滤数据 #

在所有埋点事件中统一添加environment参数，标记当前环境，然后在Google Analytics后台设置过滤器，仅展示生产环境的数据。这种方式不需要维护多个Firebase项目，同时预发布环境可以正常验证埋点（包括调试日志和后台查看预发布数据）。

实现代码： #

import FirebaseAnalytics

func logAnalyticsEvent(name: String, parameters: [String: Any] = [:]) {
    var eventParams = parameters
    // 添加环境标记参数
    eventParams["environment"] = DatabaseClient.environment.rawValue
    
    // 所有环境都上报事件，后台通过参数过滤
    Analytics.logEvent(name, parameters: eventParams)
}

后台过滤设置： #

在Google Analytics控制台中，创建一个自定义过滤器，规则设置为包含environment参数等于production的事件，或者排除environment等于staging的事件，这样查看报表时就只会显示生产环境的数据。

方案3：动态控制Analytics数据上报开关 #

通过Analytics.setAnalyticsCollectionEnabled方法控制是否将数据上传到Firebase服务器：生产环境开启上报，预发布环境关闭上报，但保留本地调试日志的输出能力，这样预发布环境可以验证埋点是否触发，同时不会污染生产数据。

实现代码： #

import FirebaseAnalytics

func setupAnalytics() {
    let isProduction = DatabaseClient.environment == .production
    // 生产环境开启数据上报，预发布环境仅保留本地日志，不上传
    Analytics.setAnalyticsCollectionEnabled(isProduction)
    
    // 预发布环境强制开启调试模式（可选，也可以通过Xcode环境参数设置）
    if !isProduction {
        UserDefaults.standard.set(true, forKey: "FIRAnalyticsDebugEnabled")
    }
}

func logAnalyticsEvent(name: String, parameters: [String: Any]) {
    // 所有环境都调用logEvent，预发布环境不会上传，但调试控制台能看到日志
    Analytics.logEvent(name, parameters: parameters)
}

验证方式： #

预发布环境运行App时，添加-FIRAnalyticsDebugEnabled环境参数，即可在Xcode控制台看到埋点事件的触发日志，确认埋点逻辑正确；生产环境的数据会正常上传到Firebase后台，不受预发布操作干扰。

内容的提问来源于stack exchange，提问作者Nicolas Gimelli