开发与工程

Expo 棕地集成助手

帮助团队将 Expo 和 React Native 增量集成到现有的原生 iOS 或 Android 应用中。

58/ 100
推荐

整体可靠,存在已披露的局限;按说明试用并保留回滚路径。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 2.9k
最近更新
21 天前
License
MIT
exporeact-nativebrownfieldios
+3androidaarxcframework

这个 Skill 能做什么,适合哪些场景?

该技能面向已经存在原生 iOS 或 Android 应用、希望逐步引入 React Native 的团队。它比较并指导两种方案:以 AAR 或 XCFramework 形式交付的隔离式集成,以及直接加入 Gradle 或 CocoaPods 构建流程的集成式方案。内容涵盖方案选择、共享前置条件、版本要求和常见故障排查。Expo SDK 55 是棕地集成的最低支持版本。

根据团队是否需要 Node.js、React Native 工具链、热更新、源代码映射以及独立代码仓库等条件,帮助选择隔离式或集成式方案;说明如何构建和消费 AAR/XCFramework,或将 React Native 与 Expo 加入 Gradle、CocoaPods、ReactActivity、RCTRootView 等原生构建与入口;提供 Metro 连接、构建、签名和模块解析问题的排查方向。

适合
  • 原生 Android 团队希望将 React Native 作为 AAR 依赖接入现有 Kotlin 应用,且不安装 Node.js。
  • 原生 iOS 团队希望将预构建 XCFramework 接入现有 Swift 应用,并让 RN 代码独立仓库维护。
  • 同一个团队同时维护原生代码和 RN 代码,希望把 Expo 直接加入 Gradle 与 CocoaPods 构建流程。
  • 已有原生应用需要逐步引入 React Native,并需要在隔离式和集成式架构之间做选择。
  • 团队升级棕地项目时,需要确认 Expo SDK 版本、自动链接入口和构建环境要求。

如何安装这个 Skill?

使用前请注意
  • 集成文档同时出现 Expo SDK 54 和 SDK 55 作为最低版本的说法;在采用前应以目标 SDK 的官方模板和 API 实际可用性为准。
  • 故障排查包含 rm -rf ~/.m2/...、ios/build、ios/Pods 等清理命令;执行前应确认路径、备份必要状态并准备可恢复方案。
  • 远程私有 Maven 发布涉及用户名、密码或令牌;应仅通过受控环境变量和最小权限凭据操作,先确认发布目标与权限。
  • 未提供该技能关键路径的已执行构建或测试证据。
开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 本地文件系统
需要预先安装
  • Node.js LTS
  • Yarn
  • CocoaPods for integrated iOS builds

该技能属于 expo/skills 集合。使用 Skills CLI 安装集合:npx skills@latest add expo/skills --skill '*';也可按 README 所述,在 Codex 中运行 codex plugin add expo@openai-curated,或在 Claude Code 中运行 claude plugin install expo@claude-plugins-official。源材料未提供仅安装 expo-brownfield 的 CLI 命令。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/expo/skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/plugins/expo/skills/expo-brownfield" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 我有一个现有的 Kotlin Android 应用,想以 AAR 方式嵌入 Expo/React Native,应该选择哪种棕地方案?
  • 如何把 Expo 和 React Native 集成到现有的 Swift/CocoaPods 项目中?

在已安装该技能的代理中提出具体请求,例如:“我有一个现有的 Kotlin Android 应用,想以 AAR 方式嵌入 Expo/React Native,应该选择哪种棕地方案?”或“如何把 Expo 和 React Native 集成到现有的 Swift/CocoaPods 项目中?”创建项目时明确固定 SDK 版本,例如 npx create-expo-app@latest my-project --template default@sdk-55,并在 RN 项目及嵌入依赖中保持相同的 Expo SDK。

这个 Skill 有哪些优点和局限?

优点
  • 同时覆盖隔离式和集成式两种棕地架构。
  • 给出基于团队所有权、工具链和发布节奏的方案选择规则。
  • 覆盖 iOS 与 Android,并包含构建、签名、Metro 和模块解析等常见问题。
  • 明确指出 Expo SDK 55 是最低支持版本。
