跳到主要内容

归档导出 Action

macrunara/local-mac-runner-action 是一个 Composite Action,用于在 Macrunara Mac CI 集群上执行 Xcode 构建,并能从你的归档自动导出 .ipa。

用法​

- uses: macrunara/local-mac-runner-action@v1
with:
scheme: MyApp
project: MyApp.xcodeproj
configuration: Release
sdk: iphoneos
upload_artifact: true
artifact_name: build-products
artifact_path: build/Release-iphoneos

注意:本动作是一个 GitHub Composite Action,不依赖 Docker 或 Node.js 运行时,所有步骤直接在 workflow 的 Runner 上执行。

输入参数​

参数必填默认值说明
scheme是—要构建的 Xcode scheme
project否—Xcode 工程或 workspace 路径
configuration否Release构建配置,例如 Release、Debug
sdk否iphoneosSDK,例如 iphoneos、macosx
upload_artifact否false是否上传产物(true / false)
artifact_name否build-products上传产物的名称
artifact_path否build/Release-iphoneos要上传的产物路径

归档导出的工作方式​

该 action 依次执行以下步骤:

  1. 在日志中展示 action 输入信息。
  2. 调用 xcodebuild,按指定的 scheme、配置与 SDK 构建工程(project 为空时不传 -project 参数)。
  3. 自动归档导出:如果构建目录中存在 .xcarchive,自动执行 xcodebuild -exportArchive(使用 development 方式)生成 .ipa。
  4. 当 upload_artifact 为 true 时,通过 actions/upload-artifact@v4 上传产物。

如果导出失败,action 仅输出 ::warning::,不会中断 workflow。构建目录中没有 .xcarchive 的任务会直接跳过导出步骤并正常结束。

注意事项​

  • 导出使用 development 方式,请确保构建机的签名上下文支持该方式。
  • 脚本通过 bash 加 ${{ github.action_path }} 显式调用(例如 bash "$ACTION_PATH/scripts/build.sh"),不依赖执行位;如需直接执行脚本,请用 git update-index --chmod=+x scripts/*.sh 保留 +x 权限。
  • 引用本 action 请使用 tag(如 @v1),不要直接使用 @main。