tencent cloud

移动推送

产品动态
公告
产品功能动态
Android SDK 发布动态
iOS SDK 发布动态
macOS SDK 发布动态
产品简介
产品概述
产品优势
应用场景
全球化部署
购买指南
价格总览
购买指引
计费模式
免费试用
欠费说明
快速入门
创建产品和应用
Android 快速接入
iOS 快速接入
创建推送任务
查询推送记录
推送测试方法指引
产品限制说明
操作指南
推送管理
推送高级功能
实践教程
iOS 平台角标功能实践
API 文档
简介
API 概览
调用方式
推送相关接口
标签相关接口
账号相关接口
统计相关接口
用户属性相关接口
服务端错误码
服务端 SDK
API(Java)
SDK 文档
Android 接入指南
iOS 接入指南
客户端集成插件
macOS接入指南
用户及权限
快速入门配置
进阶自定义配置
资源标签
服务协议
服务等级协议
开发者协议
常见问题
iOS 常见问题
Android 常见问题
Flutter 常见问题
其他问题
移动推送政策
移动推送隐私协议
TPNS 数据处理和安全协议
Developer Agreement
联系我们
词汇表

iOS 快速接入

PDF
聚焦模式
字号
最后更新时间: 2024-01-16 17:31:40

简介

本文档提供移动推送 iOS 应用快速接入指引。使用本地工具无代码集成,一键为您的 iOS 应用配置推送功能。

接入前准备

创建 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 命名规则 (主tartget 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,请查看注册接口返回的错误码,根据 错误码对照表 排查。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