iOS 證書設置指南

創建應用程式程序 ID

• 登陸 蘋果開發者網站 進入開發者賬戶。

• 從開發者賬戶頁面左側入口進入 “Certificates, IDs & Profiles” 頁面。

• 創建 App ID，填寫 App ID 的 NAME 和 Bundle ID（如果 ID 已經存在可以直接跳過此步驟）。

注: 此處需要指定具體的 Bundle ID 不要使用通配符。

• 為 App 開啟 Push Notification 功能。如果是已經創建的 App ID 也可以通過設置開啟 Push Notification 功能。

• 填寫好以上屬性後，點擊 “Continue”，確認 AppId 屬性的正確性，點擊 “Register”，註冊 AppId 成功。

兩種鑑權方式的配置

EngageLab 官網應用程式的鑑權信息一旦配置，只能用相同 bundleID 的鑑權信息進行更新，無法修改為其他的 bundleID，請在配置前仔細檢查 bundleID 是否正確，若因特殊原因需要修改，請聯繫 support@jiguang.cn.cn

方式一：通過 .p12 證書鑑權

• 如果你之前沒有創建過 Push 證書或者是要重新創建一個新的，請在證書列表下面新建。

• 新建證書需要注意選擇 APNs 證書種類。如圖 APNs 證書有開發（Development）和生產（Production）兩種。

              注：開發證書用於開發調試使用；生產證書既能用於開發調試，也可用於產品發布。此處我們選擇生產證書為例。

        

圖注：
1. 開發階段使用
2. 開發和生產都可使用

• 點擊 "Continue", 之後選擇該證書準備綁定的 AppID。

• 再點 “Continue” 會讓你上傳 CSR 文件。 （ CSR 文件會在下一步創建）

• 打開系統自帶的 KeychainAccess 創建 Certificate Signing Request。如下圖操作：

• 填寫“用戶郵箱”和“常用名稱” ，並選擇“存儲到磁盤”，證書文件後綴為 .certSigningRequest 。

• 回到瀏覽器中 CSR 上傳頁面，上傳剛剛生成的後綴為 .certSigningRequest 的文件。
• 生成證書成功後，點擊 “Download” 按鈕把證書下載下來，是後綴為 .cer 的文件。

• 雙擊證書後，會在 “KeychainAccess” 中打開，選擇左側“鑰匙串”列表中“登錄”，以及“種類”列表中“我的證書”，找到剛才下載的證書，並導出為 .p12 文件。如下圖：

• 在 EngageLab 控制台上，進入你應用程式的應用程式設置中 iOS 的鑑權方式選擇 “iOS 證書配置”，上傳剛才導出的 .p12 證書。 EngageLab 會在後台為你的應用程式進行鑑權。
• Apple 的生產推播證書允許用於開發環境的推播，勾選將生產證書用於開發環境，開發者可以僅上傳生產證書，即可在官網推播平台處選擇開發環境做推播，不用再生成和上傳開發證書。

方式二：通過 APNs Auth Key 鑑權

• 點擊左側列表 “Keys” 中的 “All”，看賬戶中是否已有 auth key，沒有則點擊 “+” 新建。

• 填寫該 key 的描述並選擇服務，如下圖。 （注：在開發和生產環境均可使用，且不會過期。）

• 點擊 “Continue” 讓你確認信息，再點擊 “confirm”，就可以下載該 key 了。 （注意： 記下 key id，而且只可以下載一次，請妥善保存。）

• 獲取你之前創建過的應用程式的 Bundle ID

• 在開發者賬戶的 “Membership” 頁面獲取 Team ID

• 在 EngageLab 控制台上，進入你應用程式的應用程式設置中 iOS 的鑑權方式選擇 “Token Authentication 配置”，上傳 APNs Auth Key 文件，並填寫你的 KEY ID，Team ID，和指定應用程式的 Bundle ID。 EngageLab 會在後台為你的應用程式進行鑑權。

Provisioning Profile 的創建

• 創建 Provisioning Profile 的前提，已在 Apple Developer 網站創建待發布應用程式所使用的 Bundle ID 的 App ID，且為該 App ID 創建了 iOS Development 證書。
• 在 蘋果開發者賬號的 Provisioning Profile 頁面點擊下圖按鈕，創建 Provisioning Profile

• 選擇此 Provisioning Profile 的環境後點擊 [Continue]：

圖注：
1. iOS開發環境的provisioning profile
2. 用於內部測試的生產環境provisioning profile
3. 用於上線AppStore的生產環境provisioning profile

• 選擇要創建 Provisioning Profile 的 App ID 後點擊 [Continue]：

• 選擇所屬的開發者證書，（這裡創建了多個開發者證書，建議只創建一個，方便管理）為了方便，選擇了 [Select All]，再點擊 [Continue] 進入下一步：

• 為該 Provisioning Profile 選擇將要安裝的設備（一般選擇 [Select All]），點擊 [Continue]:

• 給該 Provisioning Profile 填寫 Profile Name，點擊 [generate] 完成創建。

• 填寫完 Profile Name 後點擊 [generate] 完成創建，之後點擊 [DownLoad] 下載 Provisioning Profile

• 雙擊下載下來的 Provisioning Profile，添加到 xcode。

XCode 的證書配置教程

參照【iOS SDK 集成指南】集成 MTPush SDK 和上傳了推播用到的 p12 證書後在編譯運行前需要先配置一下證書，步驟如下：

• 打開 xxx-info.plist 的 Bundle identifier 項把上傳到 EngageLab 控制台的 bundle id 填寫進去：

• 點擊項目，選擇目標 TARGETS 後進入 Build Setting 介面，搜索 “Code signing”，按照下圖配置

圖注：
1. 選擇創建provison Profile時選擇的主證書
2. 選擇之前新建的provison Profile

開通AppGroups能力

積極內容的語音播報需要開啟AppGroups能力。

1. 登入開發帳號，選擇Identifiers中的+號，建立App Groups，然後根據提示填寫ID與描述即可，如下圖：

2. 選擇你的主工程bundle identity，勾選App Groups。點選App Groups後面的Configure按鈕，選擇已建立的AppGroup。

3. 重新為該bundle identity,製作設定檔。下載後，導入工程中。

4. 選擇你的notification extension工程對於的bundle identity，重複步驟2和步驟3。

5. 設定xcode,選取主工程Target, 點選新增 +Capability, 選擇 App Groups, 新增步驟1所建立的App Group。

6. 选择notification extension 工程target, 重复步骤5的操作。