应用研发平台EMAS目前在线推送是成功的，离线推送不成功。有离线推送的示例吗？

问题分析与解决方案

根据您描述的问题，应用研发平台 EMAS 的在线推送成功，但离线推送失败。结合知识库中的信息，以下是可能导致问题的原因及解决方法。

1. 离线推送的关键配置检查

离线推送需要满足以下条件，请逐一核对：

(1) 设置 StoreOffline 参数

• 作用：该参数决定消息是否在设备离线时保存，并在设备上线后重新发送。
• 要求：必须将 StoreOffline 设置为 true，否则离线消息不会被保存和重发。
• 示例代码：

  pushRequest.setStoreOffline(true);
  

(2) 配置 ExpireTime 参数

• 作用：指定离线消息的过期时间，超过该时间的消息将不再发送。
• 要求：
  • 格式需符合 ISO8601 标准（UTC 时间），例如：2023-10-01T12:00:00Z。
  • 过期时间不能小于当前时间或定时发送时间加 3 秒（ExpireTime > PushTime + 3秒）。
  • 建议设置为至少 72 小时。
• 示例代码：

  String expireTime = ParameterHelper.getISO8601Time(new Date(System.currentTimeMillis() + 72 * 3600 * 1000));
  pushRequest.setExpireTime(expireTime);
  

(3) 检查厂商通道配置

• 作用：厂商通道是离线推送的核心依赖，确保厂商通道已正确配置并启用。
• 操作步骤：
  1. 登录 EMAS 控制台，进入 移动推送 > 应用配置 > 厂商通道 页面。
  2. 确保已填写正确的 AppID 和 AppSecret。
  3. 如果使用多渠道包，需逐一配置各渠道的密钥信息。
• 说明：未正确配置厂商通道会导致离线推送失败。

2. 辅助弹窗的配置检查

辅助弹窗是处理离线推送的重要功能，特别是在应用进程被清理的情况下。请确认以下配置是否完成：

(1) 注册辅助弹窗 Activity

• 作用：当设备离线且应用进程被清理时，辅助弹窗用于展示通知。
• 操作步骤： 在 AndroidManifest.xml 文件中注册辅助弹窗 Activity：

  <activity
    android:name="辅助弹窗Activity的全限定类名"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data
            android:host="${applicationId}"
            android:path="/thirdpush"
            android:scheme="agoo" />
    </intent-filter>
  </activity>
  

• 重要提示：android:exported=true 必须配置，否则辅助弹窗无法生效。

(2) 设置辅助弹窗参数

• 作用：服务端需配置辅助弹窗的相关参数，以确保通知能够正确展示。
• 关键参数：
  • AndroidPopupActivity：指定点击通知后跳转的 Activity。
  • AndroidPopupTitle：辅助弹窗的通知标题。
  • AndroidPopupBody：辅助弹窗的通知内容。
• 示例代码：

  pushRequest.setAndroidPopupActivity("com.example.MyPopupActivity");
  pushRequest.setAndroidPopupTitle("离线通知标题");
  pushRequest.setAndroidPopupBody("离线通知内容");
  

3. iOS 离线推送的特殊配置

如果您的应用包含 iOS 平台，还需检查以下配置：

(1) 启用离线消息转通知功能

• 作用：当设备不在线时，消息会通过 APNs 转为通知送达。
• 要求：
  • 设置 iOSRemind 参数为 true。
  • 确保 iOSApnsEnv 为 PRODUCT（生产环境）。
• 示例代码：

  pushRequest.setIOSRemind(true);
  pushRequest.setIOSApnsEnv("PRODUCT");
  

(2) 配置离线通知内容

• 作用：指定离线消息转通知时使用的通知内容。
• 要求：设置 iOSRemindBody 参数。
• 示例代码：

  pushRequest.setIOSRemindBody("离线通知内容");
  

4. 其他常见问题排查

(1) 检查推送类型

• 作用：推送类型会影响消息的处理方式。
• 要求：
  • 如果推送类型为 NOTICE（通知），则直接展示通知。
  • 如果推送类型为 MESSAGE（消息），需确保 AndroidRemind 参数为 true，以便离线消息转为通知。
• 示例代码：

  pushRequest.setPushType("NOTICE"); // 或 "MESSAGE"
  pushRequest.setAndroidRemind(true); // 仅适用于 MESSAGE 类型
  

(2) 检查设备状态

• 作用：确保设备处于离线状态时进行测试。
• 建议：关闭应用进程或断开网络连接，模拟离线场景。

5. 示例代码整合

以下是一个完整的离线推送配置示例：

PushRequest pushRequest = new PushRequest();
// 推送目标
pushRequest.setAppKey(appKey);
pushRequest.setTarget("ALL");
pushRequest.setTargetValue("all");
pushRequest.setDeviceType("ALL");

// 推送配置
pushRequest.setPushType("NOTICE"); // 或 "MESSAGE"
pushRequest.setTitle("离线推送标题");
pushRequest.setBody("离线推送内容");

// 离线推送相关配置
pushRequest.setStoreOffline(true);
String expireTime = ParameterHelper.getISO8601Time(new Date(System.currentTimeMillis() + 72 * 3600 * 1000));
pushRequest.setExpireTime(expireTime);

// 辅助弹窗配置
pushRequest.setAndroidPopupActivity("com.example.MyPopupActivity");
pushRequest.setAndroidPopupTitle("辅助弹窗标题");
pushRequest.setAndroidPopupBody("辅助弹窗内容");

// iOS 特殊配置
pushRequest.setIOSRemind(true);
pushRequest.setIOSApnsEnv("PRODUCT");
pushRequest.setIOSRemindBody("iOS 离线通知内容");

总结与建议

1. 重点检查：StoreOffline、ExpireTime、厂商通道配置、辅助弹窗注册及参数设置。
2. 测试环境：确保设备处于离线状态，模拟真实场景。
3. 日志排查：查看推送日志，定位具体失败原因。

如果按照上述步骤仍无法解决问题，请提供具体的错误日志或现象描述，以便进一步分析。