> For the complete documentation index, see [llms.txt](https://growingio.gitbook.io/mp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://growingio.gitbook.io/mp/developers/integrations/ios-sdk/ios-cer-guide.md).

# iOS 推送证书设置指南

### 创建应用程序 ID <a href="#id" id="id"></a>

* 登陆 [苹果开发者网站](https://developer.apple.com/) 进入开发者账户。
* 从开发者账户页面左侧入口进入 “Certificates, IDs & Profiles” 页面。
* 创建 App ID，填写 App ID 的 NAME 和 Bundle ID（如果 ID 已经存在可以直接跳过此步骤）。
* 为 App 开启 Push Notification 功能。如果是已经创建的 App ID 也可以通过设置开启 Push Notification 功能。
* 填写好以上属性后，点击 “Continue”，确认 AppId 属性的正确性，点击 “Register”，注册 AppId 成功。

#### 1、项目配置

* 在项目工程中打开后台推送权限设置，如下图所示

![](https://348272635-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lpwgem-x8KzhBglybzw%2F-M6htVwzrRZ1eDqwLc87%2F-M6hthdOT-EXAkLg2seE%2Fimage.png?alt=media\&token=3b675400-5b36-4140-bbb6-e15441103b0d)

* 打开推送开关Push Notifications，如下图所示

![](https://348272635-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lpwgem-x8KzhBglybzw%2F-M6htVwzrRZ1eDqwLc87%2F-M6ht_bTnRmXpUmRi1qs%2Fimage.png?alt=media\&token=15aa79d7-a49d-49f3-8d11-94e6060f7ef0)

#### 2、创建AppID

如果之前已经创建了AppID可跳过这一步。登录苹果开发者账号，点击如下图红色箭头区域，进入证书配置页面

![](https://348272635-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lpwgem-x8KzhBglybzw%2F-LwTAoZaohC_B_54B5_I%2F-LwTBDkOm1K9gG5TR6mv%2Fimage.png?alt=media\&token=2eb1f743-fe2c-44cd-9b00-091988684fad)

选中“Identifiers”，并且对应的是“App IDs”

![](https://348272635-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lpwgem-x8KzhBglybzw%2F-LwTAoZaohC_B_54B5_I%2F-LwTBTimCxbuxBCWpkpO%2Fimage.png?alt=media\&token=9725e7f8-ea1c-4957-90d1-c3061483e0bd)

选中对应的平台（Platform），输入对应的描述（Description）、Bundle ID

![](https://348272635-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lpwgem-x8KzhBglybzw%2F-LwTAoZaohC_B_54B5_I%2F-LwTB_8fJ7k4iwvzwSkX%2Fimage.png?alt=media\&token=08527081-ed32-44b2-a32d-ad9ec3ece231)

打开推送功能，选中如下图所示，点击右上角“continue”按钮，执行下一步

![](https://348272635-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lpwgem-x8KzhBglybzw%2F-LwTAoZaohC_B_54B5_I%2F-LwTBdRb2_IiaSLD41f0%2Fimage.png?alt=media\&token=a8ba414c-8387-486a-826a-e5dace779a4c)

确定信息无误后，点击右上角“Register”进行注册

![](https://348272635-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lpwgem-x8KzhBglybzw%2F-LwTAoZaohC_B_54B5_I%2F-LwTBgmP7cdzXvFGTMAt%2Fimage.png?alt=media\&token=d612bce3-8fec-4aec-9896-b74a958184f4)

#### 3、创建本地CRS证书

打开MAC电脑上的钥匙串访问，点击窗口左上角的“钥匙串访问”中的“证书助理”，选择“从证书颁发机构请求证书…”

![](https://348272635-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lpwgem-x8KzhBglybzw%2F-LwTAoZaohC_B_54B5_I%2F-LwTBkzQTGjmj1tekaeQ%2Fimage.png?alt=media\&token=74ab6a80-b696-4039-a821-9acc5c949c85)

将证书选择为“存储到磁盘”，输入任意合法的邮箱地址后即可将证书保存到本地目录路径下

![](https://348272635-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lpwgem-x8KzhBglybzw%2F-LwTAoZaohC_B_54B5_I%2F-LwTBocmZI3swhLvztM9%2Fimage.png?alt=media\&token=a7cbbc31-3f47-41b5-bb2d-56c78665c7f8)

#### 4、创建推送证书

登录苹果开发者账号，点击下图红色箭头指示区域

![](https://348272635-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lpwgem-x8KzhBglybzw%2F-LwTAoZaohC_B_54B5_I%2F-LwTBuflpxjFUQwY8K_h%2Fimage.png?alt=media\&token=420ec02b-ebdc-4faf-9750-2e46c8158190)

点击加号“+”，创建证书

![](https://348272635-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lpwgem-x8KzhBglybzw%2F-LwTAoZaohC_B_54B5_I%2F-LwTBy05Nh84keqcuWcp%2Fimage.png?alt=media\&token=c95f7b0f-ebf9-4c17-bb04-175d0af27af8)

选择“Services”下创建推送证书，其中红色箭头指示的为创建开发调试环境下的推送证书，蓝色箭头指示的为创建生产环境以及开发调试下的推送证书，

![](https://348272635-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lpwgem-x8KzhBglybzw%2F-LwSVWaGucZ_R84X7-vx%2F-LwSZNutwBuleMyXCwsD%2Fimage.png?alt=media\&token=0f9a1f6e-f186-44b0-b874-cde3763b6373)

这里假如创建的是开发环境的推送证书，选中红色箭头对应的圆圈，点击右上角的“continue”按钮，进入下一步，选择项目对应的“App ID”，点击右上角的“continue”按钮，进入下一步

![](https://348272635-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lpwgem-x8KzhBglybzw%2F-LwTAoZaohC_B_54B5_I%2F-LwTC1WJQt84maNCrr_2%2Fimage.png?alt=media\&token=a4253fd6-b19a-478c-a402-e415f18f38f4)

选择本地的“CRS”文件，点击右上角的“continue”按钮，进入下一步，即可生成对应项目开发环境下的推送证书，点击右上角的“Download”按钮，将证书下载到本地，选中刚才下载的证书，双击安装。

#### 5、导出推送证书p12

打开MAC电脑上的钥匙串访问，找到刚才安装的推送证书，选中右击导出该证书

![](https://348272635-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lpwgem-x8KzhBglybzw%2F-LwTDEGj2e7JfBFI6PPu%2F-LwW2DtbtzzvDzOR0nKn%2Fimage.png?alt=media\&token=e91336a1-e3dd-4a34-85b1-004a10991c19)

设置证书的本地存储路径，选择导出证书的格式为个人信息交换( .p12 )，设置证书密码

![](https://348272635-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lpwgem-x8KzhBglybzw%2F-LwTAoZaohC_B_54B5_I%2F-LwTC9TEXusqH_gSbXHt%2Fimage.png?alt=media\&token=3c6d9728-f94b-465e-b62c-fceac163252c)

#### 6、上传证书

登录“GrowingIO” 用户运营页面，找到对应配置的项目，确保之前已经成功集成了触达SDK，在应用管理中的“**应用配置**”中选择需要配置的推送证书的环境，输入对应的“BundleID”，选中本地导出的p12的推送证书，输入密码并保存。
