内部分发

配置构建配置文件

¥Configure a build profile

在你的项目中打开 eas.json。你可以使用适用于 Android 或 iOS 的预配置 preview 配置文件或 创建一个新的。

¥Open eas.json in your project. You can use the pre-configured preview profile or create a new one for Android or iOS.

{
  "build": {
    "preview": {
      "distribution": "internal"
    }
  }
}

安卓

¥Android

请注意，如果你在 Android 上覆盖 gradleCommand，则应确保它生成 .apk 而不是 .aab，以便它可以直接安装到 Android 设备。

¥Note that if you override the gradleCommand on Android, you should ensure that it produces an .apk rather than an .aab, so it is directly installable to an Android device.

iOS 系统

¥iOS

上面的配置告诉 EAS Build 你想要使用临时分发，该分发适用于所有付费 Apple 开发者账户。它不适用于免费账户。

¥The configuration above tells EAS Build that you would like to use ad hoc distribution, which is available for all paid Apple Developer accounts. It is not available for free accounts.

{
  "build": {
    "preview": {
      "distribution": "internal",
      "ios": {
        "enterpriseProvisioning": "universal"
      }
    }
  }
}

配置应用签名

¥Configure app signing

设置临时配置

¥Setting up ad hoc provisioning

使用临时配置文件签名的应用可以由唯一标识符 (UDID) 在配置文件中注册的任何 iOS 设备安装。

¥Apps signed with an ad hoc provisioning profile can be installed by any iOS device whose unique identifier (UDID) is registered with the provisioning profile.

设置临时配置包括两个步骤。第一步，你将注册你希望能够安装应用的设备。运行以下命令生成可在设备上打开的 URL（以及 QR 码，为了方便起见），然后按照注册页面上的说明进行操作。

¥Setting up ad hoc provisioning consists of two steps. In the first step, you'll register devices that you want to be able to install your app. Run the following command to generate a URL (and QR code, for convenience) that you can open on your devices, and then follow the instructions on the registration page.

你可以随时注册新设备，但在注册设备之前创建的版本将不会在新注册的设备上运行；只有在设备注册后创建的版本才可以安装。

¥You can register new devices at any time, but builds that were created before the device was registered will not run on newly registered devices; only builds that are created after the device is registered will be installable.

下一步是生成或更新配置文件。当你继续运行构建时，系统将引导你完成此过程。

¥The next step is to generate or update the provisioning profile. When you proceed to run a build, you will be guided through this process.

使用内部构建配置文件运行构建

¥Run a build with the internal build profile

现在我们已经设置了构建配置文件和应用签名，运行内部分发的构建就像任何其他构建一样。

¥Now that we have set up our build profile and app signing, running a build for internal distribution is just like any other build.

如果你使用临时配置但尚未注册任何设备，系统会要求你立即注册它们（或退出当前命令并再次运行 eas device:create）。构建命令将等待新设备注册。扫描终端中显示的二维码，然后按照该页面上的说明注册你的设备。完成后，返回终端并继续。

¥If you're using ad hoc provisioning but you haven't registered any devices yet, you'll be asked to register them now (or exit the current command and run eas device:create again). The build command will wait for the new device to register. Scan the QR code that is presented in the terminal and follow the instructions on that page to register your device. When you're done, return to the terminal and continue.

构建完成后，你将获得一个 URL，你可以与团队共享该 URL 以下载并安装该应用。

¥When the build completes, you will be given a URL that you can share with your team to download and install the app.

安装并运行构建

¥Install and run the build

按构建页面上的 "安装" 按钮，然后按照模式中显示的说明进行操作。

¥Press the "Install" button on the build page and follow the instructions presented in the modal.

如果你运行的是 iOS 16 或更高版本并且尚未打开开发者模式，则需要 启用它 才能运行构建。如果你使用的是企业配置，则这不适用。

¥If you're running iOS 16 or above and haven't yet turned on Developer Mode, you will need to enable it before you can run your build. This doesn't apply if you're using enterprise provisioning.

CI 自动化（可选）

¥Automation on CI (optional)

可以使用 --non-interactive 标志在 CI 中以非交互方式运行内部分发版本；但是，如果你在 iOS 上使用临时配置，则在使用此标志时将无法将新设备添加到你的配置配置文件中。通过 eas device:create 注册设备后，你需要交互运行 eas build 并向 Apple 进行身份验证以进行 EAS，以将设备添加到你的配置文件中。了解有关从 CI 触发构建的更多信息。

¥It's possible to run internal distribution builds non-interactively in CI using the --non-interactive flag; however, if you are using ad hoc provisioning on iOS you will not be able to add new devices to your provisioning profile when using this flag. After registering a device through eas device:create, you need to run eas build interactively and authenticate with Apple for EAS to add the device to your provisioning profile. Learn more about triggering builds from CI.