创建并运行 Android 的云端构建

编辑页面

了解如何使用 EAS Build 为 Android 设备和模拟器配置开发构建。


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

在本章中,我们将创建一个可以使用 EAS Build 在 Android 上运行的开发构建。

在 Android 设备或模拟器上创建并运行构建的过程是相同的,不同之处仅在于开发构建的安装方式。

观看:如何为 Android 创建并运行云构建
观看:如何为 Android 创建并运行云构建

了解如何使用 EAS Build 创建 Android 开发构建并将其安装到设备或模拟器上。


为开发配置文件创建构建

对于 Android,开发构建必须是 .apk 格式。虽然默认的 Android 格式是 .aab,它非常适合 Google Play Store 分发,但它不能安装到设备或模拟器上。

要创建 .apk

  • eas.json 中,确保在 build.development 配置文件下将 developmentClient 设置为 true

  • 然后,使用 android 作为平台、development 作为构建配置文件运行 eas build 命令:

    Terminal
    eas build --platform android --profile development
    提示:下次运行 eas build 命令时,你也可以使用 -p 来指定平台。它是 --platform 的简写。

此命令会提示我们回答以下问题:

  • 你希望 Android 应用程序 id 是什么?return 接受此提示提供的默认值。这将会在 app.json 中添加 android.package
  • 生成新的 Android Keystore?按 Y

在作出回应后,构建将进入队列,我们可以通过 EAS CLI 提供的链接在 EAS 仪表板中跟踪其进度:

构建详情页面包含哪些信息?

构建详情页面显示构建类型、配置文件、Expo SDK 版本、应用版本、版本代码、最后一次提交的哈希,以及发起构建的开发者或账户所有者身份。

在上面的图片中,Build artifact 的当前状态显示构建正在进行中。完成后,此部分将提供下载构建的选项。Logs 概述了在 EAS Build 上进行 Android 构建过程中执行的每一步。为简明起见,这里我们不会逐步展开。要了解更多信息,请参阅 Android build process

什么是 Android application ID?

它也被称为我们 Android 应用的包名,以 DNS 反向表示法格式(com.owner.appname)存储。该表示法的每个部分都应以小写字母开头。

例如,我们的示例应用使用 com.owner.stickersmash,其中 com.owner 是域名,而 stickersmash 是我们的应用名称。

Android 设备

1

安装开发构建

构建完成后,Build artifact 部分会更新,表示构建已完成:

此部分提供了在 Android 设备上运行开发构建的方法:Expo Orbit 和安装按钮。

Expo Orbit 允许在 Android 设备上无缝安装开发构建。要使用此方法:

  • 使用 USB 将我们的 Android 设备连接到本地机器。
  • 打开 Orbit 菜单栏应用。
  • 在 Orbit 应用中选择 Device
  • 在 EAS 仪表板中,在 Build artifact 下点击 Open with Orbit

构建安装完成后,Orbit 应用会在设备上启动该开发构建。

替代方案:使用 Install 按钮和二维码

Build artifact 中的 Install 按钮会生成用于安装的二维码:

  • 点击 Install 显示包含二维码的弹窗。
  • 使用我们 Android 设备的相机扫描二维码,以在默认网页浏览器中打开构建链接。
  • 点击网页上的 Install 按钮下载 .apk 文件。
  • 下载完成后,打开 .apk 开始安装过程。
  • 如果出现 Unsafe app blocked message,请选择 Install anyway。这个警告可以安全忽略,因为 .apk 的来源(即我们生成的文件)是可信的。

2

运行开发构建

在项目目录中运行 npx expo start 来启动开发服务器。服务器运行后,在终端窗口中按 a 打开项目:

Terminal
npx expo start

Android 模拟器

1

安装开发构建

在终端中,构建完成后,EAS CLI 会询问我们是否要在 Android 模拟器上运行该构建。按 Y

替代方案:使用 Expo Orbit

另外,也可以使用 Expo Orbit 进行安装。在 EAS 仪表板的 Build artifact 中,点击 Open with Expo Orbit,即可在 Android 模拟器上安装开发构建。

2

运行开发构建

在项目目录中运行 npx expo start 来启动开发服务器。服务器运行后,在终端窗口中按 a 打开项目:

Terminal
npx expo start

总结

Chapter 2: Create and run a cloud build for Android

我们成功使用 EAS Build 在 Android 设备和模拟器上创建并运行了开发构建, 并了解了 .apk.aab 文件格式。

在下一章中,了解如何使用 EAS Build 为 iOS 模拟器配置开发构建并使其运行。

Next: 创建并运行 iOS 模拟器的云构建