@capacitor-community/firebase-analytics屏幕名设置无数据，求正确配置

已将项目更新至@capacitor-community/firebase-analytics@5.0.1，并创建了如下分析跟踪服务：

analyticsEnabled: boolean = true;

constructor() { 
    this.init();
}

init() {
    if (Capacitor.getPlatform() === 'web') {
        FirebaseAnalytics.initializeFirebase(environment.firebase);
    }
    FirebaseAnalytics.setCollectionEnabled({
        enabled: environment.production
    });
}

setUser(userId:string) {
    FirebaseAnalytics.setUserId({
        userId: userId,
    });
}

setProperty(name:string,value:string) {
    FirebaseAnalytics.setUserProperty({
        name: name,
        value: value,
    });
}

logEvent(name:string,params:object) {
    FirebaseAnalytics.logEvent({
        name: name,
        params: params
    });
}

setScreenName(screenName:string) {
    FirebaseAnalytics.setScreenName({
        screenName: screenName,
        nameOverride: screenName
    });
}

toggleAnalytics() {
    this.analyticsEnabled = !this.analyticsEnabled;
    FirebaseAnalytics.setCollectionEnabled({
        enabled: this.analyticsEnabled,
    });
}

在Ionic页面中通过ionViewDidEnter手动设置屏幕名：

ionViewDidEnter() {
    this.analytics.setScreenName('Home');
}

Xcode控制台能看到Native调用记录：

⚡️  To Native ->  FirebaseAnalytics setUserId 36273285
⚡️  To Native ->  FirebaseAnalytics setScreenName 36273286
⚡️  To Native ->  FirebaseAnalytics setScreenName 36273288
⚡️  To Native ->  FirebaseAnalytics setScreenName 36273289

但Google Analytics和Firebase Analytics报告中始终没有屏幕名数据，以下是可能的原因及解决方法：

1. 参数名不符合插件v5版本要求 #

@capacitor-community/firebase-analytics@5.0.1中，setScreenName方法的参数结构已更新，原nameOverride参数已更名为screenClassOverride，且为可选参数。你的代码中使用了旧参数名，导致Native端无法正确解析，进而无法设置屏幕名。

修改setScreenName方法：

setScreenName(screenName:string) {
    FirebaseAnalytics.setScreenName({
        screenName: screenName,
        // 可选：如需覆盖屏幕类名则保留，否则可移除
        screenClassOverride: screenName
    });
}

2. 数据收集未启用或处于开发环境 #

初始化代码中设置了setCollectionEnabled({ enabled: environment.production })，如果当前是开发环境（environment.production为false），Firebase会禁止数据上传到正式报告，仅能通过DebugView查看。

• 若需在开发环境验证，可临时将enabled设为true，或使用Firebase DebugView实时查看事件。
• 正式环境需确保environment.production为true。

3. 数据延迟显示 #

Firebase Analytics报告的数据存在延迟，通常需要数小时到24小时才能在控制台显示。如需即时验证，使用Firebase DebugView：

1. 在设备或模拟器上启动Debug模式；
2. 打开Firebase控制台的DebugView页面，可实时查看所有发送的事件及参数。

4. 确认事件是否正确触发 #

部分版本的插件中，setScreenName仅设置屏幕属性，不会自动触发screen_view事件。若上述修改后仍无数据，可手动触发该事件：

setScreenName(screenName:string) {
    FirebaseAnalytics.setScreenName({
        screenName: screenName,
        screenClassOverride: screenName
    });
    // 手动触发屏幕视图事件
    FirebaseAnalytics.logEvent({
        name: 'screen_view',
        params: {
            screen_name: screenName,
            screen_class: screenName
        }
    });
}

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