fastlane 如何用 cert 和 sigh 自動(dòng)生成 iOS 代碼簽名證書與 Provisioning Profile【免費(fèi)下載鏈接】fastlane The easiest way to automate building and releasing your iOS and Android apps項(xiàng)目地址: https://gitcode.com/GitHub_Trending/fa/fastlane當(dāng)你要把 iOS 應(yīng)用的構(gòu)建放進(jìn) CI 或自動(dòng)化腳本時(shí)代碼簽名證書和 Provisioning Profile 是繞不開的兩個(gè)文件證書過期、Profile 失效都會(huì)讓打包直接失敗。fastlane 提供cert和sigh兩個(gè)動(dòng)作來分別解決這兩件事——cert負(fù)責(zé)創(chuàng)建并安裝代碼簽名證書sigh負(fù)責(zé)創(chuàng)建、續(xù)期、下載并修復(fù) Provisioning Profile。本文說明如何用這兩個(gè)動(dòng)作完成“證書 Profile”的自動(dòng)化生成以及每一步如何確認(rèn)結(jié)果。適用前提擁有 Apple Developer Portal開發(fā)者門戶賬號(hào)證書創(chuàng)建需要 Team Admin 權(quán)限才能創(chuàng)建 Distribution 證書建議運(yùn)行環(huán)境為 macOScert會(huì)在 macOS 上把證書導(dǎo)入 Keychain 并做本地安裝校驗(yàn)非 macOS 系統(tǒng)上這兩步會(huì)被跳過keychain_path、keychain_password等參數(shù)也不支持登錄方式二選一Apple ID 賬號(hào)密碼fastlane 的 CredentialsManager 負(fù)責(zé)管理或 App Store Connect API Key。準(zhǔn)備配置 Appfilecert和sigh都優(yōu)先從Appfile讀取應(yīng)用的 bundle identifier 與 Apple ID無需每次都傳參數(shù)。倉庫中的 Appfile 模板AppfileTemplate展示了最小配置app_identifier(com.example.app) # 你的 App bundle identifier apple_id(youexample.com) # Apple Developer Portal 用戶名如果在多個(gè)團(tuán)隊(duì)之間切換還可以配置 team_id / team_name對應(yīng)cert、sigh的team_id、team_name參數(shù)。確認(rèn)某個(gè)動(dòng)作支持哪些參數(shù)和環(huán)境變量可以直接運(yùn)行fastlane action cert fastlane action sigh第一步用 cert 生成并安裝簽名證書最基本的命令是fastlane certsigh/cert的文檔明確指出在 fastlane 中cert是get_certificates的別名sigh是get_provisioning_profile的別名見 get_certificates 文檔、get_provisioning_profile 文檔。cert的執(zhí)行邏輯由 Runner 實(shí)現(xiàn) 決定是先檢查本地機(jī)器上是否已安裝可用的簽名證書已存在則直接復(fù)用只有在需要新建證書時(shí)才會(huì)創(chuàng)建新的私鑰、創(chuàng)建證書簽名請求CSR、向 Apple 請求生成證書下載并安裝到本地 Keychain。如果 Appfile 中沒寫apple_id可以在命令行直接傳入 Apple IDfastlane cert -u certexample.com常用參數(shù)均可通過fastlane action cert查看也支持對應(yīng)環(huán)境變量如CERT_DEVELOPMENT、CERT_OUTPUT_PATHdevelopment: true創(chuàng)建 Development 證書而不是默認(rèn)的 Distribution 證書generate_apple_certs創(chuàng)建 Xcode 11 及以上使用的 Apple Development / Apple Distribution 證書macOS Xcode 11 環(huán)境下默認(rèn)為truetype:指定特殊證書類型取值mac_installer_distribution、developer_id_installer、developer_id_application、developer_id_kextoutput_path-o證書和私鑰文件的保存目錄默認(rèn).keychain_path、keychain_password自定義 Keychain 及其密碼僅 macOS。執(zhí)行后如何確認(rèn)成功在 macOS 上終端會(huì)輸出 “Verifying the certificate is properly installed locally...”成功后顯示Successfully installed certificate 證書ID如果在 Keychain 中找不到新證書會(huì)直接報(bào)錯(cuò)退出證書文件被寫入output_path默認(rèn)為當(dāng)前目錄同時(shí)在 lane 中產(chǎn)生兩個(gè)共享值CERT_FILE_PATH證書文件路徑和CERT_CERTIFICATE_ID證書 ID非 macOS 環(huán)境會(huì)提示 “Skipping verifying certificates...”只生成證書文件而不做本地安裝。一個(gè)需要知道的邊界cert永遠(yuǎn)不會(huì)撤銷你已有的證書。當(dāng)證書數(shù)量達(dá)到 Apple 的上限時(shí)cert會(huì)拋出異常需要你先在開發(fā)者門戶手動(dòng)撤銷舊證書才能騰出名額。第二步用 sigh 生成 Provisioning Profilesigh默認(rèn)針對 App Store 類型執(zhí)行“創(chuàng)建、修復(fù)、下載”Profile 的完整流程fastlane sigh指定 bundle identifier 和 Apple ID 的完整寫法fastlane sigh -a com.example.app -u youexample.com按目標(biāo)用途選擇 Profile 類型三類參數(shù)互斥不能同時(shí)開啟fastlane sigh # 默認(rèn) App Store fastlane sigh --adhoc # Ad Hoc fastlane sigh --development # Development與cert配合時(shí)最關(guān)鍵的幾個(gè)參數(shù)-ooutput_pathProfile 保存目錄默認(rèn)當(dāng)前目錄。例如fastlane sigh -o ~/Certificates/force-f無論現(xiàn)有 Profile 狀態(tài)如何都重新生成得到最長有效期的 Profile并且會(huì)把所有可用設(shè)備加進(jìn) Profile-qfilename指定生成的 Profile 文件名必須以.mobileprovision結(jié)尾例如fastlane sigh -a com.example.app -u youexample.com -q myProfile.mobileprovision--skip_install只生成 Profile 文件不安裝到本地-ccert_owner_name指定新 Profile 使用哪張證書例如fastlane sigh -c SunApps GmbH。關(guān)于證書選擇有一條明確的聯(lián)動(dòng)規(guī)則如果同一個(gè) fastlane lane 中先運(yùn)行了certsigh會(huì)自動(dòng)使用cert剛生成的簽名證書cert會(huì)把證書 ID 寫入SIGH_CERTIFICATE_ID供sigh使用不需要再用-c手動(dòng)指定。執(zhí)行成功后Profile 文件.mobileprovision落在output_path指定的目錄lane 中可以得到SIGH_PROFILE_PATH本次 Profile 的絕對路徑、SIGH_UUID、SIGH_NAME等共享值供后續(xù)動(dòng)作如構(gòu)建、上傳直接使用。組合到 Fastfile一條 lane 完成證書和 Profilecert和sigh官方推薦的用法是在同一個(gè) lane 中串聯(lián)。在Fastfile中寫入lane :beta do cert sigh(force: true) end然后用fastlane beta觸發(fā)。這里force: true的作用是每次都重新生成 Provisioning Profile保證sigh始終使用本地機(jī)器上剛由cert安裝的那張簽名證書。已知限制與注意事項(xiàng)文檔明確建議對于大多數(shù)項(xiàng)目更推薦用 fastlane 的match方案統(tǒng)一生成和維護(hù)證書與 Profile直接組合certsigh適合想完全掌控簽名流程、并熟悉代碼簽名的場景cert無法從 Apple 開發(fā)者門戶下載“已有證書的私鑰”——私鑰永遠(yuǎn)只存在于當(dāng)初創(chuàng)建證書的機(jī)器上這也是sigh依賴本地 Keychain 中證書的前提sigh使用環(huán)境變量SIGH_CERTIFICATE或-c指定證書時(shí)也可以傳證書名稱或過期日期如果sigh提示找不到 App Identifier說明開發(fā)者門戶里還沒有這個(gè) bundle id需要先創(chuàng)建應(yīng)用標(biāo)識(shí)文檔指出的對應(yīng)動(dòng)作是producesigh不會(huì)觸碰 Xcode 自己管理的 Profile它只管理自己生成和下載的那一套。完成fastlane beta或分別運(yùn)行fastlane cert和fastlane sigh后你的工作目錄中應(yīng)能看到新生成的.cer證書文件與.mobileprovisionProfile 文件終端出現(xiàn) “Successfully installed certificate” 即為整條鏈路跑通的標(biāo)志?！久赓M(fèi)下載鏈接】fastlane The easiest way to automate building and releasing your iOS and Android apps項(xiàng)目地址: https://gitcode.com/GitHub_Trending/fa/fastlane創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考