SuperAPI AI 工具集

expo-brownfield

通用与其它

查看项目

更新于 10-16 06:13

技能介绍

用途:该技能用于把 Expo 与 React Native 增量集成到已有的原生 iOS 或 Android 应用中,即所谓 brownfield 场景,区别于从第一天就用 React Native 的 greenfield 项目。当用户提到 brownfield、在原生应用中嵌入 React Native、AAR/XCFramework,或向已有 Kotlin/Swift 项目添加 Expo 时适用。

主要能力:Expo 支持两种向 brownfield 项目添加 React Native 的方式。隔离式(Isolated)向原生应用交付预构建的 AAR 或 XCFramework,原生团队无需 Node 或 RN 工具链,RN 代码可放在独立仓库。集成式(Integrated)将 React Native 源码加入现有的 Gradle / CocoaPods 构建,适合单一团队拥有一切、熟悉 RN 工具链并希望单一构建的场景。选择建议:若 iOS/Android 团队需以普通库依赖形式消费 RN,或 RN 与原生代码分属不同仓库、按独立节奏发布,选隔离式;若一个团队同时拥有原生与 RN 代码、愿意把 React Native 与 Expo 加入原生项目的 Gradle 与 CocoaPods、并希望热重载与 JS source map 在既有原生构建流程中无缝工作,选集成式。

使用方式:技能包含参考文档,包括 brownfield-isolated.md(构建 RN 为 AAR/XCFramework 并从原生应用消费)、brownfield-integrated.md(直接将 RN 与 Expo 加入现有 Gradle 与 CocoaPods 构建)、comparison.md(决策标准与权衡)以及 troubleshooting.md(Metro 连接、构建、签名与模块解析问题)。共同前置条件为:构建 React Native 一侧的环境需 Node.js(LTS)与 Yarn;集成式在 iOS 上还需 CocoaPods(sudo gem install cocoapods),隔离式则不要求消费方原生应用安装 CocoaPods 或任何 RN 工具。创建 Expo 项目时需显式固定 SDK:npx create-expo-app@latest my-project --template default@sdk-55。

限制:Expo SDK 55 是 brownfield 集成的最低支持版本,更早的 SDK 缺少 expo-brownfield、所需的 ExpoReactHostFactory / ExpoReactNativeFactory 入口点以及当前自动链接接口;RN 项目与嵌入式依赖需固定相同的 Expo SDK。仅当任务明确匹配其上游产品或 API 范围时使用本技能;在做出变更前,应依据当前官方文档核实命令、API 行为、定价、配额、凭据与部署影响;不要将生成的示例当作环境特定测试、安全审查或对破坏性、高成本操作的审批的替代。更多信息见 https://docs.expo.dev/brownfield/overview/。产品名称、URL 与命令保持原样。