局限
  • 技能主要提供决策和实施指导;源材料未显示它会自动执行构建或修改项目。
  • 两种方案的 React Native 构建环境都需要 Node.js LTS 和 Yarn。
  • 集成式 iOS 方案还需要 CocoaPods;隔离式方案的消费端虽不需要 RN 工具链,但构建 RN 侧仍有前置条件。
  • 源材料未提供测试套件或自动化验证结果。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
Expo 棕地集成助手 本页 58 · 推荐 ★ 2.9k 21 天前 MIT
React Native 棕地迁移助手 53 · 谨慎使用 ★ 1.7k 18 天前 MIT
Expo 原生 UI 构建助手 59 · 推荐 ★ 2.9k 21 天前 MIT
Expo Web 转原生迁移指南 52 · 谨慎使用 ★ 2.9k 21 天前 MIT
React Native 迁移评估 57 · 谨慎使用 ★ 1.7k 18 天前 MIT

它明确比较隔离式集成与集成式集成:前者交付 AAR/XCFramework,适合原生团队不安装 Node.js 或 RN 工具链、代码分仓或独立发布;后者把 React Native 源码加入 Gradle/CocoaPods,适合一个团队统一维护并需要热更新和源代码映射的场景。

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
推荐
58/ 100 五分制 2.9 / 5
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
1信任安全17 / 25 · 3.4/5

内容总体遵循项目范围,说明了本地构建、远程发布及环境变量凭据的流向,也区分了消费端与构建端依赖;但发布到远程仓库和修改原生构建会产生外部影响,缺少明确的用户确认、权限最小化、回滚和安全审查步骤,故扣分。

2可靠稳定8 / 20 · 2.0/5

集成与隔离路径、平台配置、常见故障和开发/生产差异均有较完整说明;但文件存在 SDK 54 与 SDK 55 最低版本表述不一致,且没有提交的测试套件或可静态验证的关键路径执行证据,按静态校准不超过 10,故扣分。

3适用触发11 / 15 · 3.7/5

目标用户、隔离/集成选择条件、Android/iOS/monorepo 场景和不适用情形较清楚,并提供故障分流;但触发边界、输入输出契约、非标准构建系统兼容范围及中文环境说明不足,也未明确大陆网络可达性,故扣分。

4规范维护10 / 15 · 3.3/5

目录结构、渐进式参考文档、安装命令、示例、版本提示、故障排查、MIT 许可证和仓库维护工作流均有覆盖;但缺少该技能自身的版本号、变更日志、明确维护负责人和更新路径,且部分假设分散在正文中,故扣分。

5有效结果7 / 15 · 2.3/5

文档提供了可直接复制的 Gradle、Podfile、Kotlin、Swift 和发布示例,能够覆盖核心 brownfield 集成任务;但没有实际构建结果或代表性输出验证,且 SDK/API 版本矛盾可能导致返工,静态校准最高只能给 7,故扣分。

6证据核验5 / 10 · 2.5/5

引用了 Expo 文档和 GitHub 模板,并包含仓库 CI 检查工作流,关键配置具有一定可审计性;但没有针对该技能路径的测试、构建产物、日志或第三方交叉验证,静态评估最高只能给 5,故扣分。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月20日 审查版本 8bd359f8a44d 评估证据[1][2][3][4][5][6][7][8][9][10][11]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

这个技能需要付费吗?
源材料只说明仓库采用 MIT 许可证。未说明该单项技能存在费用;README 将部分 EAS 服务技能归为付费分发范围,但 expo-brownfield 属于 Framework 开源组。
最低支持哪个 Expo SDK?
Expo SDK 55。更早版本缺少 expo-brownfield、所需的 ExpoReactHostFactory/ExpoReactNativeFactory 入口及当前自动链接能力。
隔离式方案是否需要在原生消费应用中安装 CocoaPods 或 Node.js?
隔离式方案的消费端不需要 CocoaPods 或 React Native 工具链;但构建 React Native 侧仍需要 Node.js LTS 和 Yarn。
什么时候应该选集成式方案?
当同一团队拥有原生与 RN 代码、愿意把 React Native 和 Expo 加入 Gradle/CocoaPods,并希望热更新和 JS 源代码映射融入现有构建流程时。

