在 Apple Silicon Mac 上用 Jenkins + Fastlane 搭建 iOS CI:从自动打包到 MR 检查流水线的完整实践

在 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(私有仓库)

一、目标与总体架构

目标:

  1. develop 分支有 push 后 1 分钟内自动打包(ipa 自动落到指定目录)
  2. 功能分支提 MR 合并前,自动跑 SwiftLint + 编译验证,绿灯才允许合并

最终架构(无公网回调,全靠轮询):

markdown 复制代码
feature/* 分支 push ──▶ Jenkins 多分支流水线(每分钟扫描)
                            │ 自动为每个 feature/* 分支生成独立 job
                            ▼
                 SwiftLint 检查 → pod install → 模拟器编译验证
                 (不出 ipa、不碰签名证书,约 1 分钟)
                            │
                 提 MR 前看分支 job 绿灯,绿灯才合并
                            │ 合并
                            ▼
              develop 打包流水线(pollSCM 每分钟轮询)→ Fastlane 出包
                            ▼
                 ipa 自动复制到项目目录 / 归档 dSYM

二、依赖安装(几个大坑都在这)

2.1 JDK:jenkins-lts 依赖的是 21,不是 17

bash 复制代码
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 的包安装直接报错。验证方法:

bash 复制代码
/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 安装:

bash 复制代码
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_identifier
  • fastlane/Fastfile:beta lane(打包)/ release lane(上架,先注释掉)
  • fastlane/.env.example:环境变量说明

beta lane 核心逻辑:

ruby 复制代码
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:

bash 复制代码
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)。解决:

bash 复制代码
ssh-add --apple-use-keychain ~/.ssh/id_ed25519

五、Jenkins 安装与启动

5.1 插件依赖缺失的手动修复

新装 Jenkins 首次启动批量装插件时,网络超时会导致一堆「根因插件」失败(commons-lang3-api、snakeyaml-api、branch-api、git-client、font-awesome-api 等),页面只显示下游插件失败。可靠修复方式是离线补装:

bash 复制代码
# 华为云镜像按 <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 更可控:

xml 复制代码
<!-- ~/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>
bash 复制代码
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:

groovy 复制代码
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:

bash 复制代码
# 手动触发构建
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 和运行时都注册正常。

排查路径(值得复用的方法论):

  1. 脚本控制台确认触发器已注册、任务未禁用
  2. 反射看 Trigger 的静态 java.util.Timer ------ 调度队列 size = 0,即任务从未排入
  3. 反编译 Jenkins core(war 包里抽出 Trigger.class,javap -c)发现新版本 start() 只做字段赋值不排任务;真正的调度驱动是 Trigger$Cron(一个 60 秒周期的 PeriodicWork 扩展点)
  4. 手动 new CronTab 对比各 spec 的解析结果,实锤:
ini 复制代码
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:
groovy 复制代码
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 时:

  1. 新版 git 插件不再接受 XML 里的 <includes>/<excludes> 字段 (静默丢弃),分支过滤必须用 trait:WildcardSCMHeadFilterTrait(在 scm-api 插件,包名 jenkins.scm.impl.trait,不在 git 插件)
  2. PeriodicFolderTrigger(定期扫描)类在 cloudbees-folder 插件,包名 com.cloudbees.hudson.plugins.folder.computed(很容易误写成 jenkins.branch),spec 支持 1min 格式
  3. POST config.xml 报 500 且难以定位时,改用脚本控制台编程式配置更稳:
groovy 复制代码
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()
  1. 首次扫描手动触发: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 蒲公英上传

  1. 蒲公英后台 → 应用详情 → API 获取 api_key(和 user_key)
  2. 安装 fastlane 插件:
bash 复制代码
fastlane add_plugin pgyer
  1. Fastfile 里把「跳过逻辑」改成真实上传:
ruby 复制代码
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
  1. Jenkins 侧不把 key 写进代码:在 Jenkins 凭据里存 PGYER_API_KEY(Secret text),Jenkinsfile 里用 withCredentials 注入:
groovy 复制代码
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'
        }
    }
}
  1. 注意:development 包要装到真机,需把测试设备的 UDID 提前加进开发者账号的设备列表,Jenkins 构建时 -allowProvisioningUpdates 会自动带上设备重新生成描述文件。

12.2 TestFlight 上传

前置条件:付费开发者账号 + App Store Connect 里建好 App。

  1. 在 App Store Connect → 用户和访问 → 集成 → App Store Connect API 创建 API 密钥,拿到 Key ID、Issuer ID,下载 .p8 私钥
  2. 凭据管理(CI 推荐 base64 存内容,避免管文件路径):
bash 复制代码
base64 -i AuthKey_XXXXXX.p8 | pbcopy

在 Jenkins 存三个 Secret text:ASC_KEY_ID、ASC_ISSUER_ID、ASC_P8_BASE64

  1. Fastfile 增加 release lane:
ruby 复制代码
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
  1. Jenkinsfile 对应加一个「上传 TestFlight」stage(复用同一批 withCredentials,另加三个 ASC 凭据)
  2. 常见坑:
    • 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 架构

scss 复制代码
Gitee (push / MR 事件)
   │ Webhook (https 回调,云端有公网,不再需要轮询)
   ▼
云端 Jenkins (Linux, 公网可达)          ← 控制面:任务配置/队列/页面/凭据
   │ ▲
   │ │ JNLP: Mac agent 主动长连云端(Mac 无需公网 IP)
   ▼ │
本地 Mac agent (label: mac-build)      ← 执行面:Xcode/fastlane/证书都在这

13.2 云端装 Jenkins

  1. 买一台入门 Linux 云服务器(1C2G 起够用,调度不吃资源),安全组/防火墙放行 8080(页面)和 50000(agent 入站)
  2. 装 JDK 21 + Jenkins LTS:
bash 复制代码
# 以 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
  1. 建议前面挂 nginx 反代 + 域名 + HTTPS(Webhook 需要 https 或 http 均可,https 更规范):
nginx 复制代码
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 直连即可
  1. 插件与国内镜像:插件更新源可换成国内镜像(系统管理 → 插件 → 高级 → 升级站点 URL),失败插件同样可用华为云镜像 hpi 离线补装。

13.3 Mac 配置 inbound agent

  1. 云端 Jenkins 页面:系统管理 → 节点管理 → New Node → 名字如 mac-build,类型 permanent,Remote root directory 填 ~/jenkins-agent,Labels 填 mac-build,用法「只执行指派到此节点的任务」
  2. 保存后页面给出两样东西:agent.jar 下载地址和一段 -secret 命令
  3. Mac 侧把 agent 跑成 launchd 服务(开机自启 + 崩溃自拉,和本机 Jenkins 同款待遇):
xml 复制代码
<!-- ~/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>
bash 复制代码
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(替代轮询)

  1. 云端 Jenkins 装 Gitee 插件,系统管理 → Gitee 配置:填「Gitee 域名 gitee.com + 私人令牌」测试连通
  2. 任务里把触发器改为 Gitee Webhook 触发(打包任务勾 push 事件、PR-Check 勾 MR 事件)
  3. 页面会显示形如 https://jenkins.yourdomain.com/gitee-project/<jobName> 的 Webhook URL
  4. Gitee 仓库 → 管理 → WebHooks → 添加该 URL,密码可选,勾选 Push、Merge Request 事件
  5. 从此:
    • push develop → 秒级触发打包(替代 * * * * * 轮询)
    • 提 MR → 秒级触发 PR-Check,并可用 Gitee API 回写评论(此时连 MR 状态都能自动回填)

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 的直接扩展,代码结构无需重写。

相关推荐
Nayana9 分钟前
《Web 到 HarmonyOS》-- 打包:Vite 产物 → HAP / HAR / HSP
前端
inksci16 分钟前
用飞帆做了个小网页
前端·javascript·css·html
去伪存真19 分钟前
被 pnpm 打包坑惨后,我彻底盘明白了硬链接与软链接
前端·electron
zhensherlock1 小时前
Protocol Launcher 系列:CodeHub 移动端 GitHub 协作利器
前端·javascript·typescript·node.js·自动化·github·js
tryCbest6 小时前
Vue3——第 22 篇:Pinia——新一代状态管理(上)
前端·javascript·vue.js
bai2736 小时前
"👨‍👩‍👧‍👦" 的 length 是 11:我把自己写的字数统计脚本拖出来审了一遍
前端·javascript
zhanlang02178 小时前
HTML 零基础入门到企业实战【第八章 8.5】画布 canvas、SVG 矢量图形基础入门
前端·html
星云_byto9 小时前
CSS面试题
前端·css
zhanlang02179 小时前
HTML 零基础入门到企业实战全套教程【连载 8.4】HTML5 新增表单属性与表单控件
前端·html·html5