1. iOS持續(xù)集成中的證書(shū)管理痛點(diǎn)在iOS應(yīng)用的CI/CD流程中證書(shū)和配置文件的管理一直是開(kāi)發(fā)者最頭疼的問(wèn)題之一。不同于Android開(kāi)發(fā)可以直接使用調(diào)試密鑰蘋果的生態(tài)要求每個(gè)應(yīng)用都必須使用有效的證書(shū)簽名才能安裝到設(shè)備上。這就導(dǎo)致在Jenkins自動(dòng)化構(gòu)建時(shí)經(jīng)常會(huì)遇到以下典型問(wèn)題證書(shū)過(guò)期導(dǎo)致構(gòu)建失敗尤其在每年續(xù)費(fèi)后Provisioning Profile未包含新增設(shè)備的UDID開(kāi)發(fā)證書(shū)與生產(chǎn)證書(shū)混淆使用多Target項(xiàng)目證書(shū)配置沖突我在為多個(gè)團(tuán)隊(duì)搭建iOS持續(xù)集成環(huán)境時(shí)發(fā)現(xiàn)90%的構(gòu)建失敗都與證書(shū)相關(guān)。更麻煩的是這類問(wèn)題往往在開(kāi)發(fā)者本地可以正常構(gòu)建但一到Jenkins服務(wù)器就報(bào)錯(cuò)排查起來(lái)非常耗時(shí)。2. Jenkins中iOS證書(shū)的配置方案2.1 證書(shū)的標(biāo)準(zhǔn)化存儲(chǔ)最佳實(shí)踐是將證書(shū)和配置文件統(tǒng)一存儲(chǔ)在安全但可訪問(wèn)的位置。我推薦兩種方案方案一Jenkins Credentials管理# 將.p12證書(shū)文件添加到Jenkins憑據(jù)系統(tǒng) # 在Pipeline中通過(guò)credentials()函數(shù)調(diào)用 withCredentials([file(credentialsId: IOS_CERT_P12, variable: KEYCHAIN_FILE)]) { sh security import ${KEYCHAIN_FILE} -P ${KEYCHAIN_PASSWORD} -A }方案二加密的版本控制# 使用openssl加密后存入代碼庫(kù) # 構(gòu)建時(shí)解密使用 openssl aes-256-cbc -k $ENCRYPTION_SECRET -in certs/dist.p12.enc -out certs/dist.p12 -d注意無(wú)論哪種方案都要確保Jenkins服務(wù)器上的鑰匙串設(shè)置正確。我遇到過(guò)因?yàn)槟J(rèn)鑰匙串設(shè)置不當(dāng)導(dǎo)致即使導(dǎo)入了證書(shū)也無(wú)法使用的案例。2.2 多環(huán)境證書(shū)自動(dòng)切換對(duì)于需要區(qū)分開(kāi)發(fā)/生產(chǎn)環(huán)境的情況建議使用xcconfig文件管理配置// Development.xcconfig CODE_SIGN_IDENTITY iPhone Developer PROVISIONING_PROFILE_SPECIFIER Development_Profile // Production.xcconfig CODE_SIGN_IDENTITY iPhone Distribution PROVISIONING_PROFILE_SPECIFIER AppStore_Profile在Jenkinsfile中根據(jù)構(gòu)建參數(shù)選擇配置stage(Select Environment) { steps { script { if (params.BUILD_ENV release) { env.XCCONFIG Production.xcconfig } else { env.XCCONFIG Development.xcconfig } } } }3. 實(shí)戰(zhàn)中的證書(shū)處理腳本3.1 完整的鑰匙串初始化這是我在多個(gè)項(xiàng)目中驗(yàn)證可用的鑰匙串準(zhǔn)備腳本#!/bin/bash -l # 創(chuàng)建臨時(shí)鑰匙串 security create-keychain -p ${KEYCHAIN_PASSWORD} ios-build.keychain security default-keychain -s ios-build.keychain security unlock-keychain -p ${KEYCHAIN_PASSWORD} ios-build.keychain # 設(shè)置鑰匙串超時(shí)避免CI長(zhǎng)時(shí)間運(yùn)行鎖住 security set-keychain-settings -t 3600 -l ~/Library/Keychains/ios-build.keychain # 導(dǎo)入證書(shū) security import ./certs/dist.p12 -k ~/Library/Keychains/ios-build.keychain -P ${CERT_PASSWORD} -T /usr/bin/codesign # 解決no valid identities found錯(cuò)誤 security set-key-partition-list -S apple-tool:,apple: -s -k ${KEYCHAIN_PASSWORD} ios-build.keychain3.2 自動(dòng)更新Provisioning Profile通過(guò)fastlane的match工具可以自動(dòng)化管理配置文件lane :update_profiles do match( type: appstore, app_identifier: [com.yourcompany.*], readonly: is_ci ) end在Jenkins中建議每周執(zhí)行一次profile更新pipeline { triggers { cron(H 3 * * 1) // 每周一凌晨3點(diǎn) } stages { stage(Refresh Profiles) { steps { sh bundle exec fastlane update_profiles } } } }4. 典型問(wèn)題排查指南4.1 證書(shū)失效的應(yīng)急處理當(dāng)遇到證書(shū)相關(guān)錯(cuò)誤時(shí)建議按此流程排查驗(yàn)證證書(shū)有效期security find-identity -v -p codesigning檢查Provisioning Profile內(nèi)容/usr/libexec/PlistBuddy -c Print DeveloperCertificates embedded.mobileprovision確認(rèn)Bundle ID匹配/usr/libexec/PlistBuddy -c Print CFBundleIdentifier Info.plist4.2 多團(tuán)隊(duì)協(xié)作時(shí)的證書(shū)沖突對(duì)于大型團(tuán)隊(duì)我推薦采用這種方式避免沖突為每個(gè)Jenkins節(jié)點(diǎn)創(chuàng)建獨(dú)立鑰匙串使用不同的Apple ID管理不同環(huán)境的證書(shū)在Fastfile中動(dòng)態(tài)選擇證書(shū)來(lái)源lane :select_cert do |options| team_id options[:team] || ENV[DEFAULT_TEAM] case team_id when TEAM_A then match(app_identifier: com.teamA.*) when TEAM_B then match(app_identifier: com.teamB.*) end end5. 進(jìn)階配置技巧5.1 證書(shū)的自動(dòng)化續(xù)期通過(guò)Apple API可以實(shí)現(xiàn)證書(shū)到期前自動(dòng)續(xù)期import requests from datetime import datetime def check_cert_expiry(cert_file): # 解析證書(shū)過(guò)期日期 # 如果剩余天數(shù)30則調(diào)用續(xù)期API pass5.2 基于容器的證書(shū)管理在Docker化的Jenkins環(huán)境中建議這樣處理證書(shū)FROM jenkins/jenkins:lts # 安裝鑰匙串工具 RUN apt-get update apt-get install -y \ libssl-dev \ openssl # 預(yù)置證書(shū)解密密鑰 ARG ENCRYPTION_SECRET ENV ENCRYPTION_SECRET$ENCRYPTION_SECRET COPY certs /tmp/certs RUN /tmp/certs/decrypt_certs.sh我在實(shí)際使用中發(fā)現(xiàn)將鑰匙串掛載為Volume比直接打包進(jìn)鏡像更安全volumes: - ./keychains:/Users/jenkins/Library/Keychains這些經(jīng)驗(yàn)都來(lái)自真實(shí)的項(xiàng)目踩坑經(jīng)歷。最深刻的一次教訓(xùn)是某個(gè)項(xiàng)目的證書(shū)突然失效導(dǎo)致線上構(gòu)建中斷8小時(shí)。后來(lái)我們建立了證書(shū)到期前30天的自動(dòng)預(yù)警機(jī)制再?zèng)]出現(xiàn)過(guò)類似問(wèn)題。建議大家在Jenkins中至少配置證書(shū)過(guò)期的監(jiān)控告警這能省去很多麻煩。