采用 Prebuild
编辑页面
了解如何在使用 React Native CLI 引导的项目中采用 Expo Prebuild。
For the complete documentation index, see llms.txt. Use this file to discover all available pages.
使用 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。
Prebuild
请确保你已经提交了更改，以防你想回滚，命令也会对此发出警告！
如果你正在迁移一个已有项目，那么你可能会希望先查看迁移原生自定义内容。
运行以下命令，根据应用配置（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 扩展 来检查你的更改，并在 prebuild 生成的原生代码符合预期时进行调试。只需按 Cmd ⌘ + Shift + P，输入“Expo: Preview Modifier”，然后选择你想检查的原生文件。
- 此外，你还可以开发本地配置插件以满足你的需求。了解更多。
添加更多功能
Prebuild 只是自动化的冰山一角，下面是一些你接下来可以采用的功能：
- EAS Build：代码签名和云端构建。
- EAS Update：立即发送空中更新。
- 适用于 Web 的 Expo：在浏览器中运行你的应用。
- Expo Dev Client：围绕你的原生运行时创建你自己的个人“Expo Go”类型应用。
- Expo 原生模块 API：使用 Swift 和 Kotlin 编写模块。使用
npx expo prebuild时会自动支持。