关于 rnrepo
rnrepo 是用于配置和排查 Software Mansion RNRepo 的技能,面向 React Native 开发者,指导通过 Expo CNG 或标准项目接入预构建库产物并处理构建问题。
主要功能
- 01配置 Expo CNG 和标准 React Native
- 02设置 Android Gradle 与 iOS CocoaPods
- 03按库或全局停用
- 04排查构建问题
适用场景
- 01在 React Native 项目中配置 RNRepo
- 02排除带原生补丁的库
- 03调查预构建产物导致的构建失败
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ software-mansion-labs/ skills --skill rnrepo安装后在 Claude Code 中输入/rnrepo确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/configuration.mdinstallation.mdtroubleshooting.md详细介绍
RNRepo
Software Mansion 用于预构建和分发 React Native 库制品的基础设施,无需更改基础设施,即可将原生构建时间缩短多达 2×。
请阅读与当前主题相关的参考文档。所有参考文档都位于 references/ 中。
关键信息
- Beta 版,仅支持新架构。 适用于 React Native 0.77、0.78、0.79 的最新补丁版本,以及所有 0.80.0 以上版本。
- 工作原理: Gradle 插件(Android)和 CocoaPods 插件(iOS)会拦截构建,并将库替换为来自
packages.rnrepo.org的预构建制品。如果没有可用的预构建制品,则回退到源码构建。 - Expo CNG: 使用
@rnrepo/expo-config-plugin,它会自动配置 Android 和 iOS。 - 标准 RN: 安装
@rnrepo/build-tools,并手动编辑android/build.gradle、android/app/build.gradle和ios/Podfile。 - 按库选择退出: 在项目根目录添加包含
denyList的rnrepo.config.json。带有原生补丁(Objective-C/Java/Kotlin)的库必须选择退出。仅修改 JS 的补丁无需选择退出。 - 完全退出: 在构建命令前设置环境变量
DISABLE_RNREPO=1。
参考文档
| 文件 | 阅读时机 |
|---|---|
references/installation.md | 首次设置 RNRepo 时——Expo CNG、标准 React Native、Android Gradle、iOS CocoaPods |
references/configuration.md | 选择退出特定库(denyList)、禁用插件、Fingerprint 配置、GPG 验证 |
references/troubleshooting.md | 构建失败、C++ 调试版/发布版不匹配、重复的 .so 文件、Xcode 版本问题、仓库列表为空、验证插件是否正常工作 |
评论
支持 Markdown