This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.
采用 Prebuild
编辑页面
了解如何在使用 React Native CLI 引导的项目中采用 Expo Prebuild。
使用 Expo Prebuild 来持续生成原生项目有许多优点。本指南将向你展示如何在一个通过 npx @react-native-community/cli@latest init 引导创建的项目中采用 Expo Prebuild。转换项目所需的时间取决于你对 Android 和 iOS 原生项目所做的自定义原生修改数量。对于一个全新的项目，这可能只需要一两分钟；而对于大型项目，则会更久。
采用 prebuild 会通过原生链接 expo-modules-core，自动添加对使用 Expo 原生模块 API 开发模块的支持。你也可以在项目中使用 Expo CLI 的任何命令。
并非所有版本的react-native都明确受支持。请确保使用与对应 Expo SDK 版本相匹配的react-native版本。
安装 expo 包
expo 包包含 npx expo prebuild 命令，并指定要使用的 prebuild 模板：
- npm install expo请确保安装的 expo 版本与你当前已安装的 react-native 版本兼容。
更新入口文件
将入口文件修改为使用 registerRootComponent 而不是 AppRegistry.registerComponent：
| 1 | import {AppRegistry} from 'react-native'; | |
| 2 | import {name as appName} from './app.json'; | |
| 1 | import {registerRootComponent} from 'expo'; | |
| 3 | 2 | import App from './App'; |
| 4 | ||
| 5 | AppRegistry.registerComponent(appName, () => App); | |
| 3 | registerRootComponent(App); |
进一步了解
registerRootComponent。
预构建
请确保你已经提交了更改，以防你想回滚，命令也会对此发出警告！
如果你正在迁移一个已有项目，那么你可能会希望先查看迁移原生自定义内容。
运行以下命令，根据应用配置（app.json/app.config.js）重新生成 android 和 ios 目录：
- npx expo prebuild --clean你可以通过在本地构建项目来测试是否一切正常：
# 构建你的原生 Android 项目- npx expo run:android# 构建你的原生 iOS 项目- npx expo run:ios进一步了解编译原生应用。
额外更改
以下更改是可选的，但建议进行。
.gitignore
你可以将 .expo 添加到你的 .gitignore 中，以防止 Expo CLI 生成的值被提交。这些值在你的本地电脑上对你的项目是唯一的。
当你创建新项目时，android 和 ios 目录会自动添加到 .gitignore 中，以确保它们不会在 prebuild 之间被提交。
app.json
移除顶层 expo 对象之外的所有字段，因为这些字段在 npx expo prebuild 中不会被使用。
metro.config.js
参见自定义 Metro。
package.json
你可能希望将脚本改为使用 Expo CLI 的运行命令：
这些命令具有更好的日志记录、自动代码签名、更好的模拟器处理，并且它们会确保你运行 npx expo start 来提供文件服务。
迁移原生自定义内容
如果你的项目有任何原生修改（对 android 或 ios 目录的更改，例如应用图标配置或启动页），那么你需要配置应用配置（app.json）以反映这些原生更改。
- 检查你的更改是否与内置的应用配置字段重叠。例如，如果你有应用图标，请务必在 app.json 中将其定义为
expo.icon，然后重新运行npx expo prebuild。 - 了解你使用的任何软件包是否需要 Expo 配置插件。如果项目中的某个软件包需要在 android 或 ios 目录中进行额外更改，那么你可能需要配置插件。运行
npx expo install并传入 package.json 依赖项中的所有软件包，可以自动添加某些插件。如果某个软件包需要插件但没有提供，你可以尝试查看expo/config-plugins中的社区插件，确认是否已有可用插件。 - 你可以使用 VS Code Expo 扩展检查你的更改，并调试预构建是否生成了你所期望的原生代码。只需按下 Cmd ⌘ + Shift + P，输入“Expo：预览修改器”，然后选择你希望检查的原生文件。
- 此外，你还可以开发本地配置插件来满足自己的需求。请参阅如何开发配置插件。
添加更多功能
Prebuild 只是自动化的冰山一角，下面是一些你接下来可以采用的功能：
- EAS Build：代码签名和云端构建。
- EAS Update：立即发送空中更新。
- 适用于 Web 的 Expo：在浏览器中运行你的应用。
- Expo Dev Client：围绕你的原生运行时创建你自己的个人“Expo Go”类型应用。
- Expo 原生模块 API：使用 Swift 和 Kotlin 编写模块。使用
npx expo prebuild时会自动支持。