在 Apple Silicon Mac 上用 Jenkins + Fastlane 搭建 iOS CI:从自动打包到 MR 检查流水线的完整实践
记录一次完整的 iOS CI 搭建过程:本机 Jenkins + Fastlane 实现 push 后自动打包,多分支流水线实现功能分支 SwiftLint 检查,过程中踩了包括
pollSCM('H/1')语义陷阱、brew bottle 损坏、插件依赖缺失等大量坑。全部方案无需公网服务器,纯轮询驱动,适合个人/小团队参考。环境:Apple Silicon Mac(macOS 26/27)、Xcode 27、CocoaPods 工程、代码托管在 Gitee(私有仓库)
一、目标与总体架构
目标:
develop分支有 push 后 1 分钟内自动打包(ipa 自动落到指定目录)- 功能分支提 MR 合并前,自动跑 SwiftLint + 编译验证,绿灯才允许合并
最终架构(无公网回调,全靠轮询):
feature/* 分支 push ──▶ Jenkins 多分支流水线(每分钟扫描)
│ 自动为每个 feature/* 分支生成独立 job
▼
SwiftLint 检查 → pod install → 模拟器编译验证
(不出 ipa、不碰签名证书,约 1 分钟)
│
提 MR 前看分支 job 绿灯,绿灯才合并
│ 合并
▼
develop 打包流水线(pollSCM 每分钟轮询)→ Fastlane 出包
▼
ipa 自动复制到项目目录 / 归档 dSYM
二、依赖安装(几个大坑都在这)
2.1 JDK:jenkins-lts 依赖的是 21,不是 17
brew install openjdk@21 jenkins-lts
新版 Jenkins LTS 要求 JDK 21,不用单独装 17。openjdk@21 是 keg-only,记得把 JAVA_HOME 写入 shell 配置。
2.2 macOS 26.x 上 brew bottle 全部解包失败
Homebrew 7 的 bottle 解包依赖 sandbox-exec,macOS 26.x 上它已失效,表现为所有带 bottle 的包安装直接报错。验证方法:
/usr/bin/sandbox-exec -p '(version 1)(allow default)' echo
# 无输出 = 中招
升级系统后自愈。临时规避可以走 pkg 安装器(如 brew install --cask temurin@21)。
2.3 brew 的 fastlane bottle 本身是坏的
brew 装出来的 fastlane 缺 digest-crc、bigdecimal 等 gem,ruby 的 rbs 扩展也没编译。逐个补 gem 因为 GEM_PATH 问题很难救回来,直接放弃 brew fastlane,改用 gem 安装:
brew uninstall fastlane
/opt/homebrew/opt/ruby/bin/gem install fastlane
# binstub 在 /opt/homebrew/lib/ruby/gems/4.0.0/bin/,全部软链到 /opt/homebrew/bin/
ln -sf /opt/homebrew/lib/ruby/gems/4.0.0/bin/* /opt/homebrew/bin/
注意:软链必须把整个 bin 目录链过去(fastlane 依赖 xcpretty 等一堆 binstub),只链 fastlane 一个会在 Jenkins 里报 xcpretty: command not found(Exit 127)。
三、Fastlane 出包配置
3.1 手动建脚手架(跳过 fastlane init 交互)
CI 环境建议手写三个文件:
fastlane/Appfile:app_identifierfastlane/Fastfile:beta lane(打包)/ release lane(上架,先注释掉)fastlane/.env.example:环境变量说明
beta lane 核心逻辑:
lane :beta do
cocoapods
increment_build_number(build_number: Time.now.strftime("%Y%m%d%H%M"))
gym(
scheme: "YourScheme",
export_method: "development",
output_directory: "./build/buildIpa",
xcargs: "DEVELOPMENT_TEAM=YOUR_TEAM_ID -allowProvisioningUpdates"
)
# 蒲公英分发:API key 为空则跳过
if ENV["PGYER_API_KEY"].to_s.empty?
UI.important "未配置 PGYER_API_KEY,跳过分发"
else
pgyer(api_key: ENV["PGYER_API_KEY"])
end
end
3.2 个人免费账号签名
Xcode 登录个人 Apple 账号后钥匙串会有开发证书。从证书提取 Team ID:
security find-certificate -a -p login.keychain-db | openssl x509 -noout -subject
# OU 字段即 Team ID
然后把工程里所有 CODE_SIGN_STYLE = Automatic 处补上 DEVELOPMENT_TEAM(sed 批量改 project.pbxproj),gym 侧再用 xcargs 注入一次 + -allowProvisioningUpdates,让 Jenkins 构建时自动生成/更新描述文件。
个人免费账号的包 7 天有效期,仅适合真机调试验证,不能替代 TestFlight。
3.3 Jenkins 里解锁钥匙串
Jenkins 跑在后台会话,访问不到登录会话的钥匙串。两种做法:
- 把 Mac 登录密码存成 Jenkins 凭据(Secret text),打包前
security unlock-keychain -p "$KEYCHAIN_PASSWORD" ~/Library/Keychains/login.keychain-db - 或做一个专用打包钥匙串(更规范)
四、Gitee SSH 认证的隐坑
Jenkins 拉代码用「SSH Username with private key」凭据(username 填 git,私钥内容 + passphrase 一起填),不受本机 ssh-agent 影响。
本机 push 的坑:新版 OpenSSH 私钥文件里没有 ENCRYPTED 头,grep 检测不出 passphrase,但 ssh 非交互时认证会失败(ssh -v 显示 Server accepts key 却仍然 Permission denied)。解决:
ssh-add --apple-use-keychain ~/.ssh/id_ed25519
五、Jenkins 安装与启动
5.1 插件依赖缺失的手动修复
新装 Jenkins 首次启动批量装插件时,网络超时会导致一堆「根因插件」失败(commons-lang3-api、snakeyaml-api、branch-api、git-client、font-awesome-api 等),页面只显示下游插件失败。可靠修复方式是离线补装:
# 华为云镜像按 <name>/<version>/<name>.hpi 直接下载
curl -LO https://mirrors.huaweicloud.com/jenkins/plugins/<plugin>/<ver>/<plugin>.hpi
mv <plugin>.hpi ~/.jenkins/plugins/
launchctl kickstart -k gui/$(id -u)/sh.brew.jenkins-lts # 重启生效
5.2 绕开 brew services,手写 launchd plist
brew services stop 会删 plist、restart 会重新生成 plist 抹掉手改项,且默认 stdout 进 /dev/null(排查问题时日志全丢)。手写一份完整 plist 更可控:
<!-- ~/Library/LaunchAgents/sh.brew.jenkins-lts.plist -->
<plist version="1.0">
<dict>
<key>Label</key><string>sh.brew.jenkins-lts</string>
<key>ProgramArguments</key>
<array>
<string>/opt/homebrew/opt/openjdk@21/bin/java</string>
<string>-jar</string><string>/opt/homebrew/opt/jenkins-lts/libexec/jenkins.war</string>
<string>--httpListenAddress=127.0.0.1</string>
<string>--httpPort=8080</string>
</array>
<key>RunAtLoad</key><true/>
<key>KeepAlive</key><true/>
<key>StandardOutPath</key><string>/opt/homebrew/var/log/jenkins-lts.log</string>
<key>StandardErrorPath</key><string>/opt/homebrew/var/log/jenkins-lts.log</string>
</dict>
</plist>
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/sh.brew.jenkins-lts.plist
KeepAlive 保证崩溃自拉、RunAtLoad 保证开机登录后自启(注意 FileVault 开启时重启需人工登录一次)。
六、打包流水线(Pipeline script from SCM)
Jenkinsfile 放仓库根目录,Jenkins 任务选「Pipeline script from SCM」,分支 */develop:
pipeline {
agent any
environment {
PATH = "/opt/homebrew/bin:...:$PATH"
DEVELOPER_DIR = "/Applications/Xcode.app/Contents/Developer"
HOME = "/Users/yourname"
}
options { timestamps(); disableConcurrentBuilds() }
triggers {
// 每分钟轮询,push 后最多 1 分钟自动构建(见第八章的坑!)
pollSCM('* * * * *')
}
stages {
stage('拉取代码') { steps { checkout([...GitSCM...]) } }
stage('打包分发') {
steps {
withCredentials([string(credentialsId: 'KEYCHAIN_PASSWORD',
variable: 'KEYCHAIN_PASSWORD')]) {
sh 'fastlane beta'
}
}
}
stage('复制到项目目录') { steps { sh 'cp build/buildIpa/*.ipa "$DEST"/' } }
stage('归档产物') { steps { archiveArtifacts artifacts: 'build/buildIpa/*.ipa, ...' } }
}
}
经验点:
disableConcurrentBuilds防止轮询密集时并发打包cleanWs排除 ipa 的 pattern,避免打包产物被工作区清理误删- 路径环境变量必须显式写(launchd 会话的 PATH 和终端不同)
七、REST API 触发与诊断
创建 admin API Token(头像 → Security → API Token)之后,很多事不用登 UI:
# 手动触发构建
curl -X POST -u "admin:$TOKEN" "http://127.0.0.1:8080/job/YourJob/build"
# 读任务状态
curl -u "admin:$TOKEN" "http://127.0.0.1:8080/job/YourJob/6/api/json?tree=building,result"
# 脚本控制台(诊断神器,能看运行时状态)
curl -u "admin:$TOKEN" --data-urlencode "script=$GROOVY" http://127.0.0.1:8080/scriptText
八、pollSCM('H/1 * * * *') 是每小时一次,不是每分钟(核心坑)
现象:把轮询从 H/5 改成 H/1 想实现每分钟轮询,结果彻底静默——不报错、重启无效、轮询日志停更、主日志干净、触发器在 config.xml 和运行时都注册正常。
排查路径(值得复用的方法论):
- 脚本控制台确认触发器已注册、任务未禁用
- 反射看
Trigger的静态java.util.Timer—— 调度队列 size = 0,即任务从未排入 - 反编译 Jenkins core(war 包里抽出
Trigger.class,javap -c)发现新版本start()只做字段赋值不排任务;真正的调度驱动是Trigger$Cron(一个 60 秒周期的PeriodicWork扩展点) - 手动
new CronTab对比各 spec 的解析结果,实锤:
spec='H/1 * * * *' -> minuteBits popCount=1 (每小时只命中 1 个哈希分钟!)
spec='* * * * *' -> minuteBits popCount=60 (每分钟 ✓)
spec='H/5 * * * *' -> minuteBits popCount=12 (每 5 分钟 ✓)
结论:H/step 会把时间区间按 step 切片后取一个基于 job 名的哈希偏移,H/1 等于「每小时固定在某个分钟跑一次」。表象是"轮询彻底静默",实际只是下次触发在 1 小时后。
正确写法:每分钟轮询必须写 pollSCM('* * * * *')。
九、MR 检查:多分支流水线 + SwiftLint
9.1 组成
- SwiftLint:
brew install swiftlint,仓库根放宽松版.swiftlint.yml(首轮只有 error 拦截构建,风格类全 warning,避免 CI 一上来全红) Jenkinsfile-PRCheck:
stages {
stage('SwiftLint 检查') {
steps {
sh '''
swiftlint --reporter emoji
ERRORS=$(swiftlint lint --quiet | grep -c "error: " || true)
[ "$ERRORS" -gt 0 ] && exit 1
'''
}
}
stage('编译验证') {
steps {
sh '''
pod install --repo-update
xcodebuild -workspace App.xcworkspace \
-scheme App \
-destination 'generic/platform=iOS Simulator' \
-configuration Debug \
build CODE_SIGNING_ALLOWED=NO | xcpretty
'''
}
}
}
- Jenkins 建 WorkflowMultiBranchProject(多分支流水线):
- 分支源:git 仓库 + SSH 凭据
- 每
feature/*分支自动生成独立 job,用分支自己的Jenkinsfile-PRCheck - 分支删除后 job 自动清理(孤儿策略 pruneDeadBranches)
- 分支 job 构建历史
buildDiscarder(numToKeepStr: '10')
9.2 REST 创建多分支任务的坑
用 POST /createItem 直接建 Multibranch 时:
- 新版 git 插件不再接受 XML 里的
<includes>/<excludes>字段(静默丢弃),分支过滤必须用 trait:WildcardSCMHeadFilterTrait(在 scm-api 插件,包名jenkins.scm.impl.trait,不在 git 插件) PeriodicFolderTrigger(定期扫描)类在 cloudbees-folder 插件,包名com.cloudbees.hudson.plugins.folder.computed(很容易误写成jenkins.branch),spec 支持1min格式- POST config.xml 报 500 且难以定位时,改用脚本控制台编程式配置更稳:
import jenkins.scm.impl.trait.WildcardSCMHeadFilterTrait
import com.cloudbees.hudson.plugins.folder.computed.PeriodicFolderTrigger
def proj = Jenkins.instance.getItemByFullName('PlanList-PR-Check')
def src = proj.sources[0].source
src.traits = [ new WildcardSCMHeadFilterTrait('feature/*', 'master develop') ]
proj.addTrigger(new PeriodicFolderTrigger('1min'))
proj.save()
- 首次扫描手动触发:
POST /job/<folder>/indexing
9.3 为什么不用 Webhook 也能跑
真正的 MR 事件触发需要 Gitee Webhook 回调 Jenkins,本机 127.0.0.1 Gitee 访问不到。轮询方案的等价逻辑:「功能分支绿灯」≈「MR 检查通过」——因为 MR 合并的内容就是功能分支的 tip,分支 tip 编译/lint 绿灯即等价。升级路径:以后买云服务器或用 frp 暴露内网后,接上 Gitee Webhook 把扫描触发换成事件触发,Jenkinsfile 无需改动;构建结果回写 MR 评论走 Jenkins 主动调 Gitee API(不需要公网回调,随时可加)。
十、排查工具箱(本次实战总结)
| 场景 | 工具/方法 |
|---|---|
| Jenkins 运行时状态诊断 | 脚本控制台 /scriptText(需 admin API Token),反射看触发器、线程、队列 |
| 「配置在磁盘、没进内存」类问题 | 反编译:war/插件 jar 抽 class → javap -c 看真实逻辑 |
| 触发器解析问题 | new CronTabList(spec, Hash) 在脚本控制台验证解析结果 |
| 插件批量安装失败 | 华为云镜像离线 hpi 补装到 ~/.jenkins/plugins/ |
| 日志丢失 | brew services 换手写 launchd plist,指定 StandardOut/ErrPath |
| 轮询是否在跑 | 看任务目录下 scm-polling.log 的 mtime |
十一、遗留事项与升级建议
- 个人免费签名账号:包 7 天有效,正式分发需要开发者账号 + TestFlight
- 蒲公英分发:Fastfile 已支持,配
PGYER_API_KEY凭据即可启用 - 云端化:本地 Mac 方案的痛点是「必须开机、公网访问难」,规模化后建议「云端 Jenkins 调度 + 本地 Mac 跑 inbound agent」——agent 主动外连云端,天然穿透 NAT,本机 Jenkins 可退役
- Gitee Webhook(MR 事件触发)+ MR 状态回写是下一步的自然演进
十二、构建产物分发:蒲公英(内测)/ TestFlight(正式)
打包流水线出包后,下一步自然是分发。两条路线按账号形态选择:
| 蒲公英 | TestFlight | |
|---|---|---|
| 账号要求 | 无需开发者账号 | 需要 Apple Developer Program(¥688/年) |
| 包类型 | development / ad hoc 包 | App Store 分发包 |
| 测试设备 | 需要把测试机 UDID 加进描述文件 | 不需要,扫码装即可 |
| 有效期 | 随描述文件/证书 | 上传后 90 天 |
| 适用场景 | 小范围真机调试 | 更正式的内测,可外链 |
12.1 蒲公英上传
- 蒲公英后台 → 应用详情 → API 获取
api_key(和user_key) - 安装 fastlane 插件:
fastlane add_plugin pgyer
- Fastfile 里把「跳过逻辑」改成真实上传:
lane :beta do
cocoapods
increment_build_number(build_number: Time.now.strftime("%Y%m%d%H%M"))
gym(
scheme: "YourScheme",
export_method: "development",
output_directory: "./build/buildIpa",
xcargs: "DEVELOPMENT_TEAM=YOUR_TEAM_ID -allowProvisioningUpdates"
)
pgyer(
api_key: ENV["PGYER_API_KEY"],
user_key: ENV["PGYER_USER_KEY"],
update_description: true
)
end
- Jenkins 侧不把 key 写进代码:在 Jenkins 凭据里存
PGYER_API_KEY(Secret text),Jenkinsfile 里用withCredentials注入:
stage('打包分发') {
steps {
withCredentials([
string(credentialsId: 'KEYCHAIN_PASSWORD', variable: 'KEYCHAIN_PASSWORD'),
string(credentialsId: 'PGYER_API_KEY', variable: 'PGYER_API_KEY'),
string(credentialsId: 'PGYER_USER_KEY', variable: 'PGYER_USER_KEY')
]) {
sh 'fastlane beta'
}
}
}
- 注意:development 包要装到真机,需把测试设备的 UDID 提前加进开发者账号的设备列表,Jenkins 构建时
-allowProvisioningUpdates会自动带上设备重新生成描述文件。
12.2 TestFlight 上传
前置条件:付费开发者账号 + App Store Connect 里建好 App。
- 在 App Store Connect → 用户和访问 → 集成 → App Store Connect API 创建 API 密钥,拿到
Key ID、Issuer ID,下载.p8私钥 - 凭据管理(CI 推荐 base64 存内容,避免管文件路径):
base64 -i AuthKey_XXXXXX.p8 | pbcopy
在 Jenkins 存三个 Secret text:ASC_KEY_ID、ASC_ISSUER_ID、ASC_P8_BASE64
- Fastfile 增加 release lane:
lane :release do
app_store_connect_api_key(
key_id: ENV["ASC_KEY_ID"],
issuer_id: ENV["ASC_ISSUER_ID"],
key_content: ENV["ASC_P8_BASE64"],
is_key_content_base64: true
)
setup_ci # CI 环境防交互
cocoapods
increment_build_number(build_number: Time.now.strftime("%Y%m%d%H%M"))
gym(
scheme: "YourScheme",
export_method: "app-store",
output_directory: "./build/buildIpa"
)
pilot(
skip_waiting_for_build_processing: false, # 等处理完,失败可及时感知
distribute_external: false
)
end
- Jenkinsfile 对应加一个「上传 TestFlight」stage(复用同一批 withCredentials,另加三个 ASC 凭据)
- 常见坑:
pilot上传后苹果处理需要 10~30 分钟,skip_waiting_for_build_processing: false时流水线会挂起等待,建议打包和上传分开跑或接受长构建- app-store 包需要分发证书 + App Store 描述文件,个人免费账号签出的 development 包传不上去
- 同一个 build number 重复上传会被拒,时间戳格式的 build number 天然规避
十三、Jenkins 云端化:云端调度 + Mac 做 inbound agent
本地 Mac 方案的两个痛点:必须开机、Gitee Webhook 回调不进来。标准解法不是把构建搬到云上(iOS 构建必须 macOS,云 macOS 贵且违协议风险),而是——
Jenkins 装在云端 Linux 服务器(调度器),Mac 只作为一个「构建节点(agent)」主动连上去(inbound 模式,天然穿透 NAT),本机 Jenkins 退役。
13.1 架构
Gitee (push / MR 事件)
│ Webhook (https 回调,云端有公网,不再需要轮询)
▼
云端 Jenkins (Linux, 公网可达) ← 控制面:任务配置/队列/页面/凭据
│ ▲
│ │ JNLP: Mac agent 主动长连云端(Mac 无需公网 IP)
▼ │
本地 Mac agent (label: mac-build) ← 执行面:Xcode/fastlane/证书都在这
13.2 云端装 Jenkins
- 买一台入门 Linux 云服务器(1C2G 起够用,调度不吃资源),安全组/防火墙放行
8080(页面)和50000(agent 入站) - 装 JDK 21 + Jenkins LTS:
# 以 apt 系为例
sudo apt update && sudo apt install -y openjdk-21-jdk
curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null
echo "deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian-stable binary/" | sudo tee /etc/apt/sources.list.d/jenkins.list
sudo apt install -y jenkins
- 建议前面挂 nginx 反代 + 域名 + HTTPS(Webhook 需要 https 或 http 均可,https 更规范):
server {
listen 443 ssl;
server_name jenkins.yourdomain.com;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
# agent 入站端口 50000 保持 TCP 直连即可
- 插件与国内镜像:插件更新源可换成国内镜像(系统管理 → 插件 → 高级 → 升级站点 URL),失败插件同样可用华为云镜像 hpi 离线补装。
13.3 Mac 配置 inbound agent
- 云端 Jenkins 页面:系统管理 → 节点管理 → New Node → 名字如
mac-build,类型 permanent,Remote root directory 填~/jenkins-agent,Labels 填mac-build,用法「只执行指派到此节点的任务」 - 保存后页面给出两样东西:
agent.jar下载地址和一段-secret命令 - Mac 侧把 agent 跑成 launchd 服务(开机自启 + 崩溃自拉,和本机 Jenkins 同款待遇):
<!-- ~/Library/LaunchAgents/com.yourname.jenkins-agent.plist -->
<plist version="1.0">
<dict>
<key>Label</key><string>com.yourname.jenkins-agent</string>
<key>ProgramArguments</key>
<array>
<string>/opt/homebrew/opt/openjdk@21/bin/java</string>
<string>-jar</string><string>/Users/yourname/jenkins-agent/agent.jar</string>
<string>-url</string><string>https://jenkins.yourdomain.com/</string>
<string>-secret</string><string>AGENT_SECRET_FROM_PAGE</string>
<string>-name</string><string>mac-build</string>
<string>-workDir</string><string>/Users/yourname/jenkins-agent</string>
</array>
<key>RunAtLoad</key><true/>
<key>KeepAlive</key><true/>
<key>StandardOutPath</key><string>/Users/yourname/jenkins-agent/agent.log</string>
<key>StandardErrorPath</key><string>/Users/yourname/jenkins-agent/agent.log</string>
</dict>
</plist>
curl -sO https://jenkins.yourdomain.com/jnlpJars/agent.jar
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.yourname.jenkins-agent.plist
节点页面看到「在线」即成功。inbound 模式下 Mac 在内网/NAT 后都没问题,因为连接是 Mac 主动发起的。
13.4 任务与凭据迁移
- 任务:因为用的是「Pipeline script from SCM」,Jenkinsfile 全在仓库里,云端只需要照配置重建任务(拉代码凭据、KEYCHAIN_PASSWORD、PGYER/ASC 凭据)——这是把流水线全部落在仓库里的最大红利
- 打包流水线:
agent any改成agent { label 'mac-build' }(PR-Check 同理) - 凭据批量迁移:把本机
~/.jenkins/secrets/master.key和~/.jenkins/secrets/jenkins.model.Jenkins.crumbCipher+credentials.xml(连同 secrets 目录)拷到云端对应位置,凭据原样可用 - Mac agent 上的工具链要保持等价:Xcode、CocoaPods、fastlane(gem 方式)、swiftlint、JDK,以及钥匙串/签名环境照旧在 Mac 上,不受 Jenkins 迁移影响
13.5 接上 Gitee Webhook(替代轮询)
- 云端 Jenkins 装 Gitee 插件,系统管理 → Gitee 配置:填「Gitee 域名 gitee.com + 私人令牌」测试连通
- 任务里把触发器改为 Gitee Webhook 触发(打包任务勾 push 事件、PR-Check 勾 MR 事件)
- 页面会显示形如
https://jenkins.yourdomain.com/gitee-project/<jobName>的 Webhook URL - Gitee 仓库 → 管理 → WebHooks → 添加该 URL,密码可选,勾选
Push、Merge Request事件 - 从此:
- push develop → 秒级触发打包(替代
* * * * *轮询) - 提 MR → 秒级触发 PR-Check,并可用 Gitee API 回写评论(此时连 MR 状态都能自动回填)
- push develop → 秒级触发打包(替代
13.6 迁移后的检查清单
- Mac agent 在线,labels 正确
- 打包/PR-Check 任务首轮构建全绿(本机 Jenkins 停掉后 workspace 会重建,首次构建稍慢属正常)
- 钥匙串解锁 stage 正常(凭据随任务迁移)
- Gitee Webhook 推送事件测试连通(Gitee 会显示响应码 200/201)
- 本机 launchd 里的 Jenkins 服务
launchctl bootout卸载退役,只留 agent
以上方案在本机(Apple Silicon Mac + Xcode 27 + Gitee 私有仓库)全流程跑通:push develop 自动打包(#6、#7 双验证)、feature 分支自动 lint + 编译检查(多分支首构建全绿)。蒲公英/TestFlight 分发与云端化改造为同一套 Fastlane/Jenkinsfile 的直接扩展,代码结构无需重写。