@appdynamics/react-native-agent

中文文档
26.6.1发布于 2026/06/09Apache-2.0TypeScriptESM + CJS零依赖近 30 天下载 5923

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

中文使用文档
文档目录10 节
  1. 这个模块是做什么的?
  2. 设置
  3. 所需资源
  4. 第0步: 弹出您的应用程序
  5. 步骤1:安装 npm 包
  6. 第2步: 将您的申请工具化
  7. 第3步: (仅限机器人) 添加权限
  8. 使用量
  9. 文档
  10. 手动安装

用于反应的 AppDynamic 剂

给予充分支持 AppDynamics 应用程序 移动 RUM(真正的用户监测)用于反应-内在应用.

这个模块是做什么的?

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

设置

所需资源

反应原生版本0.6或以上.

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

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

确定你的应用程序被"抛出". 代理人需要适当适用于票据。 它不会在博览会工作!
见 反射弹出解释 需要更多信息.

步骤1:安装 npm 包

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

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

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

上面的命令将修改您的构建配置, 以启用您的应用程序的构建时仪 。 它假设你保留了 默认的项目结构 与反应-内生 Cli 工具。 如果您对 Android 和 iOS 的项目做了大量修改, 此命令可能会失败 。 如果是,请参考 手动安装 本手册的章节.

第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,不重要. 你会得到一个 应用程序密钥 下一步你需要它.

启动代理 :

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

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

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

i️使用 框架!

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

// Podfile
platform :ios, '11.0'

$toggleADEUMRNStaticFramework = true

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

文档

在此读取 API 的全部文档 学习如何定制仪器.

手动安装

大多数用户都不用做这些步骤. 在多数情况下,您可以使用以下描述的CLI: 设置 节. 如果那样行不通 那就跟着这些步骤.

对于机器人,请在您的 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,将应用动力学代理模块与其他任何本土模块相连接. 读取手动链接 这里。 。 。 .

版本与发布记录

@appdynamics/react-native-agent 共发布 26 个版本,首次发布于 2019/04/12;过去 12 个月发布了 1 个版本。

版本发布日期距今
26.6.1latest2026/06/094 个月前
25.9.02025/10/061.1 年前
25.2.02025/02/111.7 年前
24.7.12024/11/212 年前
24.7.02024/07/092 年前
24.4.02024/04/082 年前

关于 @appdynamics/react-native-agent 的常见问题

@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 和提交记录判断。