[教學] Provisioning profile 是什麼? 如何設定 provisioning profile?

January 17, 2022

分類標籤:ios

最近用 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


Profile picture

Shubo Chao 軟體工程師,目前大多專注於前端開發