本地构建：概览

概述如何使用自己的电脑在本地为 Expo 项目构建应用。

你可以利用本地开发环境，通过使用 Android Studio 和 Xcode 在本地构建你的应用。这个构建过程可以用于调试版和发布版。本页概述了使用你自己的设备本地构建应用的不同方法，并提供了在此工作流程中可能需要的其他指南的参考。

🌐 You can leverage your local development environment to build your app locally by utilizing Android Studio and Xcode. This build process can be done for both debug and release builds. This page provides an overview on different ways to build your app locally using your own machine and references to other guides that might be necessary in this workflow.

何时在本地构建你的应用

🌐 When to build your app locally

在你的开发机器上构建应用时，会有不同的情况：

🌐 There are different scenarios when you want to build your app on your developer machine:

• 你希望快速迭代原生代码更改或在调试构建中测试特定平台的更改
• 你想手动生成本地代码来测试你的调试版本
• 任何需要在网络访问受限的环境中创建构建的情景。
• 你希望在本地管理自己的凭据（例如上传密钥等）
• 你想测试或集成你自己的自定义构建缓存提供程序
• 你想选择不使用 Android 的预构建 Expo 模块，而是从源代码本地编译它们一次

注意：在本地构建应用可以补充 EAS Build 的使用。你可以继续使用云端构建服务进行自动化，同时在开发过程中使用本地构建作为备用。

先决条件

🌐 Prerequisites

你需要安装并设置 Android Studio 和 Xcode，以便在本地计算机上编译和运行 Android 和 iOS 项目。请参阅以下指南了解如何设置这些工具：

🌐 You need to install and set up Android Studio and Xcode to compile and run Android and iOS projects on your local machine. See the following guides on how to set up these tools:

• Android Studio
• Xcode

在本地创建调试版本

🌐 Creating your debug build locally

为了快速构建和迭代调试版本，你可以使用 Expo CLI 的 npx expo run:[android|ios] 命令。这些命令会编译你的项目，使用你本地安装的 Android SDK 或 Xcode，将其打包成应用的调试版本。

🌐 To quickly build and iterate on a debug build, you can use Expo CLI's npx expo run:[android|ios] commands. These commands compile your project, using your locally installed Android SDK or Xcode, into a debug build of your app.

在本地创建发布版本

🌐 Creating your release build locally

要创建应用的发布版本（也称为生产版本），你可以利用 Android Studio 和 Xcode 提供的工具来生成签名凭证。然后，你可以生成发布版本，并按照手动提交应用到 Google Play 商店或 Apple App Store 的流程进行操作。

🌐 To create a release build (also known as production build) of your app, you generate signing credentials by utilizing tools provided by Android Studio and Xcode. Then, you can generate a release build and follow the process of manually submitting your app to Google Play Store or Apple App Store.

重用来自提供者的先前构建

🌐 Reuse previous builds from a provider

你可以通过缓存和重用来自提供商的构建来加速本地开发。你可以使用 EAS 作为构建提供商，也可以创建自己的自定义提供商。

🌐 You can accelerate your local development by caching and reusing builds from a provider. You can use EAS as a build provider or create your own custom provider.

Android 预置 Expo 模块

🌐 Prebuilt Expo Modules for Android

SDK 53及更高版本随附为Android预构建的Expo模块，这些模块可以减少Gradle在每次构建时的工作量。你可以继续使用默认设置，或者在需要修改模块源码时选择性地退出。

🌐 SDK 53 and later ship with prebuilt Expo Modules for Android that reduce the work Gradle performs on each build. You can continue using the defaults or selectively opt out when you need to modify a module's source code.