更新记录

1.0.1（2026-03-29）

修改说明文档，上传Demo

1.0.0（2026-03-29）

1.0.0

平台兼容性

uni-app(3.7.2)

uni-app x(3.7.2)

gt-firebase

Google Firebase Analytics 插件（Android + iOS）。

1. Firebase 控制台准备

1. 在 Firebase 控制台创建项目并添加 Android / iOS 应用。
2. Android 下载 google-services.json，iOS 下载 GoogleService-Info.plist。
3. Android 必须把配置文件放进主工程
   • 在项目根目录新建目录：nativeResources/android/（大小写与官方一致）。
   • 将 Firebase 控制台下载的 google-services.json 放在该目录下，即：
     nativeResources/android/google-services.json
4. **Firebase 里注册的 Android 包名，签名文件必须和当前应用一致。
5. iOS 必须把 GoogleService-Info.plist 放进 Bundle 资源目录
   • 路径必须是：nativeResources/ios/Resources/GoogleService-Info.plist
6. iOS Bundle ID 须与 Firebase 控制台里该 iOS 应用的 Bundle ID 一致。

2. 使用示例

import {
  logEvent,
  setUserId,
  setUserProperty,
  setAnalyticsCollectionEnabled,
  setSessionTimeoutDuration,
  resetAnalyticsData
} from "@/uni_modules/gt-firebase"

setAnalyticsCollectionEnabled(true)
setUserId("u_1001")
setUserProperty("vip_level", "2")
setSessionTimeoutDuration(1800)

logEvent("open_home", {
  page: "home",
  from: "splash"
})

// 如需清空分析数据
// resetAnalyticsData()

3. API

• logEvent(eventName: string, eventParams: UTSJSONObject | null)
• setUserId(userId: string | null)
• setUserProperty(name: string, value: string | null)
• setAnalyticsCollectionEnabled(enabled: boolean)
• setSessionTimeoutDuration(seconds: Double)
• resetAnalyticsData()

统一返回：

{
  code: 200 | 400,
  msg: string
}

4. 注意事项

1. 在https://console.firebase.google.com/中正确创建应用，下载android：google-services.json；ios：GoogleService-Info.plist文件
2. 需要正确放置Firebase后台下载的配置文件，否则初始化会失败。
3. eventName、用户属性名请遵循 Firebase Analytics 命名规范。