从旧版FCM APIs迁移至HTTP v1：Android客户端是否需修改？

• 核心结论：绝大多数场景下Android客户端无需修改。FCM服务会自动把HTTP v1格式的负载转成客户端熟悉的RemoteMessage对象，只要你发送的消息核心字段（比如notification通知内容、data自定义数据）的存放逻辑和旧版一致，客户端解析RemoteMessage的代码完全不用动。

• 几个容易忽略的细节要留意：

  • 自定义数据字段：如果旧版你在负载里加了非标准的自定义字段，一定要确保HTTP v1里这些字段依然放在data节点下，别放到notification或者其他顶层节点里，不然客户端用RemoteMessage.getData()可能拿不到数据。
  • 通知字段的细微差异：HTTP v1的notification结构和旧版有小区别（比如旧版的icon对应v1里的android.icon），但FCM会自动做适配转换，客户端通过RemoteMessage.getNotification()拿到的属性还是和以前一样，除非你用了特别小众的通知字段，最好测试下确认。
  • 消息优先级设置：旧版的priority字段在v1里是android.priority（针对Android平台），不过FCM会处理这个转换，客户端不用调整优先级相关的逻辑。
  • 务必做测试验证：建议先用测试设备发几种不同类型的消息（纯通知、纯数据、通知加数据），检查客户端RemoteMessage的各个属性是否和旧版一致，避免某些边缘字段的转换问题导致异常。

内容的提问来源于stack exchange，提问作者DJ-DOO