最近用 React Native 開發 app 時,又遇到了 provisioning profile 設定不對的問題。因為太常遇到這個問題,所以決定來好好整理一下到底什麼是 provisioning profile,以及要如何正確設定。Provisioning profile 是一組設定檔,主要有兩個用途:確保正確的簽署 app,和確保 app 能夠安全地在指定的裝置上運行。
目錄
Sign (簽署)
首先,要上架到 App Store 的 app 都必須要經過簽署 (sign) 的程序,所謂的簽署程序會涉及一組public key/private key的組合。private key 是用來簽署 app 的,而 public key 用途則是讓其他人驗證 app 的簽署者確實是你本人。
這裡的 public key 就是所謂的 Certificate (憑證),其功能就是驗證 app 的開發者身份。
所有要上架到 App Store 的 app,都必須經過簽署的程序。
產生憑證檔的步驟可以參考這篇:iOS APP上架流程圖文教學。
大致流程是會需要你產生一組 CSR (Certificate Signing Request),產生 CSR 的同時會在你的電腦的 keychain 裡生成 private key,這就是你用來簽署 app 的 private key,千萬不能弄丟。Apple 會用這個 CSR 去生成 Certificate,可供你在 Apple Developer 的後台下載。
Provisioning Profile
有了 certificate 之後,還得要建立一個 provisioning profile 才能將 app 上架。
Provisioning profile 可以想成是一組設定檔,其中包含了以下資訊:
- Certificate
- App ID
- 可使用的設備 device id
Provisioning profile 有兩個用途:
- 確保正確的簽署 app
- 確保 app 能夠安全地在指定的裝置上運行。
要在裝置上執行的 app 必須先經過 XCode 的簽署,XCode 會核對電腦上的 certificate, app id, device id, team id 等是否和 provisioning profile 裡面含的 certificate, app id, device id, team id 一致,正確無誤的話才會用對應的私鑰來簽署你的 app。
Provisioning profile 和 code signing 的詳細機制可以看這一篇: What is a provisioning profile & code signing in iOS? 。
打包的 app 中也會包含了 provisioning profile,在裝置端執行前也會再驗證一次。透過 App Id 能夠驗證是哪個 app,透過 certificate 可以驗證作者是誰,並且可以在指定的裝置上被執行。
值得注意的是,實機測試或打包上架的時候需要指定一個 provisioning profile。Provisioning profile 有分成開發用 (development) 和發布用(distribution) 兩種。在開發階段的時候,可供測試的裝置是有限制的,但是上架用的 provisioning profile 則不會限制可使用的裝置。
要怎麼產生 provisioning profile 呢?可以參考這篇:iOS APP上架流程圖文教學。
如何讓團隊成員打包上架 iOS app
這邊有一個重點,要正確的發布上架,你的電腦上的 keychain 裡必須要有對應的私鑰。
這個私鑰就是前面提到的 public key/private key pair 中的 private key,他的 public key 則會對應到 provisioning profile 所包含的 certificate。
如果你是一人團隊,那正常來說你已經有這把 private key了;但如果你身處一個多人的團隊,很有可能私鑰是在別人的電腦產生的,所以你並沒有私鑰,這樣就沒辦法 sign 和發布到 App Store。
解決方法是:請私鑰的擁有者給你私鑰對應的 p12 檔。
要如何產生 p12 檔呢?可以參考這篇 讓同一個專案的其它成員也能夠使用各自的 Apple ID 打包並上傳 APP 或是這篇 How to make a p12 file for iOS。