从 Expo Go 切换到开发构建

安装 expo-dev-client

🌐 Install the expo-dev-client

Expo Dev Client 库包括启动器界面（如下面截图所示）、开发者菜单、用于测试 OTA 更新的扩展以及更多功能。Expo Go 应用内置了开发者菜单，因此在开发构建中你需要单独安装它。

🌐 The Expo Dev Client library includes the launcher UI (shown in the screenshots below), dev menu, extensions to test over-the-air updates, and more. The Expo Go app has the dev menu built in, and that's why you need to install it separately for a development build.

我们建议使用 expo-dev-client 来获得最佳的开发体验，但也可以在不安装此库的情况下使用开发版本。如果不使用开发客户端，请在步骤 3中使用 --dev-client 启动打包器。否则，它将默认在 Expo Go 中打开。

构建你的原生应用

🌐 Build your native app

使用 Expo Go 时，你只需要构建 JavaScript 包，但使用开发构建时，你还需要编译原生应用。使用 Expo，构建原生应用有两个部分：

🌐 With Expo Go, you only needed to build the JavaScript bundle, but with development builds you also need to compile the native app. With Expo, there are two parts to building your native app:

1. 生成本地 android 和/或 ios 目录（了解更多 何时以及如何需要执行此操作）
2. 使用本地构建工具来编译本地应用

一旦你构建了本地应用，除非你添加或更新包含本地代码的库，或者更改任何本地代码或配置（例如应用名称），否则不需要再次构建它。

🌐 Once you've built your native app, you won't need to build it again unless you add or update a library with native code, or change any native code or configuration, such as the app name.

当你创建一个新项目时，android 和 ios 目录会自动添加到 .gitignore 文件中，因此它们不会被提交到 Git。这确保了你可以在本地或使用 CNG 在 CI 上随时重新生成代码，而无需手动编辑原生代码。

选项 1：在本地计算机上构建

🌐 Option 1: Build on your local machine

要在本地计算机上构建原生应用，请按照 Android 和 iOS 平台的环境设置指南进行操作。这涉及设置和配置原生构建工具，例如 Android 的 Android Studio 和 iOS 的 Xcode。

🌐 To build a native app on your local machine, follow the setup your environment guides for Android and iOS platforms. This involves setting up and configuring native build tools like Android Studio for Android and Xcode for iOS.

一旦你完成所有设置，运行以下命令：

🌐 Once you have everything set up, run the following command:

默认情况下，这将会在 Android 模拟器或 iOS 模拟器上构建并安装应用。如果你需要在手机上运行构建，请将其连接到电脑（在 Android 上，如果出现提示，请选择信任该设备并允许 USB 调试；在 iOS 上，启用开发者模式），然后使用 --device 标志运行上述命令。

🌐 By default, this will build and install the app on an Android Emulator/iOS Simulator. If you need to run the build on your phone, plug it into your computer (on Android, select trust device and allow USB debugging if prompted, and on iOS, enable developer mode) and run the above commands with the --device flag.

选项 2：基于 EAS 构建

🌐 Option 2: Build on EAS

在以下情况下使用 EAS 服务器进行构建是有用的：

🌐 Building on EAS servers is useful when:

• 你不能或不想设置本地开发环境
• 你想开发一款 iOS 应用，但没有 Mac 电脑
• 你想要与团队分享开发版本

启动打包器

🌐 Start the bundler

在本地构建后，npx expo run:android|ios 会自动启动打包工具。但如果你关闭了打包工具，或者正在使用之前构建的开发客户端，请使用以下命令（重新）启动 Metro 打包工具：

🌐 After building locally, npx expo run:android|ios will start the bundler automatically. But if you closed the bundler or are working on a dev client you built earlier, (re)start the Metro bundler with:

当你的项目安装了 expo-dev-client 时，打包工具会显示 使用开发版本，并且它显示的二维码将链接到你创建的开发版本，而不是 Expo Go。

🌐 When your project has expo-dev-client installed, the bundler will print out Using development build, and the QR code it shows will link into the development build you created instead of Expo Go.