
本文由 sandy 翻譯自 JARED SINCLAIR 的部落格
原文:Follow These Guidelines and Never Struggle with Xcode Code Signing Again
自從養成下面這幾個習慣,我一整年都沒再為 Xcode 的 Code Signing 傷過神。這些做法有的看起來近乎多此一舉,也多數比 Xcode 內建的簽名支援更「費事」。但那又如何?旁人怎麼說是旁人的事,把流程理順、把時間省下來才是自己的收穫。
特別是那個「Fix Issue」按鈕,能忍就忍。它不只會替你動一堆根本用不到的設定檔(iOS Team Provisioning Profile 之類),還會把你拖進描述檔的迷霧裡,越修越亂。
如果你同時待在好幾個團隊,而每個團隊又各自掛著一堆 wildcard App ID,那畫面會非常壯觀也非常痛苦。花點時間登入開發者中心,替每一支 App 申請專屬的 Bundle ID。避開萬用字元 App ID,等於提前拆掉了簽名路上一大半的地雷。若手上還有舊專案在用萬用字元,立刻改掉——新版 Xcode 只會讓這件事變得更難收拾。
打開「Manage Schemes…」面板,勾選 Shared,後續一切都輕rels。實務上至少準備兩個 scheme:一個對應開發環境,一個對應 App Store 的 release 版本;若有需要,再加一個給 beta 測試。接著在編輯畫面為每個 scheme 指定對應的 Build Configuration。如果直接沿用 Xcode 的預設值,通常 Debug 配置會配給開發方案,Release 配置則配給發布方案。
因為 Shared Scheme 已經和特定 Build Configuration 綁在一起,你可以把專案設定調得更有條理。在專案層級把 Code Signing Identity 與 Provisioning Profile 指向發證用途的憑證(Ad Hoc、Enterprise 或 App Store)。想省事也可以用自動化的 iOS Distribution;但如果你手上團隊眾多,恐怕很難信任 Xcode 每次都挑得剛剛好。我的建議是:Debug 版本交給 iOS Developer 的自動設定,方便其他協作者接手;正式發布則自己握在手上。用這套配置之後,我发现所有 Build Configuration 都能共用同一份自動 provisioning profile。
另一個高頻陷阱是:專案層級的簽名與描述檔設定,和 target 層級的設定對不上。除非你自信永遠不會犯這個錯(我以前也這麼想,後來學乖了)。把 Code Signing 與 Provisioning Profile 在 project 與 target 兩層都手動設好,並養成定期比對的習慣,確認兩邊始終一致。
這件事 Keychain Access 本身就很好處理。多數憑證(Ad Hoc、APN、App Store)有效期為 365 天,企業憑證可能放寬到三年。每次建立新的分發憑證或 APN 憑證時,順手設一個日期提醒。否則憑證一過期,你的 APN 服務會在最不巧的時刻翻臉,把一堆莫名其妙的錯誤甩到你臉上。
每個團隊起碼要準備兩張憑證:一張 Developer 憑證,讓你能把 App 裝到真機上除錯;一張 Distribution 憑證,讓你能把成品推上 App Store。若有用到推播,通常還要再加兩張 APN 憑證(開發與生產各一)。Developer 與 Distribution 憑證對團隊內所有 App 通用,APN 憑證則是每支 App 各自一份。請務必確認每張憑證的私鑰都在手上,並把憑證備份到安全又取得方便的位置——這樣即使某天核心工程師集體被抬走,團隊裡任何一個人都能把版本打包上傳。
聽起來像迷信,但真的有效。Xcode 對過期憑證的快取特別容易出錯,重啟一次往往比排查半天更快。