React Native Guides Troubleshooting

故障排除

最低系统版本或 Pods 构建不一致

先检查系统要求。应用采用 ComPDF 原生基线与 RN 宿主要求中的较高值，不能仅按 ComPDF 原生基线降低部署目标。当前 RN 0.85.3 示例使用 Android API 24、iOS 15.1。

iOS 应保持 Podfile、应用 Target 与 Pods 的部署目标一致，并使用 .xcworkspace 构建。不要通过降低 React-Codegen 的部署目标绕过当前 RN 版本要求。

原生方法不存在或版本不匹配

确认 React Native 包、Android SDK 和 iOS Pods 均为 3.2.0，重新安装依赖并构建原生应用。仅重新加载 JavaScript 无法加入新增原生接口。Expo 项目需使用原生构建，不能使用 Expo Go。

压缩失败或阅读器恢复失败

输出路径必须与源文件不同，且父目录已存在、可写。执行前保存编辑，同一阅读器只运行一个压缩任务。取消结果应按 cancelled 处理；发生 OPTIMIZE_RESTORE_FAILED 时重新打开文档后再操作。参见文档压缩优化。

数字签名或长期验证失败

检查证书路径、密码、当前签名域 UUID 和独立输出路径。配置时间戳或收集吊销材料时，确保服务可访问；同时检查返回的 success、errors 和 warnings。材料就绪与证书信任分别判断，参见时间戳与长期验证。

如仍无法定位，请联系技术支持，提供 SDK/RN 版本、平台、脱敏错误信息及可复现步骤。