深入解析：[无需 Mac] 使用 GitHub Actions 构建 iOS 应用

推荐超级课程：

介绍

GitHub Actions 是 GitHub 上用于自动化工作流程的功能。
在本文中，我们将向您展示如何在没有 Mac 的情况下使用 GitHub Actions 构建 iOS 应用。

要上传到 App Store Connect，您需要注册 Apple 开发者计划。

1.准备存储库

首先，准备好你的 iOS 应用仓库。
本文假设你的应用目录结构如下：

.
├── .github
│   └── workflows
│       └── build.yml
├── MyApp
│   ├── MyApp.xcodeproj
│   └── ...
└── ...

2.配置 GitHub Actions

在存储库根目录中.github/workflows/build.yml创建一个目录，其中包含以下内容：

构建文件

name: Build
on:
push
jobs:
build:
name: Build
runs-on: macos-latest
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Archive Project
run: |
xcodebuild archive -project MyApp/MyApp.xcodeproj \
-scheme MainApp \
-sdk iphoneos \
-configuration Release \
-archivePath MainApp.xcarchive \
CODE_SIGNING_ALLOWED=NO
- name: Create ExportOptions.plist
run: |
echo '${{ secrets.EXPORT_OPTIONS }}' > ExportOptions.plist
- name: Create Private Key
run: |
mkdir private_keys
echo -n '${{ secrets.APPLE_API_KEY_BASE64 }}' | base64 --decode > ./private_keys/AuthKey_${{ secrets.APPLE_API_ISSUER_ID }}.p8
- name: Export IPA
run: |
xcodebuild -exportArchive \
-archivePath MainApp.xcarchive \
-exportOptionsPlist ExportOptions.plist \
-exportPath app.ipa \
-allowProvisioningUpdates \
-authenticationKeyPath `pwd`/private_keys/AuthKey_${{ secrets.APPLE_API_ISSUER_ID }}.p8 \
-authenticationKeyID ${{ secrets.APPLE_API_KEY_ID }} \
-authenticationKeyIssuerID ${{ secrets.APPLE_API_ISSUER_ID }}
- name: Upload IPA to App Store Connect
run: |
xcrun altool --upload-app -f app.ipa/MainApp.ipa \
-u ${{ secrets.APPLE_ID }} \
-p ${{ secrets.APP_SPECIFIC_PASSWORD }} \
--type ios

在此设置中，xcodebuild我们使用命令来构建我们的 iOS 应用程序，并xcrun altool使用命令将其上传到 App Store Connect。

要点如下：

  • Xcode 项目路径MyApp/MyApp.xcodeproj和方案名称MainApp均为默认设置。请根据需要进行更改。
  • 在您的 Xcode 项目中启用自动签名。
  • xcodebuild build，xcodebuild archive当CODE_SIGNING_ALLOWED=NO您指定使签名无效时。
  • 私钥路径在内部隐式引用，不应更改。
  • -allowProvisioningUpdates因为您指定了，所以您不需要配置文件，
    并且您不需要每年更新配置文件。

3. 设置密钥密码

在 GitHub 存储库设置屏幕上，在“存储库机密”中设置以下机密。
有关详细的设置说明，请参阅GitHub 文档。

  • EXPORT_OPTIONS``ExportOptions.plist内容：
  • APPLE_API_KEY_BASE64：App Store Connect API 密钥的 Base64 编码内容
  • APPLE_API_ISSUER_ID：App Store Connect API 发行者 ID
  • APPLE_API_KEY_ID：App Store Connect API 密钥 ID
  • APPLE_ID：Apple ID
  • APP_SPECIFIC_PASSWORD：Apple ID 应用密码

ExportOptions.plist创建

EXPORT_OPTIONS以下是它的内容。您可以从
YOUR_TEAM_IDApple Developer Program Membership中查看。

method
app-store
teamID
YOUR_TEAM_ID

创建 App Store Connect API 密钥

您可以通过 App Store Connect API 创建App Store Connect API密钥。
您可以使用任意名称，但Admin需要拥有 App Store Connect API 的访问权限。
有关如何颁发密钥的详细说明，请参阅Apple 的文档。

APPLE_API_KEY_BASE64是密钥内容。
请注意，该内容只能下载一次。请对其
进行Base64编码并设置为机密。

如何进行Base64编码

您可以使用以下命令将其以 Base64 进行编码：

Windows（PowerShell）

[Convert]::ToBase64String([System.IO.File]::ReadAllBytes("AuthKey_YOUR_ISSUER_ID.p8"))

Linux / macOS

base64 -i AuthKey_YOUR_ISSUER_ID.p8

APPLE_API_ISSUER_ID是密钥的颁发者 ID，
所有密钥的颁发者 ID 都是相同的。

APPLE_API_KEY_ID是您的密钥 ID。它也是
下载的密钥文件名AuthKey_后面的字符串。

设置应用密码

APPLE_ID是您的 Apple ID（电子邮件地址）。
请设置您注册 Apple Developer Program 时使用的 Apple ID。

APP_SPECIFIC_PASSWORD是根据您 Apple ID 的应用专用密码创建的。
有关如何设置的更多信息，请参阅Apple 的文档。

4.执行

您现在可以出发了。

当您推送到 GitHub 时，GitHub Actions 将自动执行。
如果构建成功，该应用将上传至 App Store Connect。
您可以在 App Store Connect 中创建内部测试版本，无需审核。
不妨在您的 iPhone 上测试一下！

当出错时

如果您的工作流程失败，请检查以下内容：

  • Xcode 项目路径和方案名称是否正确？
    xcodebuild -list -project MyApp/MyApp.xcodeproj您可以检查方案名称。
  • 您的 Xcode 项目中是否启用了自动签名？
  • 密钥密码都设定好了吗？
  • APPLE_API_KEY_BASE64它是Base64编码的吗？
  • App Store Connect API 密钥权限是否正确？
  • 您可以检查MainApp.ipa目录中是否已创建app.ipa 。
    根据项目的不同，它的名称可能会有所不同。
    ls -l app.ipa

>

posted @ 2025-08-08 17:43  yjbjingcha  阅读(15)  评论(0)    收藏  举报