了解创建 EAS 构建的 Apple 开发者账户成员资格要求。
需要 Apple Developer 账户才能在 EAS 上创建 iOS 设备版本。此账户允许你生成 应用签名凭据(例如证书、标识符和配置文件),提交应用以供审核,并管理应用的分发。
¥An Apple Developer account is required to create iOS device builds on EAS. This account allows you to generate app signing credentials such as certificates, identifiers, and profiles, submit the app for review, and manage app's distribution.
Apple Developer 用户配置文件必须在其 App Store Connect 用户权限中启用对证书、标识符和配置文件的访问权限才能生成应用签名凭据。如果 Apple Developer 账户是个人账户,则只有该账户的授权用户才能拥有此访问权限。对于组织 Apple 开发者账户,多个团队成员可以拥有此访问权限,但某些组织可能会选择将此访问权限限制为某些团队成员。
¥An Apple Developer user profile must have Access to Certificates, Identifiers, and Profiles enabled in their App Store Connect user permissions to generate app signing credentials. If the Apple Developer account is an individual account, only the authorized user of the account can have this access. For an organization Apple Developer account, multiple team members can have this access, but some organizations may choose to limit this access to certain team members.
本指南提供了具有证书、标识符和配置文件访问权限的授权用户可以遵循的步骤,以确保生成应用签名凭据并供使用 EAS 的团队成员使用。它还为团队开发者提供了使用预生成的凭据创建 EAS Build 的步骤。
¥This guide provides steps that an authorized user with Access to Certificates, Identifiers, and Profiles can follow to ensure app signing credentials are generated and available to their team members who use EAS. It also provides steps for the team developer to create an EAS Build by using pre-generated credentials.
有关基于开发者账户类型和每个角色所需权限的不同角色及其权限的详细信息,请参阅 Apple 关于程序角色的文档。
¥See Apple's documentation on Program Roles for details on the different roles and their permissions based on the type of Developer account and the permissions that are required for each role.
¥Steps for Apple Developer account's authorized user
Apple 开发者账户的授权用户需要生成以下凭据:
¥The authorized user of the Apple Developer account needs to generate the following credentials:
分发签名证书:需要签署安装在 iOS 设备上的开发和发布版本。
¥Distribution signing certificate: Required to sign development and release builds that are installed on an iOS device.
临时配置文件:需要签署安装在 Apple App Store 之外的设备上的内部版本。
¥Ad hoc provisioning profile: Required to sign builds that are installed on a device outside of the Apple App Store.
分发配置文件:需要签署提交给 Apple App Store 的版本。
¥Distribution provisioning profile: Required to sign the build that is submitted to the Apple App Store.
按键:使用推送通知服务时需要。
¥Push key: Required when using a push notification service.
有关分发证书、配置文件和推送密钥的详细信息,请参阅 路由参数。
¥For details on Distribution certificate, Provision profiles, and Push keys, see required iOS app credentials.
使用 EAS CLI,可以创建上述所有凭据并将其自动与 Apple 开发者账户同步。授权用户登录到他们的 Expo 账户 后,他们可以通过使用 EAS CLI 运行 eas credentials
来创建或更新配置文件。
¥With EAS CLI, all of the above credentials can be created and synced automatically with the Apple Developer account. Once the authorized user logs in to their Expo account, they can create or update the provisioning profile by running eas credentials
using the EAS CLI.
-
eas login
-
eas credentials
CLI 将提示选择用于 EAS 构建的 建立档案。如果 Apple Developer 账户的授权用户正在创建生产版本,请按照以下步骤操作 创建分发配置文件。要创建开发者版本,请按照以下步骤操作 创建临时配置文件。
¥The CLI will prompt for selecting a build profile to use for the EAS Build. If the Apple Developer account's authorized user is creating a production build, follow these steps to create a distribution provisioning profile. To create a developer build, follow these steps to create an ad hoc provisioning profile.
这可确保与 Expo 账户关联的配置文件具有必要的权限。
¥This ensures that the provisioning profile associated with the Expo account has necessary permissions.
对于具有现有凭据的项目,请参阅 使用现有凭据 了解如何将这些凭据同步到 EAS 或手动管理它们的详细信息。
¥For projects with existing credentials, see Using existing credentials for details on how to sync these to EAS or manage them manually.
¥Steps for the team developer
作为团队中的开发者,在终端窗口中运行 eas build -p ios
时,EAS CLI 会要求你登录 Apple 开发者账户。
¥As a developer on the team, when running eas build -p ios
in the terminal window, the EAS CLI asks you to login to an Apple Developer account.
? Do you want to log in to your Apple account? > (Y/n)
No problem! 👌 If any of the next steps will require Apple account access we will ask you again about it.
如果你无权访问,请按 n 跳过登录 Apple 开发者账户(并避免登录你的个人 Apple 开发者账户,如果有)。CLI 显示有关跳过配置文件验证和其他应用签名凭据验证的消息,并将继续使用现有凭据创建 EAS 构建
¥Press n to skip logging into Apple Developer account if you don't have access (and avoid logging into your personal Apple Developer account, if any). The CLI displays message about skipping provisioning profile validation and other app signing credential validation and will continue creating the EAS Build with existing credentials
EAS CLI 需要使用与 Expo 账户关联的配置文件来为 iOS 创建构建。当你跳过登录时,EAS Build 将使用你组织的 Expo 账户中 Apple Developer 账户的授权用户更新的最后一个配置文件和其他凭据。
¥The EAS CLI needs to use the provisioning profile associated with the Expo account to create a build for iOS. When you skip login, the EAS Build will use the last provisioning profile and other credentials that were updated by the Apple Developer account's authorized user in your organization's Expo account.
¥Additional information
¥Uploading pre-generated Apple credentials
一些开发团队可能会选择在 EAS 之外生成分发证书和配置文件。任何具有开发者或更高权限的 EAS 用户都可以使用 eas credentials
或使用 Expo 仪表板在项目设置下的凭据中添加这些凭据。
¥Some development teams may choose to generate distribution certificates and provisioning profiles outside of EAS. These credentials can be added by any EAS user with Developer or higher permissions using eas credentials
or in Credentials under Project settings using the Expo dashboard.
上传凭据时,你将需要 .p12 和 .mobileprovision 文件,以及生成分发证书时设置的任何密码。
¥When uploading the credentials, you will need the .p12 and .mobileprovision files, and any passwords set when generating the distribution certificate.
¥Provisioning profile expiry and updates
如果添加或删除某些 iOS 功能(例如,权利),或者在配置文件每年到期时,需要更新关联的配置文件。此步骤由 Apple 开发者账户的授权用户处理。
¥The associated provisioning profile needs to be updated if certain iOS capabilities (such as, entitlements) are added or removed, or at the annual expiry of the profile. This step is handled by the Apple Developer account's authorized user.
¥Federated Apple Developer accounts
¥EAS Build
EAS CLI 只能接受 Apple 账户的电子邮件和密码来登录你的 Apple 开发者账户。你无法登录 联合 Apple 开发者账户 并更新分发证书或配置文件。如果你的构建凭据不需要任何更改,则可以跳过登录。然后,你可以继续构建,EAS CLI 将继续使用你当前上传的凭据。
¥EAS CLI can only accept an Apple account's email and password to login into your Apple Developer account. You cannot login into Federated Apple Developer account and make updates to the distribution certificate or provisioning profile. If your build credentials do not require any changes, you can skip logging in. Then, you can proceed with the build and EAS CLI will continue using your current uploaded credentials.
但是,你可以提供具有管理员访问权限的 Apple Store Connect (ASC) API 令牌,以便在运行 eas build
命令时检查和更新 Apple 凭据。按照 为你的 Apple 团队提供 ASC API 令牌 中的步骤通过将所需的令牌值传递给 eas build
命令来创建构建。
¥However, you can provide an Apple Store Connect (ASC) API token with Admin access to check and update Apple credentials when running eas build
command. Follow the steps in Provide an ASC API Token for your Apple Team to create a build by passing the required token value to the eas build
command.
¥EAS Submit
EAS Submit 使用 ASC API 令牌提交给 TestFlight。如果你拥有联合 Apple 开发者账户,则可以按照标准 EAS Submit 设置进行操作。它允许你使用 eas build --auto-submit
自动提交构建。
¥EAS Submit uses the ASC API token for submitting to TestFlight. If you have a Federated Apple Developer account, you can follow the standard EAS Submit setup. It lets you automatically submit your builds using eas build --auto-submit
.