1. iOS常见问题排查

1.1. 推送消息收不到

消息推送是一个涉及到很多关联模块协作的任务,每一个环节出现异常都可能会导致消息收不到,以下是最为常见的问题:

1.1.1. 客户端排查

  • 检查设备通知设置

请检查【通知】---【应用名】,查看您的应用是不是打开了推送消息权限。

  • 检查设备网络设置

设备网络问题,可能导致客户端在注册 APNs 时获取接收消息的标识(Token)失败,这会导致无法使用信鸽推送服务给指定设备推送消息;

进一步说,即使是客户端正确获取 Token,且已经将 Token 注册到信鸽后台,当使用信鸽服务器推送下发消息成功时,如果是设备未联网的状态,客户端将无法收到消息;若设备在短时内恢复网络连接,可能还会收到消息( APNs 会持有一段时间,然后再次下发消息)

SDK 接入问题,在接入 SDK 之后,请确保能够获取到接收消息的标识(Device Token),具体参考iOS SDK 集成指南

1.1.2. 服务器排查

  • APNs服务器问题

由于信鸽服务针对 iOS 设备下发消息是通过 APNs 服务下发,若 APNs 出现故障,将直接导致信鸽服务器请求 APNs 给设备下发消息失败

  • 信鸽服务器问题

信鸽服务端使用了多个功能模块之间的协作方式完成消息的下发,若其中任何一个模块有问题,也会导致消息推送出现问题

1.1.3. 推送证书排查

信鸽服务器在向 APNs 请求消息下发的时候,需要使用两个必需的参数:消息推送证书和设备标识(Device Token),在进行消息推送的时候,请确保消息推送证书是有效的。关于消息推送证书的设置可以参考iOS 推送证书说明

为了验证服务器的问题,可以借助信鸽测试助手,此工具不仅可以帮助验证信鸽服务器和APNs服务器,还能验证消息推送证书的有效性、自动生成信鸽专用的消息推送证书的格式。

在通过信鸽管理台上传证书之后,证书的生效之间一般是需要 5 分钟左右

1.2. 账号/标签绑定和解绑为什么不起作用

使用 SDK API 进行账号和标签的绑定或者是解绑操作,信鸽服务器需要10s左右进行数据同步

1.3. 新版本中注册 Token 的接口不见了

在iOS SDK 3.1.0 + 版本之后,设备标识(Device Token)的注册实现了自动化,由 SDK 内部处理,不再需要开发者手动调用

1.4. 终端出现"Error Domain=NSCocoaErrorDomain Code=3000 "未找到应用程序的“aps-environment”的授权字符串" UserInfo=0x16545fc0 {NSLocalizedDescription=未找到应用程序的“aps-environment”的授权字符串}"错误

请检查 Xcode 工程中配置的 bundle id 是不是和设置的 Provision Profile 文件匹配,且对应 App 的 Provision Profile 文件是不是已经配置了消息推送能力

1.5. 客户端如何根据消息内容进行跳转或者是其他响应

iOS 设备收到一条推送消息,用户点击推送推送消息打开应用时,应用程序根据状态不同进行处理:

  • 若 App 状态为未运行,此函数将被调用

launchOptions 包含 UIApplicationLaunchOptionsRemoteNotificationKey ,表示用户点击推送消息导致App被启动运行;

若不含有对应键值则表示 App 不是因点击消息而被启动,可能为直接点击icon启动或其他。

代码示例

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions 
{
    // 消息内容获取
    NSDictionary *remoteNotification = [launchOptions objectForKey:UIApplicationLaunchOptionsRemoteNotificationKey];
    // 然后根据消息内容进行逻辑处理
}
  • 若 App 状态为正在前台或者是在后台但仍处于 Active 状态

基于 iOS 7.0+ 系统版本,如果是使用 Remote Notification 特性,那么处理函数需要使用

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler;

基于 iOS 10.0+ 的系统版本,如果是使用 Remote Notification 特性,那么处理函数建议使用新增UserNotifications Framework 来进行处理,在 iOS XG SDK3.1.0 之后的版本,信鸽 SDK 对新增的框架进行了封装,请使用 XGPushDelegate 协议中的以下两个方法:

代码示例

- (void)xgPushUserNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)(void))completionHandler {
    NSLog(@"[XGDemo] click notification");
    completionHandler();
}

// App 在前台弹推送消息需要调用这个接口
- (void)xgPushUserNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions))completionHandler {
    completionHandler(UNNotificationPresentationOptionBadge | UNNotificationPresentationOptionSound | UNNotificationPresentationOptionAlert);
}

1.6. 客户端如何播放自定义推送消息音频

首先,终端开发侧,把音频文件放到 bundle 目录下; 若使用信鸽管理台创建推送时,在【高级设置】中填写音频文件名称(不需要音频文件的全路径) 若使用 REST API 调用时,将 sound 参数设为音频文件名即可(不需要音频文件的全路径)

1.7. iOS 是否支持离线保存

不支持,信鸽服务器下发消息请求到 APNs,若 APNs 发现设备不在线,APNs 会持有一段时间,具体时长APNs并未给出明确的说明

1.8. 为什么iOS没有抵达数据

对于 iOS 9.x之前,操作系统未提供API接口来监听消息抵达终端,故而无法统计。
iOS 10.0+,操作系统提供了 Service Extension 接口,可供客户端调用,从而可以监听消息的到达,但目前信鸽iOS 消息统计数据未计算这部分数据,敬请期待。

1.9. 用信鸽服务端 SDK ,怎么创建静默推送

给参数 content-available赋值1,同时不使用 alert、badge、sound

results matching ""

    No results matching ""