博客更新日志 GitHub 简中文档

在 EAS 上创建开发构建

编辑页面

了解如何为项目创建开发构建。

当你使用 npx create-expo-app 创建一个新的 Expo 应用时，起初你会得到一个项目：你在本地机器上更新 JavaScript 代码，并在 Expo Go 应用中查看这些更改。开发构建本质上就是你自己的 Expo Go 版本，你可以自由使用任何原生库并更改任何原生配置。在本指南中，你将学习如何将运行在 Expo Go 上的项目转换为开发构建，这将使你应用的原生部分变得完全可定制。

如何创建开发构建

如何创建开发构建

使用 EAS Build 为你的 Expo 项目配置并创建开发构建。

前提条件

本说明默认你已经有一个现有的、可在 Expo Go 上运行的 Expo 项目。

构建原生应用的要求取决于你使用的平台、你要构建的目标平台，以及你是想在 EAS 上构建还是在本地机器上构建。

在 EAS 上构建

这是构建原生应用最简单的方式，因为你本地不需要任何原生构建工具。构建会在 EAS 服务器上完成，因此也可以从非 macOS 平台触发 iOS 构建。

	Android	iOS Simulator	iPhone device
macOS			(*)
Windows			(*)
Linux			(*)

(*) 所有在 iPhone 设备上运行的构建都需要一个付费的 Apple Developer 账户来进行构建签名。

使用 EAS CLI 在本地构建

任何 EAS CLI 命令都可以使用 --local 标志在本地机器上构建。这要求你的本地开发环境已配置好原生构建工具。阅读更多关于本地应用开发的内容。

	Android	iOS Simulator	iPhone device
macOS			(*)
Windows	(**)
Linux

(*) 所有在 iPhone 设备上运行的构建都需要一个付费的 Apple Developer 账户来进行构建签名。

(**) 没有一流支持，但可以通过 WSL 实现。

不使用 EAS 在本地构建

不使用 EAS 在本地构建要求你的本地开发环境已配置好原生构建工具。这是在没有付费 Apple Developer 账户的情况下，在 iPhone 设备上测试 iOS 构建的唯一方法（仅可在 macOS 上实现）。阅读更多关于本地应用编译的内容，并查看从 Expo Go 到开发构建指南。

	Android	iOS Simulator	iPhone device
macOS
Windows
Linux

开始使用

如需详细的分步说明，请参阅我们的 EAS 教程。也可以在 YouTube 上观看教程系列。

1

安装 expo-dev-client

Terminal

- npx expo install expo-dev-client

你是否在现有（裸）React Native 应用中使用这个库？

未使用连续原生生成或通过 npx react-native 创建的应用，在安装此库后还需要进一步配置。请参阅在现有 React Native 应用中安装 expo-dev-client 的第 1 和第 2 步。

2

构建原生应用（Android）

Prerequisites

3 requirements

1.

Expo account

注册一个 Expo 账户，如果你还没有的话。

2.

EAS CLI

已安装并登录 EAS CLI。

Terminal

- npm install -g eas-cli && eas login

3.

An Android Emulator (optional)

如果你想在模拟器上测试应用， Android Emulator 是可选的。

Terminal

- eas build --platform android --profile development

阅读更多关于 EAS 上的 Android 构建。

2

构建原生应用（iOS Simulator）

Prerequisites

3 requirements

1.

Expo account

注册一个 Expo 账户，如果你还没有的话。

2.

EAS CLI

已安装并登录 EAS CLI。

Terminal

- npm install -g eas-cli && eas login

3.

macOS with iOS Simulator installed

iOS 模拟器仅在 macOS 上可用。请确保你已安装 iOS Simulator。

编辑 eas.json 中的 development 配置文件，并将 simulator 选项设为 true（如果你还想为此项目创建 iOS 设备构建，则必须为模拟器构建创建单独的配置文件）。

eas.json

{
  "build": {
    "development": {
      "ios": {
        "simulator": true
      }
    }
  }
}

Terminal

- eas build --platform ios --profile development

iOS Simulator 构建只能安装在模拟器上，不能安装在真实设备上。

阅读更多关于 EAS 上的 iOS Simulator 构建。

2

构建原生应用（iOS device）

Prerequisites

3 requirements

1.

Expo account

注册一个 Expo 账户，如果你还没有的话。

2.

EAS CLI

已安装并登录 EAS CLI。

Terminal

- npm install -g eas-cli && eas login

3.

Apple Developer account

需要一个付费的 Apple Developer 账户来创建签名凭据，以便应用可以安装到 iOS 设备上。

Terminal

- eas build --platform ios --profile development

iOS 设备构建只能安装在 iPhone 设备上，不能安装在 iOS 模拟器上。

阅读更多关于 EAS 上的 iOS 设备构建。

3

安装应用

你需要将原生应用安装到你的设备、模拟器或仿真器上。

在 EAS 上构建时

如果你在 EAS 上创建开发构建，构建完成后 CLI 会提示你安装应用。你也可以从 expo.dev 控制台或使用 Expo Orbit 安装之前的构建。

使用 EAS CLI 在本地构建时

在本地构建时，构建输出将是一个归档文件。你可以将其拖放到 Android Emulator/iOS Simulator 上进行安装，或者使用 Expo Orbit 从本地机器安装构建。

4

启动打包器

在第 2 步中构建的开发客户端就是你应用的原生部分（基本上是你自己的 Expo Go 版本）。为了继续开发，你还需要启动 JavaScript 打包器。

根据你构建应用的方式，它可能已经在运行，但如果你因某种原因关闭了该进程，也无需重新构建开发客户端。只需使用以下命令重新启动 JavaScript 打包器：

Terminal

- npx expo start

这和你在 Expo Go 中会使用的命令相同。它会检测你的项目是否安装了 expo-dev-client，如果安装了，就会默认将目标指向你的开发构建，而不是 Expo Go。

视频教程

"EAS 教程系列"

YouTube 上的一门课程：学习如何使用 Expo Application Services 加快你的开发速度。

"Async Office Hours: 如何使用 EAS Build 制作开发构建"

通过由 Developer Success Engineer Keith Kurak 主持的视频教程，学习如何使用 EAS Build 制作开发构建。