# @config-plugins/react-native-adjust 中文文档

规范地址：https://npmcn.com/package/%40config-plugins/react-native-adjust/

版本：14\.0\.2
npm 元数据更新时间：2026-09-23T11:25:59.043Z
中文译文更新时间：2026-11-10T15:18:30.483Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40config-plugins/react-native-adjust
原文对照：https://npmcn.com/package/%40config-plugins/react-native-adjust/?lang=original
项目主页：https://github.com/expo/config-plugins#readme
源码仓库：https://github.com/expo/config-plugins

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：21.4 kB，9 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：expo \>=56
- 首次发布：2022-01-17T21:12:24.586Z
- 最新版本发布：2026-08-15T09:57:28.335Z
- 近 30 天下载量：204323（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：19（近 12 个月 4 个）

## 中文简介

在预建时自动配置 SDK 配置插件

## 安装

```sh
npm install @config-plugins/react-native-adjust
```

也可以使用：`pnpm add @config-plugins/react-native-adjust`、`yarn add @config-plugins/react-native-adjust`、`bun add @config-plugins/react-native-adjust`

## README

# @ config-plugins/ react-inative-adjust (英语)

自动配置的 Expo 配置插件 [`react-native-adjust`](https://www.npmjs.com/package/react-native-adjust) 当本地代码生成时( w)`npx expo prebuild`) (中文(简体) ).

## 版本

确保您使用共同工作的版本 !

| `expo` | `react-native-adjust` | `@config-plugins/react-native-adjust` |
| --- | --- | --- |
| 56.0.0 (单位:千美元) | 5.6.0 (简体中文) | 14.0.0 (中文(简体) ) |
| 55.0.0 (简体中文) | 5.1.0 国家 | 13.0.0 (单位:千美元) |
| 54.0.0 (单位:千美元) | 5.1.0 国家 | 12.0.0 (单位:千美元) |
| 53.0.0 (韩语) | 5.1.0 国家 | 11.0.0 国家 |
| 52.0.0 (简体中文) | 5.0.2 保险制度 | 9.0.0 (单位:千美元) |
| 51.0.0 (单位:千美元) | 4.38.1 (中文(简体) ) | 8.0.0 (单位:千美元) |
| 50.0.0 (中文(简体) ) | 4.37.1 国家 | 7.0.0 (单位:千美元) |
| 49.0.0 (单位:千美元) | 4.33.0 (中文(简体) ) | 6.0.0 (单位:千美元) |

## 博览会安装

> 此软件包不能用于“ Expo Go” 应用程序, 因为 [它需要自定义本地代码](https://docs.expo.io/workflow/customizing/)。 。 。 .

首先用纱线、 npm 或 [`npx expo install`](https://docs.expo.io/workflow/expo-cli/#expo-install)。 。 。 .

```sh
npx expo install react-native-adjust @config-plugins/react-native-adjust
```

安装此 npm 软件包后, 添加 [配置插件](https://docs.expo.io/guides/config-plugins/) 页:1 [`plugins`](https://docs.expo.io/versions/latest/config/app/#plugins) 您的数组 `app.json` 或者说 `app.config.js`数字 :

```json
{
  "plugins": ["@config-plugins/react-native-adjust"]
}
```

## 配置选项

### Android 12+ 支持软件

如果针对Android 12及以上(API 31级),需要在插件的选项中添加:

```json
{
  "plugins": [
    ["@config-plugins/react-native-adjust", { "targetAndroid12": true }]
  ]
}
```

### SDK 签名

这将增加 [适当许可](https://github.com/adjust/react_native_sdk#add-permission-to-gather-google-advertising-id) 给你的.

设置调整 [SDK 签名](https://github.com/adjust/react_native_sdk/blob/master/README.md#sdk-signature) 您需要指定 xcframework 和 ar 文件的路径.

```json
{
  "expo": {
    "plugins": [
      "@config-plugins/react-native-adjust",
      {
        "targetAndroid12": true ,
        "sdkSignature" : {
          "android" : "./path/to.aar",
          "ios" : "./path/to.xcframework"
        }
      }
    ]
  }
}
```

### Meta 安装参考器

如果您需要跟踪Meta(脸书)安装裁判员,可以启用Meta安装裁判员依赖性:

```json
{
  "plugins": [
    ["@config-plugins/react-native-adjust", { "metaInstallReferrer": true }]
  ]
}
```

这将增加 `com.adjust.sdk:adjust-android-meta-referrer:5.4.0` 依赖你的Android构造.

医生: [https://dev.adjust.com/en/sdk/react-native/plugins/meta-referrer-plugin 互联网档案馆的存檔,存档日期2013-12-21](https://dev.adjust.com/en/sdk/react-native/plugins/meta-referrer-plugin)

### 组合

您可以合并多个选项 :

```json
{
  "plugins": [
    [
      "@config-plugins/react-native-adjust",
      {
        "targetAndroid12": true,
        "metaInstallReferrer": true
      }
    ]
  ]
}
```

接下来,重建您的应用程序,如 ["添加风俗本土代码"](https://docs.expo.io/workflow/customizing/) 向导.

## 常见问题

### @config-plugins/react-native-adjust 是什么？

在预建时自动配置 SDK 配置插件

### 如何安装 @config-plugins/react-native-adjust？

在项目目录运行 npm install @config-plugins/react-native-adjust，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：expo（\>=56）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @config-plugins/react-native-adjust 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @config-plugins/react-native-adjust 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @config-plugins/react-native-adjust 可以商用吗？

@config-plugins/react-native-adjust 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @config-plugins/react-native-adjust 的下载量有多少？

根据 npm 官方下载统计，@config-plugins/react-native-adjust 在 2026/10/11 – 2026/11/09 这 30 天内被下载 204,323 次，日均约 6,811 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @config-plugins/react-native-adjust 还在维护吗？

最新版本 14\.0\.2 发布于 2026/08/15（2 个月前）；至今共发布 19 个版本，其中过去 12 个月发布了 4 个；首次发布于 2022/01/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。