更新记录

1.0.5（2023-12-12）

• 升级sdk ios 10.18.0
• 完善接口

1.0.4（2023-08-23）

• 升级firebase analytics 21.3.0

1.0.3（2021-12-29）

• 支持android 4.4

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

使用文档 （更多插件及问题，请加微信：zhuzheVIP1）

超级福利

说明

此插件提供 firebase-analytics 分析能力

使用前提

• 注册账号
• 创建 Firebase 项目
• 将 Firebase 添加到您的 Android 应用，并下载配置文件 google-services.json
• 将 Firebase 添加到您的 iOS 应用，并下载配置文件 GoogleService-Info.plist

如果用到unipush的google推送或uni自带的google统计，以下配置可以省略

重要配置（必须仔细看）：

• 方式一

  下载配置插件 修改iOS 的GoogleService-Info.plist 直接替换即可 修改android 的 google-services.json 需转换成config.xml 文件（请联系微信 zhuzheVIP1 帮助转换，切勿自己转换）

• 方式二

  在项目根目录下创建如下目录（具体目录结构可参考uni-app官方文档）

  nativeResources/
  ├── android
  │   └── res
  │       └── values
  │           └── config.xml
  └── ios
    └── Resources
        └── GoogleService-Info.plist

使用

• 获取analytics实例

var analytics = uni.requireNativePlugin("sn-firebase-analytics");

方法

• getAppInstanceId - 获取应用实列ID

analytics.getAppInstanceId(e => {
  if(e.code == 0) {
    // e.id
  }
})

• getFirebaseInstanceId - 获取Firebase实列ID

analytics.getFirebaseInstanceId(e => {
  if(e.code == 0) {
    // e.id
  }
})

• setUserId - 设置用户ID

analytics.setUserId("1234567890");

• setUserProperty - 设置用户属性

参考文档

analytics.setUserProperty("gender", "male");

• setDefaultEventParameters - 设置默认事件参数

参考文档

analytics.setDefaultEventParameters({
  level_name: "Caverns01",
  level_difficulty: 4,
});

• setAnalyticsCollectionEnabled - 设置是否开启统计, 默认开启

analytics.setAnalyticsCollectionEnabled(true);

• logEvent - 统计事件

事件参考

// 统计
analytics.logEvent(
  {
    name: "select_content",
    params: {
      item_id: "1",
      item_name: "hello uni",
      content_type: "image",
    },
  },
  (e) => {
    console.log("logEvent", e);
  },
);

• getGaid - 获取 gaid （仅Android）

// 获取 gaid
analytics.getGaid((e) => {
  if (e.code == 0) {
    // e.gaid;
  }
});

常见问题

• 统计需要 24 小时生效，如果需要实时测试，则需要开启 DebugView