# @appdynamics/react-native-agent 中文文档

规范地址：https://npmcn.com/package/%40appdynamics/react-native-agent/

版本：26\.6\.1
npm 元数据更新时间：2026-06-08T18:58:34.662Z
中文译文更新时间：2026-11-06T11:26:12.759Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：805 kB，412 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.11\.0
- 运行依赖：0 个
- peer 依赖：react \*，react-native \*
- 首次发布：2019-04-12T07:57:07.243Z
- 最新版本发布：2026-06-08T18:58:34.556Z
- 近 30 天下载量：5923（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：26（近 12 个月 1 个）

## 中文简介

IOS的原生仪器和由反应-内生制成的和机器人应用.

## 安装

```sh
npm install @appdynamics/react-native-agent
```

也可以使用：`pnpm add @appdynamics/react-native-agent`、`yarn add @appdynamics/react-native-agent`、`bun add @appdynamics/react-native-agent`

## README

# 用于反应的 AppDynamic 剂

给予充分支持 [AppDynamics 应用程序](https://www.appdynamics.com/) 移动 RUM(真正的用户监测)用于反应-内在应用.

## 这个模块是做什么的?

此模块将本地的 AppDynamics 代理输入您的应用程序, 并提供一个 JavaScript 桥到 `Instrumentation` 管理界面.

## 设置

### 所需资源

反应原生版本0.6或以上.

(仅iOS):Pod目标与Xcode部署目标必须同时为QQ11. 在 Podfile 中查找位于 <your react native app>/ios/ 的 pod 目标版本.

### 第0步: 弹出您的应用程序

**确定你的应用程序被"抛出"**. 代理人需要适当适用于票据。 它不会在博览会工作!  
见 [反射弹出解释](https://stackoverflow.com/a/45252151/2246678) 需要更多信息.

### 步骤1:安装 npm 包

```
npm install --save @appdynamics/react-native-agent
```

### 第2步: 将您的申请工具化

```
node node_modules/@appdynamics/react-native-agent/bin/cli.js install
```

上面的命令将修改您的构建配置, 以启用您的应用程序的构建时仪 。 它假设你保留了 默认的项目结构 与反应-内生 Cli 工具。 如果您对 Android 和 iOS 的项目做了大量修改, 此命令可能会失败 。 如果是,请参考 [手动安装](https://npmcn.com/package/%40appdynamics/react-native-agent/#readme-manual-installation) 本手册的章节.

### 第3步: (仅限机器人) 添加权限

在您的应用程序中添加以下权限 `AndroidManifest.xml` (应置于 `android/app/src/main/`) (中文(简体) ).

```
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.your.application">

    // Add the following:
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

    // ...
</manifest>
```

> i️需要这些权限,以便代理在资源稀缺时限制其活动.

## 使用量

首先,登录您的 AppDynamics 账户,并创建一个新的移动应用程序 。 选择Android或iOS,不重要. 你会得到一个 **应用程序密钥** 下一步你需要它.

启动代理 :

```ts
import {Instrumentation} from '@appdynamics/react-native-agent';

Instrumentation.start({
  appKey: 'YOUR-APP-KEY-HERE',
});
```

> **资讯**:您应该尽快初始化代理,最好在您的 `index.js` 文档.

##### i️使用 框架!

使用时 `use_frameworks!`,您还需要添加 `$toggleADEUMRNStaticFramework = true` 在你身边 `Podfile`数字 :

```ruby
// Podfile
platform :ios, '11.0'

$toggleADEUMRNStaticFramework = true

target 'MyApp' do
    use_frameworks!
    // ...
end
```

## 文档

[在此读取 API 的全部文档](https://docs.appdynamics.com/display/PRO21/Instrument+React+Native+Applications) 学习如何定制仪器.

## 手动安装

**大多数用户都不用做这些步骤.** 在多数情况下,您可以使用以下描述的CLI: [设置](https://npmcn.com/package/%40appdynamics/react-native-agent/#readme-setup) 节. 如果那样行不通 那就跟着这些步骤.

对于机器人,请在您的 `android/build.gradle`数字 :

```
apply from: '../node_modules/@appdynamics/react-native-agent/android/adeum.gradle'
```

确保文件 `settings.gradle` 包含如下所示的应用动力学代理模块的引用. 自动链接时应该自动添加此内容 .

```
include ':@appdynamics_react-native-agent'
project(':@appdynamics_react-native-agent').projectDir = new File(rootProject.projectDir, '../node_modules/@appdynamics/react-native-agent/android')
```

还有.., `android/app/build.gradle` 应用动力学代理模块.

```
dependencies {
    implementation project(':@appdynamics_react-native-agent')
    // ...
}
```

对于iOS,将应用动力学代理模块与其他任何本土模块相连接. 读取手动链接 [这里](https://reactnative.dev/docs/linking-libraries-ios#manual-linking)。 。 。 .

## 常见问题

### @appdynamics/react-native-agent 是什么？

IOS的原生仪器和由反应-内生制成的和机器人应用\.

### 如何安装 @appdynamics/react-native-agent？

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

### @appdynamics/react-native-agent 支持 TypeScript 吗？

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

### @appdynamics/react-native-agent 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @appdynamics/react-native-agent 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.11\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @appdynamics/react-native-agent 可以商用吗？

@appdynamics/react-native-agent 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @appdynamics/react-native-agent 的下载量有多少？

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

### @appdynamics/react-native-agent 还在维护吗？

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