即时通讯
  • iOS : Objective-C
  • Android
  • macOS
  • Windows
  • Web
  • 小程序
  • Flutter
  • Unity3D
  • uni-app
  • React Native
  • 产品简介
  • 下载
  • 快速开始
    • 跑通示例源码
    • 实现基本消息收发
  • 用户相关
  • 房间相关
  • 群组相关
  • 消息相关
  • 呼叫邀请
  • 会话管理
  • 缓存管理
  • 离线推送
  • 语音组件
  • 客户端 API
  • 服务端 API
  • 迁移方案
  • SDK 错误码
  • 常见问题
  • 文档中心
  • 即时通讯
  • 离线推送
  • Apple 推送集成指南

Apple 推送集成指南

更新时间:2024-01-11 17:59

概述

iOS 离线推送,需要通过 Apple 官方的 APNs 服务器来实现。

开发者使用 ZIM 提供的“离线推送”功能之前,请参考下文,在 Apple 开发者网站 申请证书。

使用步骤

  1. 登录 Apple 开发者网站,选择上方导航栏中的 “Account”。

    /Pics/ZIM/create_apns_account.png

  2. 在开发者账户页面左侧,选择 “Certificates, IDs & Profiles”。

    /Pics/ZIM/certificates_ids.png

  3. 点击 “Identifiers” 后面的 “+”,填写 App ID 的 NAME 和 Bundle ID。

    • 若 App ID 已经存在,请跳过此步。

    • Bundle ID 不可使用通配符。

  4. 勾选 Push Notification。

    /Pics/ZIM/select_push_notification.png

  1. Apple 开发者网站 中,申请 “.p12” 证书鉴权。

    在 “Certificates, IDs & Profiles” 中,点击 “Certificates” 后面的 “+”。

    /Pics/ZIM/create_new_certificates.png

    选择 APNs 证书,这里选择“生产环境”,并选择该证书准备绑定的 AppID,点击 “Continue”。

    /Pics/ZIM/apns_apply_4.png

    这里需要选择 CSR 文件(CSR 文件的获取方式,请参考第 6 ~ 7 步),上传该文件,点击 “Continue”。

    /Pics/ZIM/upload_csr_file.png

  2. 打开系统自带的钥匙串访问。

    /Pics/ZIM/open_keychain_access.png

  3. 选择 “钥匙串访问 > 证书助理 > 从证书颁发机构请求证书”,填写 “用户电子邮件地址” 和 “常用名称”,勾选“存储到磁盘”,点击“继续”,将得到后缀名为 “.certSigningRequest” 的文件(即 CSR 文件)。

    /Pics/ZIM/request_certificate.png
    /Pics/ZIM/apns_apply_1.png

  4. 将刚才得到的 “.certSigningRequest” 的文件,在第 5 步中上传,上传并点击 “Continue” 后,进去下载页面,点击 “Download” 下载下来,得到是一个后缀名为 “.cer” 的文件;双击该证书文件,系统会把文件安装到钥匙串访问中,在如图所示位置(左侧边栏选择登录,顶部边栏选中证书),找到该证书,并导出 “.p12” 后缀的文件。

    /Pics/ZIM/export_certificate.png

  1. 开启离线推送通知

    开发者需要在 Xcode 中,开启 Push Notification(离线推送通知,只能在真机设备上运行),发送给注册的 iOS 设备。

    在 TARGETS 下选择目标,然后选择 “Signing & Capabilities > Capabilities > Push Notification”,即可开启离线推送通知。

    /Pics/ZIM/offline_push_enable_pushNotification.png

  2. 自助配置 ZIM 离线推送证书

    以上配置完成后,请在 ZEGO 控制台 自助配置 ZIM 离线推送证书(详情请参考 项目管理 - 即时通讯 - 离线推送配置),若无法配置,请联系 ZEGO 技术支持处理。

本篇目录