mcpField
R
rnrepo

rnrepo

github.com/software-mansion-labs开发2961.1k 次安装2 周前更新
代码仓库

关于 rnrepo

rnrepo 是用于配置和排查 Software Mansion RNRepo 的技能,面向 React Native 开发者,指导通过 Expo CNG 或标准项目接入预构建库产物并处理构建问题。

主要功能

  1. 01配置 Expo CNG 和标准 React Native
  2. 02设置 Android Gradle 与 iOS CocoaPods
  3. 03按库或全局停用
  4. 04排查构建问题

适用场景

  1. 01在 React Native 项目中配置 RNRepo
  2. 02排除带原生补丁的库
  3. 03调查预构建产物导致的构建失败

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/software-mansion-labs/skills --skill rnrepo

安装后在 Claude Code 中输入/rnrepo确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
configuration.md
installation.md
troubleshooting.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