This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

在现有 React Native 项目中安装 expo-dev-client

编辑页面

了解如何在现有 React Native 项目中安装并配置 expo-dev-client。


以下指南说明如何在现有 React Native 项目中安装和配置 expo-dev-client。

你需要创建一个新项目吗?

如果你是从一个新项目开始,请使用 with-dev-client 模板创建它:

Terminal
- npx create-expo-app -e with-dev-client
- yarn create expo-app -e with-dev-client
- pnpm create expo-app -e with-dev-client
- bun create expo -e with-dev-client
你的项目中使用 Continuous Native Generation (CNG) 吗?

要在使用 CNG 的项目中使用 expo-dev-client,请参阅创建开发构建。

Prerequisites

1 requirement

安装并配置 expo 包

如果你使用 npx @react-native-community/cli@latest init 创建了项目,并且没有安装任何其他 Expo 库,那么在继续之前,你需要先安装 Expo 模块。

1

安装 expo-dev-client

将 expo-dev-client 库添加到你的 package.json 中:

Terminal
- npx expo install expo-dev-client
- yarn expo install expo-dev-client
- pnpm expo install expo-dev-client
- bun expo install expo-dev-client

如果你的项目磁盘上有一个 ios 目录,请运行以下命令以完全安装 expo-dev-client 的原生代码:

Terminal
- npx pod-install
- yarn dlx pod-install
- pnpm dlx pod-install
- bunx pod-install

如果你的项目没有 ios 目录,则可以跳过这一步。

2

配置深度链接

Expo CLI 使用深度链接来启动你的项目;如果你计划在项目中添加自定义深度链接 scheme 后,使用 expo-dev-client 启动预览更新,这也会很有用。

如果你还没有为应用配置用于支持深度链接的 scheme,那么可以使用 uri-scheme 库来帮你完成。

Terminal
# 列出你项目中的 scheme
- npx uri-scheme list

# 向你的项目添加一个 scheme
- npx uri-scheme add your-scheme
# 列出你项目中的 scheme
- yarn dlx uri-scheme list

# 向你的项目添加一个 scheme
- yarn dlx uri-scheme add your-scheme
# 列出你项目中的 scheme
- pnpm dlx uri-scheme list

# 向你的项目添加一个 scheme
- pnpm dlx uri-scheme add your-scheme
# 列出你项目中的 scheme
- bunx uri-scheme list

# 向你的项目添加一个 scheme
- bunx uri-scheme add your-scheme

有关更多信息,请参阅 uri-scheme 库。

3

构建并安装应用

使用你选择的工具创建应用的调试构建。例如,你可以使用 Expo CLI 在本地完成,也可以使用 EAS Build 在云端完成。