iOS 快速接入

最近更新时间:2024-05-16 13:10:11

我的收藏

简介

本文档提供移动推送 iOS 应用快速接入指引。使用本地工具无代码集成,一键为您的 iOS 应用配置推送功能。
注意
为了避免您的 App 被监管部门通报或下架,请您在接入 SDK 之前务必按照 iOS 合规指南 在《隐私政策》中增加移动推送相关说明,并且在用户同意《隐私政策》后再初始化移动推送SDK。

接入前准备

创建 iOS 平台应用

1. 接入 SDK 之前,需要您前往 移动推送控制台 创建产品和 iOS 应用,详情请参见 创建产品和应用 文档。


2. 配置管理页面上传推送证书,您可以参见 证书获取指引 操作获取推送证书。



3. 完成以上步骤后,单击快速接入,下载快速集成工具。


4. 解压缩文件包,双击TPNS Smart Tool。


5. 此时会提示“无法打开 TPNS Smart Tool”。


6. 前往系统偏好设置>安全性与隐私> 通用中单击仍要打开


7. 按照系统提示输入本机密码确认操作,正确无误后再次单击仍要打开,此时会出现打开,单击打开



开始接入

1. 启动一键集成工具之后,进入首页,单击开始集成


2. 进入配置页面,下面我们逐一对6个配置项进行说明



配置项1、2 - AccessID、AccessKey

1. 产品管理 - 要配置推送能力的产品,选择 iOS 或者 macOS 平台的配置管理。


2. 进入基础配置详情页,分别复制 AccessID 和 AccessKey,粘贴到一键集成工具对应的输入框内。



配置项3 - 选择工程语言

请根据 AppDelegate 文件所使用的语言选择:
AppDelegate.m - 请选择 Objective-C
AppDelegate.swift - 请选择 Swift

配置项4 - 选择工程文件

请选择 .xcodeproj 后缀的工程文件:



配置项5 - 基础推送能力

基础推送能力:正常的推送通知能力,不包含推送数据触达率统计、富媒体推送等功能。

配置项6 - 通知服务扩展插件

通知服务扩展插件:主要用于统计推送数据的触达率以及实现富媒体推送等功能。
若您的 Xcode 选择是自动签名,则 Xcode 会在苹果开发者平台为您的通知扩展插件生成描述文件(Provisioning File)。
若您的 Xcode 选择是手动签名,则需要到苹果开发者平台手动生成描述文件(Provisioning File),否则将导致应用程序无法安装到真机调试,操作步骤如下:
1. 前往 苹果开发者平台 为通知服务扩展插件申请 Bundle Identifier
说明
Bundle Identifier 命名规则 (主target Bundle Identifier).TPNSService。
2. 申请包含 Bundle Identifier 的描述文件。


3. 将扩展插件的 Bundle Identifier 指定为上述申请的 Bundle Identifier 并将 Provisioning Profile 指定为上述申请的描述文件。


说明
若您是初次集成 移动推送,建议同时勾选5和6,否则无法获取推送抵达数据且无法下发富媒体推送。
您可以单独集成配置项5或者6,也可以同时集成5和6,请根据您的项目情况自行选择。

进行移动推送 SDK 集成

1. 完成上述6项配置之后,一键集成将变成蓝色可单击状态,单击一键集成


2. 集成成功之后,将展示如下弹框。



集成成功后的项目结构及工程配置

如果集成成功,项目结构和工程配置应该如下图所示:




如果出现编译失败、收不到推送、没有触达率统计数据等情况,请先将您项目的配置与上图进行对比,找出集成错误的地方,并联系 在线客服

接入结果验证

将 iPhone 设备连接 Xcode,安装 App 并观察控制台日志,若显示如下相似日志,表明客户端已经正确集成 SDK:
[TPNS] Current device token is 9298da5605c3b242261b57****376e409f826c2caf87aa0e6112f944
[TPNS] Current TPNS token is 00c30e0aeddff1270d8****dc594606dc184
若未搜索到 Token,请查看注册接口返回的错误码,根据 错误码对照表 排查。