为 Android 模拟器和设备构建 APK

了解在使用 EAS Build 时如何为 Android 模拟器和设备配置并安装 .apk。

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

使用 EAS Build 构建 Android 应用时，默认的文件格式是 Android App Bundle（AAB/.aab）。这种格式针对发布到 Google Play Store 进行了优化。不过，AAB 不能直接安装到你的设备上。若要直接将构建安装到你的 Android 设备或模拟器上，你需要改为构建 Android Package（APK/.apk）。

配置用于构建 APK 的配置文件

要生成 .apk，请通过在构建配置文件中添加以下属性之一来修改 eas.json：

• 将 developmentClient 设为 true（默认）
• 将 distribution 设为 internal
• 将 android.buildType 设为 apk
• 将 android.gradleCommand 设为 :app:assembleRelease、:app:assembleDebug、:app:assembleDebugOptimized（适用于 SDK 54 及更高版本），或者任何其他会生成 .apk 的 Gradle 命令

{
  "build": {
    "preview": {
      "android": {
        "buildType": "apk"
      }
    },
    "preview2": {
      "android": {
        "gradleCommand": ":app:assembleRelease"
      }
    },
    "preview3": {
      "developmentClient": true
    },
    "preview4": {
      "distribution": "internal"
    },
    "production": {}
  }
}

现在你可以使用以下命令运行构建：

请记住，你可以将配置文件命名为任何你喜欢的名字。我们将该配置文件命名为 preview。不过，你也可以把它叫做 local、emulator，或者任何对你来说更有意义的名字。

安装你的构建

模拟器（虚拟设备）

如果你之前还没有安装或运行过 Android 模拟器，请在继续之前先查看 Android Studio 模拟器指南。

构建完成后，CLI 会提示你自动下载并将其安装到 Android 模拟器上。在提示时，按 Y 即可直接安装到模拟器上。

如果你有多个构建，也可以随时运行 eas build:run 命令来下载某个特定构建，并自动将其安装到 Android 模拟器上：

该命令还会显示项目中可用构建的列表。你可以从该列表中选择要安装到模拟器上的构建。列表中的每个构建都包含构建 ID、距离构建创建已过去的时间、构建编号、版本号以及 git 提交信息。如果项目中存在无效构建，列表也会将其显示出来。

例如，下图列出了某个项目的构建：

当构建安装完成后，它会出现在主屏幕上。如果它是开发构建，请打开一个终端窗口并运行命令 npx expo start 来启动开发服务器。

运行最新构建

向 eas build:run 命令传入 --latest 标志，即可下载并安装 Android 模拟器上的最新构建：

物理设备

直接下载到设备

• 构建完成后，请从构建详情页面或 eas build 完成时提供的链接复制 APK 的 URL。
• 将该 URL 发送到你的设备。也许通过电子邮件？由你决定。
• 在设备上打开该 URL，安装 APK 并运行它。

使用 adb 安装

• 如果你还没有安装 adb，请先 安装 adb。
• 将设备连接到电脑，并在尚未开启的情况下 在设备上启用 adb 调试。
• 构建完成后，从构建详情页面或 eas build 完成时提供的链接下载 APK。
• 运行 adb install path/to/the/file.apk。
• 在你的设备上运行应用。