缺少檔案、檔案無效這類錯誤,看錯誤日誌就能輕易定位,本文不討論。這裡記錄的是憑證配置問題的排查過程。
最近要上傳一個更新版本,卻怎麼都傳不上去。碰到問題時,第一反應往往是「我什麼都沒動過啊」——這種心態反而讓排查更困難。
上傳後出現的錯誤是:
error itms-9000: "The bundle at bundle path is not signed using an Apple submission certificate"
因為先前某些原因,我把鑰匙圈(Keychain)重設過,當時申請的 CertificateSigningRequest.certSigningRequest 也已失效。看著錯誤訊息,我合理懷疑是憑證問題,於是把所有憑證重新申請了一遍。問題依然存在。
繼續排查。先用 release 憑證打包出一個 .app,例如 AppName.app,然後在命令列檢查簽名:
$ codesign -vvvv AppName.app
AppName.app: CSSMERR_TP_NOT_TRUSTED
終於有了明確的錯誤碼。搜尋後發現,這是缺少 Apple Worldwide Developer Relations Certification Authority 這張憑證導致的。
打開鑰匙圈存取,憑證確實在裡面。問題出在我之前折騰時把它的信任權限改掉了。
在憑證上雙擊 → 信任 → 把「使用此憑證」從自訂值改回「使用系統預設」,然後重新編譯並再次檢查:
$ codesign -vvvv AppName.app
AppName.app: valid on disk
AppName.app: satisfies its Designated Requirement
問題解除,順利上傳。
整個過程繞了遠路,原因是我先假設「憑證內容有問題」,於是全部重設一次,而真正的問題只是信任設定被改過。更有效率的做法是第一步就先跑 codesign,讓工具告訴你確切的錯誤碼,再針對性處理。
幾個可以一併檢查的項目:
最後一點:現代 Xcode 已內建自動簽名管理,能省掉絕大多數這類問題。若專案條件允許(單一開發帳號、無特殊權能需求),把 signing style 設為 Automatically manage signing 通常比手動管理憑證省事得多。