本文档提供移动推送 iOS 应用快速接入指引。使用本地工具无代码集成,一键为您的 iOS 应用配置推送功能。
在【配置管理】页面上传推送证书,您可以参考 证书获取指引 操作获取推送证书。
完成以上步骤后,单击快速接入,下载快速集成工具。
解压缩文件包,双击 TPNS Smart Tool。
此时会提示“无法打开 TPNS Smart Tool”。
前往【系统偏好设置】>【安全性与隐私】> 通用中单击【仍要打开】。
按照系统提示输入本机密码确认操作,正确无误后再次单击【仍要打开】,此时会出现【打开】,单击【打开】。
启动一键集成工具之后,进入首页,单击【开始集成】。
进入配置页面,下面我们逐一对6个配置项进行说明
登录 移动推送控制台。
产品管理 - 要配置推送能力的产品,选择 iOS 或者 macOS 平台的配置管理。
进入产品配置管理详情页,分别复制 AccessID 和 AccessKey,粘贴到一键集成工具对应的输入框内。
AppDelegate
文件所使用的语言选择:AppDelegate.m
- 请选择 Objective-C
AppDelegate.swift
- 请选择 Swift
请选择 .xcodeproj
后缀的工程文件:
基础推送能力:正常的推送通知能力,不包含推送数据触达率统计、富媒体推送等功能。
通知服务扩展插件:主要用于统计推送数据的触达率以及实现富媒体推送等功能。
Xcode
选择是自动签名,则 Xcode
会在苹果开发者平台为您的通知扩展插件生成描述文件(Provisioning File)。Xcode
选择是手动签名,则需要到苹果开发者平台手动生成描述文件(Provisioning File),否则将导致应用程序无法安装到真机调试,操作步骤如下:前往 苹果开发者平台 为通知服务扩展插件申请 Bundle Identifier
。
说明:
Bundle Identifier
命名规则 (主tartget Bundle Identifier).TPNSService。
申请包含 Bundle Identifier
的描述文件。
将扩展插件的 Bundle Identifier
指定为上述申请的 Bundle Identifier
并将 Provisioning Profile
指定为上述申请的描述文件。
说明:
- 若您是初次集成移动推送,建议同时勾选5和6,否则无法获取推送抵达数据且无法下发富媒体推送。
- 您可以单独集成配置项5或者6,也可以同时集成5和6,请根据您的项目情况自行选择。
完成上述6项配置之后,【一键集成】将变成蓝色可单击状态,单击【一键集成】。
集成成功之后,将展示如下弹框。
将 iPhone 设备连接 Xcode,安装 App 并观察控制台日志,若显示如下相似日志,表明客户端已经正确集成 SDK:
[TPNS] Current device token is 9298da5605c3b242261b57****376e409f826c2caf87aa0e6112f944
[TPNS] Current TPNS token is 00c30e0aeddff1270d8****dc594606dc184
若未搜索到 Token,请查看注册接口返回的错误码,根据 错误码对照表 排查。
本页内容是否解决了您的问题?