Ionic Cordova Firebasex集成Firebase Analytics采集禁用问题求助

问题背景 #

使用cordova-plugin-firebasex集成Firebase Analytics，构建成功后屏幕追踪数据未在Firebase控制台显示。开启调试模式（-FIRDebugEnabled）后，日志提示：

10.24.0 - [FirebaseAnalytics][I-ACS024000] Debug mode is on
10.24.0 - [FirebaseAnalytics][I-ACS023007] Analytics v.10.24.0 started
10.24.0 - [FirebaseAnalytics][I-ACS023013] Analytics collection disabled
10.24.0 - [FirebaseAnalytics][I-ACS023049] Analytics is disabled. Event not logged

已尝试手动修改AppDelegate.m、调用插件setAnalyticsCollectionEnabled(true)方法、修改GoogleService-Info.plist，均未解决。

解决方案 #

1. 确保插件配置参数正确 #

cordova-plugin-firebasex初始化时会覆盖手动设置的Analytics状态，必须在config.xml中明确启用：

<plugin name="cordova-plugin-firebasex" spec="latest">
    <variable name="ANALYTICS_COLLECTION_ENABLED" value="true" />
    <variable name="IOS_ANALYTICS_COLLECTION_ENABLED" value="true" />
    <!-- 其他插件配置项 -->
</plugin>

2. 验证GoogleService-Info.plist配置 #

确认plist文件中以下字段值为YES：

• IS_ANALYTICS_ENABLED
• FIREBASE_ANALYTICS_COLLECTION_ENABLED

若通过插件自动导入plist，建议重新执行cordova prepare ios同步配置，或手动修改后清理构建缓存。

3. 清理构建缓存 #

缓存可能导致配置不生效，执行以下命令：

cordova clean ios
rm -rf platforms/ios/Pods platforms/ios/Podfile.lock
cordova prepare ios

之后重新构建应用。

4. 确保在正确时机启用Analytics #

在deviceready事件触发后立即调用插件方法启用，并测试事件上报：

document.addEventListener("deviceready", () => {
    FirebasePlugin.setAnalyticsCollectionEnabled(true);
    // 发送测试事件验证
    FirebasePlugin.logEvent("test_analytics_enabled", {});
}, false);

5. 检查Firebase DebugView #

常规Analytics报表数据有延迟，先在Firebase控制台的Analytics > DebugView中查看是否有调试设备的事件数据，确认事件是否上报成功。

6. 处理iOS 14+追踪权限 #

iOS 14及以上需要用户授权App Tracking Transparency，否则Analytics无法收集数据：

• 在config.xml添加权限描述：

<edit-config target="NSUserTrackingUsageDescription" file="*-Info.plist" mode="merge">
    <string>为优化服务需要收集应用使用数据</string>
</edit-config>

• 在代码中请求权限并启用Analytics：

document.addEventListener("deviceready", () => {
    FirebasePlugin.requestPermission().then(granted => {
        if (granted) {
            FirebasePlugin.setAnalyticsCollectionEnabled(true);
        }
    });
}, false);

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