---
metadata:
  - name: generator
    content: Diplodoc Platform v5.70.0
alternate:
  - https://appmetrica.yandex.com.tr/docs/en/sdk/react-native/analytics/migration-io-3-0-0.md
  - https://appmetrica.yandex.com.tr/docs/ru/sdk/react-native/analytics/migration-io-3-0-0.md
  - https://appmetrica.yandex.com.tr/docs/zh/sdk/react-native/analytics/migration-io-3-0-0.md
  - href: https://appmetrica.yandex.com.tr/docs/zh/sdk/react-native/analytics/migration-io-3-0-0.md
    type: text/markdown
    title: Markdown version
  - href: https://appmetrica.yandex.com.tr/docs/zh/llms.txt?revision=r22089357
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.com.tr/docs/zh/llms.txt?revision=r22089357

# 迁移到版本 3.0.0

## 同时运行两个版本的AppMetricaSDK {#two-versions}

您可以在应用中并行使用两个版本的AppMetrica SDK。 这是不希望看到的。 统计数据应
正常收集，但小幅偏差是可以接受的。 在这种情况下，应用大小
可能会略有增加，因为它将包含两个 SDK 而不是一个。

{% note alert %}

我们强烈不建议在应用代码中同时运行两个 SDK 版本并使用相同的 `API_KEY`。 这不会导致应用
崩溃或失败，但会导致统计数据不准确且不可靠。 在迁移到 `@appmetrica/react-native-analytics`
 时，请确保 `react-native-appmetrica` 插件没有出现在 `package-lock.json` 或 `yarn.lock` 中。

{% endnote %}

## 迁移指南 {#about-migration}

本指南包含示例，展示插件版本 `2.0.0` 和 `3.0.0` 之间的差异。 此部分
仅涵盖缺少向后兼容性的方法。

要迁移到新版本，请按以下步骤操作：

1. 将``react-native-appmetrica``依赖替换为``@appmetrica/react-native-analytics``。 查看示例在[依赖替换部分](#dependencies)。
2. 在代码中编辑导入语句。 所需的更改在[依赖导入部分](#import)中提供。
3. 在项目代码中，替换被简单重命名的类和方法。 所需的更改在[重命名依赖项的部分](#rename)中指出。

## 替换依赖项 {#dependencies}

{% list tabs %}

- yarn

   ```bash translate=no
   yarn remove react-native-appmetrica && yarn add @appmetrica/react-native-analytics
   ```

- npm

   ```bash translate=no
   npm uninstall react-native-appmetrica && npm install @appmetrica/react-native-analytics
   ```

{% endlist %}

## 导入依赖 {#import}

```javascript translate=no
import AppMetrica from 'react-native-appmetrica';
```
替换为：
```sh translate=no
import AppMetrica from '@appmetrica/react-native-analytics';
```

## Renamings {#rename}

- 方法 `requestAppMetricaDeviceId()` 已被移除。 使用 `requestStartupParams()` 方法获取 ID。
- 方法 `setStatisticsSending()` 已重命名为 `setDataSendingEnabled()`.