跳到主要内容

第一次构建

了解你在 Macrunara 上的第一次构建,以及底层发生了什么。

构建生命周期​

当你推送代码 / 提交 PR 触发 GitHub Actions 工作流时,会发生以下完整过程:

1. 排队与分配​

你的构建任务进入调度队列,调度器依据节点分配标签,结合以下条件分配 M4 运行节点:

  • 任务定义的硬件规格(M4 arm64)
  • 配置里填写的机房区域是否可用
  • 当前集群队列负载情况
Status: Queued
Wait time: ~12 seconds

2. 环境准备​

分配到空闲 M4 运行节点后,节点开始准备编译构建环境:

  1. 节点初始化:完成 M4 arm64 运行环境初始化
  2. Xcode 设置:启用集群内可用的开发编译工具版本
  3. 克隆仓库:拉取项目完整代码
  4. 平台前置处理:完成身份合法性校验,读取任务里设置的机房区域、最大运行时长等配置,生成运行过程信息供页面展示
  5. 依赖缓存加载:加载项目构建依赖,首次构建实时拉取,任务结束同步至集群缓存供后续复用

3. 步骤执行​

按照工作流配置文件内步骤顺序依次执行:

steps:
- name: Checkout # 1. 拉取项目代码
- name: Macrunara Setup # 2. 身份校验、读取配置、输出运行信息
- name: Install Deps # 3. 安装项目依赖
- name: Build # 4. Xcode 编译项目
- name: Test # 5. 执行单元测试
- name: Upload Artifacts # 6. 上传构建产物

4. 产物收集​

构建业务步骤全部执行完毕后,运行节点完成平台侧信息回传工作:

  1. 采集本次构建全程产生的控制台输出日志。
  2. 识别任务最终运行结果:成功、失败、超时、取消。
  3. 将日志内容与任务运行结果回传,展示到操作页面。

5. 清理​

单次构建结束,运行节点执行环境清理:

  • 内存中密钥信息安全擦除
  • 构建产生的临时文件删除
  • 本次构建会话环境销毁,等待接收下一个 CI 任务

构建状态​

状态描述需要的操作
Queued等待分配 M4 运行节点无,等待调度
Running节点正在执行构建步骤查看 GitHub Actions 日志
Success全部步骤执行通过无,查看产物与测试报告
Failed至少一个步骤执行失败查看日志定位报错
Canceled工作流被取消(手动、API 或平台触发)无
Timed Out超出任务设置的最大运行时长优化构建,调大最大运行时长参数

阅读构建日志​

构建日志带有步骤前缀结构化输出,在 GitHub Actions 工作流详情页查看:

[00:02:15] [Checkout] Cloning repository...
[00:02:18] [Macrunara-Setup] 身份校验完成,机房区域:auto,最大运行时长:30
[00:02:18] [Install] Running 'pod install'...
[00:02:45] [Install] Dependencies installed
[00:02:45] [Build] Starting xcodebuild...
[00:06:12] [Build] Build succeeded
[00:06:12] [Test] Running XCTest...
[00:08:45] [Test] All tests passed

首次构建常见问题​

问题:Xcode 版本不匹配​

现象:构建时报找不到编译工具、接口语法报错。

解决方案:确认集群已提供的工具版本,在工作流中选用集群支持的 Xcode 版本。

问题:身份校验不通过,任务无法进入节点​

现象:任务一直排队,直接报错终止,无法分配运行节点。

解决方案:检查 GitHub 应用相关权限配置,确认仓库授权、访问权限已完整开启。

下一步​

完成第一次构建后,可以继续探索: