安装和初始化

AppMetrica React Native 是一个用于 React Native 平台的插件。 它包含 AppMetrica 对 Android 和 iOS 的 SDK 支持。

React Native 的最低支持版本是 0.59。

插件会访问原生的 Android/iOS 库,因此要与 Expo 一起使用它,需要遵循与原生组件集成的 库的说明。

此部分介绍如何启用并初始化 AppMetrica React Native:

步骤 1. 集成 AppMetrica React Native 插件

  1. 在项目中安装 AppMetrica React Native 插件:

    yarn add @appmetrica/react-native-analytics
    
    npm install @appmetrica/react-native-analytics
    
  2. 对于 React Native 版本 0.59 及以下,请运行以下控制台命令,将 AppMetrica 链接到您的项目:

    react-native link @appmetrica/react-native-analytics
    
  3. 如果你正在开发 iOS 项目,请在控制台执行此命令:

    npx pod-install
    
  4. 重建您的应用:

    # Android:
    npx react-native run-android
    # iOS:
    npx react-native run-ios
    
  1. 插件使用原生的 Android 和 iOS 库。 要使用本地代码,请创建开发版本。 了解更多.

    npx expo install expo-dev-client
    
  2. 在项目中安装 AppMetrica React Native 插件:

    npx expo install @appmetrica/react-native-analytics
    
  3. 重建您的应用:

    # Android:
    npx expo run:android
    # iOS:
    npx expo run:ios
    

步骤 2. 初始化 AppMetrica 库

  1. 在项目的源代码中导入库:

    import AppMetrica from '@appmetrica/react-native-analytics';
    

    在这种情况下,在源代码中使用AppMetrica来工作于库。

  2. 使用 AppMetrica 库的 activate() 方法进行初始化:

    AppMetrica.activate({
      apiKey: 'Your API key',
      sessionTimeout: 120,
      logs: true
    });
    
    什么是 API 密钥?

    API 密钥是在AppMetrica网页界面进行应用注册时分配的唯一应用 ID。 你可以在 设置 → 主页 中找到它。

  3. 发送事件以测试库:

    // Sends a custom event message and additional parameters (optional).
    AppMetrica.reportEvent('My event');
    AppMetrica.reportEvent('My event', { foo: 'bar' });
    
    // Send a custom error event.
    AppMetrica.reportError('My error')
    

示例项目:已集成AppMetrica SDK 的 GitHub 仓库。

了解更多

如果您没有找到所需答案,可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能,请附上截图。

联系支持 为文档提出改进建议