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.1.4. 账号/标签绑定和解绑为什么不起作用

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

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

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

1.1.6. 终端出现未找到应用程序的“aps-environment”的授权字符串错误

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

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

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.1.8. 客户端如何播放自定义推送消息音频

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

1.1.9. iOS 是否支持离线保存

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

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

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

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

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

1.1.12. 当APP被kill的时候，为什么收不到silent notification

如果您启用了远程通知后台模式，系统将启动您的应用程序（或将其从暂停状态唤醒），并在远程通知到达时将其置于后台状态。但是，如果用户强行退出，系统不会自动启动您的应用。在这种情况下，用户必须重新启动应用程序或重新启动设备，系统才会再次尝试自动启动应用程序。

results matching ""

    No results matching ""