要在建置機器上自動化部署 iOS 專案,簽名憑證的處理是無法迴避的一環。需要做的事其實只有三件:匯入憑證、查詢現有憑證、刪除過期憑證。macOS 內建的 security 指令就能全部搞定,非常適合寫進 CI 腳本。
security unlock-keychain -p mac_password /Users/lizeyang/Library/Keychains/login.keychain security list-keychains -s /Users/lizeyang/Library/Keychains/login.keychain security import p12_filepath -k /Users/lizeyang/Library/Keychains/login.keychain -P p12_password -T /usr/bin/codesign
參數替換說明:
mac_password:機器的登入密碼。lizeyang:登入帳號名稱,下面兩條指令同樣需要替換。p12_filepath:.p12 憑證檔的路徑。p12_password:p12 的匯出密碼;若匯出時未設密碼,請填空字串 ""。三行指令各有分工:第一行解鎖鑰匙圈,第二行把 login.keychain 設為搜尋清單中的登錄項目,第三行才真正匯入憑證,並透過 -T 授權 codesign 可以無提示地存取該私鑰。少了 -T 這步,後續簽名往往會卡在要求輸入密碼的對話框上,這是自動化流程中最常見的失敗原因。
security find-identity -p codesigning /Users/lizeyang/Library/Keychains/login.keychain
這會列出所有可用於程式碼簽名的身元,包含名稱與對應的 SHA1 雜湊。
security delete-certificate -Z SHA1
把 SHA1 替換為憑證的 SHA1 值即可。這個值是 40 位的十六進位字串,可以直接從 find-identity 的輸出中複製。
把憑證密碼寫進腳本時,請改用環境變數或 CI 平台的 secret 機制注入,不要直接寫死在版本控制的檔案裡。另外,刪除憑證前建議先呼叫一次 find-identity 並比對,避免誤刪仍在使用的簽名身元,導致整條流水線失敗。
更多 security 的參數與用法,可查閱 Apple 官方文件。