RangersAPMDylibTool 是一款 macOS 桌面工具，用于将 RangersAPM/APMPlus 的多个静态库子模块封装为单一动态框架 XCFramework，以动态库形式集成到 iOS 项目中。工具支持的产物形式及说明如下： |**产物形式** |**说明** | |---|---| |SPM |生成 XCFramework 文件，可手动拖入项目或通过本地 Swift Package Manager 引用。 | |CocoaPods |生成 XCFramework 和 podspec 文件，可通过私有 pod 源或本地源集成。 | ## 前提条件 * macOS 系统环境。 * 网络连接正常，确保构建过程可正常访问 GitHub 下载静态库。 * 已下载 RangersAPMDylibTool 并在 **系统设置** \> **隐私与安全性** 中信任该工具。 * 若项目中已有通过 CocoaPods 或 SPM 静态库方式集成的 RangersAPM/APMPlus 相关组件，请先移除该组件再集成动态库版本，避免符号冲突。 ## 操作步骤 1. 下载 RangersAPM 下载压缩包并解压，即可直接运行并使用 RangersAPMDylibTool。 RangersAPMDylibTool.zip 2. 输入版本号启动工具后，输入需要使用的 RangersAPM 版本号（如 5.2.15），然后单击 **获取可用组件**。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_672372a2c85d059eeb29f131eb223b44.png) 3. 选择子库与产物形式勾选需要的子库（如 Crash、WatchDog）并选择产物形式，然后单击 **生成动态库**。有关子库的说明请参见 [子库说明](https://docs.volcengine.com/docs/6431/68850?lang=zh)。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_13311a717dcdbcff65232e70025cd9da.png) 4. 构建动态库工具自动执行动态库构建并生成构建日志。若构建失败，可单击 **复制错误信息** 获取完整错误日志用于问题排查，详情请参见 [常见问题](https://docs.volcengine.com/docs/6431/2599208?lang=zh#2UVE81s6)。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_df1ba872998e0cfbbd5739068e546018.png) 5. 导出产物构建成功后，单击 **选择目录并导出**，工具会将最终产物导出到指定目录。

说明

生成的产物不再区分子库，统一为单一 framework 且动态库名称为 RangersAPMDylib。

## 常见问题 ### RangersAPM 支持哪些架构？ * 真机：arm64 * 模拟器：arm64 / x86_64（支持 Apple Silicon Mac 上的模拟器） ### **构建失败如何处理？** 单击 **复制错误信息** 按钮，将日志提供给技术支持进行排查。常见失败原因及说明如下： |**失败原因** |**说明** | |---|---| |网络超时 |构建过程需要从 GitHub 拉取依赖，请检查网络连接和代理配置。 | |版本号不存在 |输入版本号在远端仓库中不存在，请确认版本号是否正确。 | |系统 framework 依赖缺失 |新版本可能引入了尚未覆盖的系统 framework 依赖，请联系技术支持处理。 |

应用性能监控全链路版