同仓库的其他 Skills

均来自 expo/skills

开发与工程

Expo 原生 UI 构建助手

用 @expo/ui 在 Expo 中构建跨平台原生界面。

★ 2.9k FS 59 推荐 21 天前
开发与工程

Expo Web 转原生迁移指南

将现有 React 网站逐屏迁移为可发布的 Expo 原生应用。

★ 2.9k FS 52 谨慎使用 21 天前
开发与工程

Expo 开发客户端构建助手

为 Expo 原生代码测试构建并分发开发客户端。

★ 2.9k FS 54 谨慎使用 21 天前
开发与工程

Expo 应用商店发布助手

用 EAS 构建并发布 Expo 应用到 App Store、Google Play 和 TestFlight。

★ 2.9k FS 52 谨慎使用 21 天前
开发与工程

Expo 技能评测器

端到端验证 Expo 技能是否触发、产出可用代码并正确渲染。

★ 2.9k FS 48 谨慎使用 21 天前
开发与工程

Expo 项目结构指南

为全新的 Expo Router 应用建立清晰、可扩展的文件结构。

★ 2.9k FS 57 谨慎使用 21 天前
自动化与运维

EAS Observe 性能观测助手

帮助 Expo 团队接入、查询并解读生产环境中的启动、导航和自定义事件性能指标。

★ 2.9k FS 55 谨慎使用 21 天前
开发与工程

Expo 数据请求指南

为 Expo 应用提供从 API 请求到缓存、离线与身份验证的网络开发指导。

★ 2.9k FS 55 谨慎使用 21 天前
开发与工程

Expo 技能反馈

帮助用户提交 Expo 技能或框架反馈,并管理匿名使用遥测。

★ 2.9k FS 54 谨慎使用 21 天前
开发与工程

Expo 集成示例助手

用 Expo 官方示例快速适配第三方库与服务。

★ 2.9k FS 51 谨慎使用 21 天前
设计与前端

Expo 原生界面设计指南

帮助 Expo 开发者构建符合 Apple 设计规范、具备原生体验的响应式界面。

★ 2.9k FS 51 谨慎使用 21 天前
开发与工程

Expo SDK 升级助手

帮助 Expo 团队升级 SDK、处理依赖冲突并完成兼容性清理。

★ 2.9k FS 50 谨慎使用 21 天前
开发与工程

Expo DOM 组件助手

让 Expo 原生应用渐进式复用 Web 代码与 Web 专属库。

★ 2.9k FS 49 谨慎使用 21 天前
开发与工程

Expo Tailwind 样式配置助手

为 Expo 应用配置 Tailwind CSS v4、NativeWind v5 与跨平台样式支持。

★ 2.9k FS 43 不推荐 21 天前
开发与工程

EAS 云端模拟器助手

让无法本地运行模拟器的团队在 EAS 云端运行、操控并截图 Expo 应用。

★ 2.9k FS 60 推荐 21 天前
开发与工程

Expo 原生模块迁移助手

将现有 Expo 原生模块从 1.0 DSL 迁移到 2.0 宏 API,同时保持 JavaScript 接口不变。

★ 2.9k FS 60 推荐 21 天前
开发与工程

Expo App Clip 助手

为 Expo 应用配置可由网址唤起的 iOS App Clip。

★ 2.9k FS 55 谨慎使用 21 天前
自动化与运维

EAS 更新健康洞察

用 CLI 检查 EAS Update 的崩溃率、采用情况与发布健康度。

★ 2.9k FS 55 谨慎使用 21 天前
自动化与运维

Expo EAS 工作流助手

帮助 Expo 项目编写、编辑和验证 EAS CI/CD 工作流。

★ 2.9k FS 50 谨慎使用 21 天前
开发与工程

Expo EAS 托管部署

帮助 Expo 项目部署网站与 API 路由,并配置密钥、域名和边缘运行时。

★ 2.9k FS 48 谨慎使用 21 天前

相关 Skills