本地构建：概述

使用自己的机器为 Expo 项目在本地构建应用的概述。

For the complete documentation index, see llms.txt. Use this Use this file to discover all available pages.

你可以利用本地开发环境，通过 Android Studio 和 Xcode 在本地构建你的应用。这个构建过程既适用于调试构建，也适用于发布构建。本页面概述了使用你自己的机器在本地构建应用的不同方式，并提供了此工作流程中可能需要的其他指南链接。

何时在本地构建你的应用

在开发者机器上构建应用有不同的场景：

• 你希望在原生代码变更上快速迭代，或在调试构建中测试特定平台的更改
• 你希望手动生成原生代码以测试调试构建
• 任何需要在网络访问受限的环境中创建构建的场景
• 你希望在本地管理自己的凭据（例如上传密钥等）
• 你希望测试或集成你自己的自定义构建缓存提供者
• 你希望对 Android 的预构建 Expo 模块选择不使用默认方案，并仅在本地从源代码编译一次

注意：本地构建应用是对 EAS Build 的补充。你可以继续使用该构建服务进行云端自动化，同时在开发时回退到本地构建。

前提条件

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

• Android Studio
• Xcode

在本地创建调试构建

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

在本地创建发布构建

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

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

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

Android 的预构建 Expo 模块

Expo 提供了 Android 的预构建 Expo 模块，以减少 Gradle 在每次构建时执行的工作量。你可以继续使用默认设置，或者在需要修改某个模块的源代码时有选择地退出。