应用性能监控全链路版
应用性能监控全链路版
应用性能监控全链路版
文档指南
请输入
产品动态
用户指南
应用性能监控
组件管理
接入指南
使用指南
最佳实践
客户端监控
App 端监控
SDK 接入
使用指南
最佳实践
常见问题
App 端监控通用
Android 端监控
iOS 端监控
WebPro 端监控
使用指南
小程序 Pro 监控
PC 端监控
API 参考
API 接口 - 应用性能监控
告警管理
指标查询
Trace 分析
API 接口 - 客户端控制台
API 接口 - App 端
事件
报警
异常和崩溃
CPU 监控
电量监控
API 接口 - WebPro 端
Action 列表
报警
JS错误监控
性能监控
请求监控
静态资源监控
API 接口 - 小程序 Pro 端
JS 错误
报警
API 接口 - PC 端
崩溃
报警
常见问题
- 文档首页
应用性能监控全链路版用户指南客户端监控App 端监控最佳实践RangersAPM 动态库封装工具使用指南
复制全文
下载 pdfRangersAPM 动态库封装工具使用指南
文档反馈
问问助手RangersAPMDylibTool 是一款 macOS 桌面工具，用于将 RangersAPM/APMPlus 的多个静态库子模块封装为单一动态框架 XCFramework，以动态库形式集成到 iOS 项目中。
工具支持的产物形式及说明如下：
产物形式 | 说明 |
产物形式 | 说明 |
SPM | 生成 XCFramework 文件，可手动拖入项目或通过本地 Swift Package Manager 引用。 |
CocoaPods | 生成 XCFramework 和 podspec 文件，可通过私有 pod 源或本地源集成。 |
前提条件
- macOS 系统环境。
- 网络连接正常，确保构建过程可正常访问 GitHub 下载静态库。
- 已下载 RangersAPMDylibTool 并在 系统设置 > 隐私与安全性 中信任该工具。
- 若项目中已有通过 CocoaPods 或 SPM 静态库方式集成的 RangersAPM/APMPlus 相关组件，请先移除该组件再集成动态库版本，避免符号冲突。
操作步骤
- 下载 RangersAPM
- 下载压缩包并解压，即可直接运行并使用 RangersAPMDylibTool。
- 选择版本号
- 启动工具后，选择需要使用的 RangersAPM 版本号（如 5.2.15），然后单击 获取可用组件。
-
- 选择子库与产物形式
- 勾选需要的子库（如 Crash、WatchDog）并选择产物形式，然后单击 生成动态库。有关子库的说明请参见 子库说明。
-
- 构建动态库
- 工具自动执行动态库构建并生成构建日志。若构建失败，可单击 复制错误信息 获取完整错误日志用于问题排查，详情请参见 常见问题。
-
- 导出产物
- 构建成功后，单击 选择目录并导出，工具会将最终产物导出到指定目录。
说明
生成的产物不再区分子库，统一为单一 framework 且动态库名称为 RangersAPMDylib。
常见问题
RangersAPM 支持哪些架构？
- 真机：arm64
- 模拟器：arm64 / x86_64（支持 Apple Silicon Mac 上的模拟器）
构建失败如何处理？
单击 复制错误信息 按钮，将日志提供给技术支持进行排查。常见失败原因及说明如下：
失败原因 | 说明 |
失败原因 | 说明 |
网络超时 | 构建过程需要从 GitHub 拉取依赖，请检查网络连接和代理配置。 |
版本号不存在 | 输入版本号在远端仓库中不存在，请确认版本号是否正确。 |
系统 framework 依赖缺失 | 新版本可能引入了尚未覆盖的系统 framework 依赖，请联系技术支持处理。 |
最近更新时间：2026.08.20 10:33:21
这个页面对您有帮助吗？
有用
有用
无用
无用