原生移动开发 / 系统课时

统一封装多厂商推送通道

统一封装多厂商推送通道

当应用同时接入 FCM 和多个厂商推送 SDK 时,业务代码最容易被初始化、Token 获取和消息回调细节污染。本课把这些差异收敛到统一接口,让上层只处理“注册、获取 Token、接收消息”三个稳定能力。

学习目标

  • 设计统一的 PushProvider 抽象与标准化消息模型
  • 把 FCM、厂商 SDK 的初始化与回调隔离到各自适配器
  • 在运行时选择通道,并保证业务层不依赖具体 SDK

为什么需要统一接口

不同推送通道的 SDK 生命周期和回调形式并不一致。有的需要在 Application 初始化,有的通过 Service 或 Receiver 接收事件,Token 刷新时机也可能不同。若页面、业务 Service 直接调用这些 SDK,后续新增通道就会扩散修改范围。

统一封装的核心不是把所有 SDK 方法硬翻译成同名方法,而是先定义业务真正需要的最小能力,例如初始化、获取当前 Token,以及把收到的消息转换成统一事件。SDK 特有能力留在适配器内部。

多厂商推送统一封装架构

设计统一模型

先定义业务契约,再写具体适配器。通常至少需要一个 provider 标识、一个 Token 对象和一个统一消息对象,这样服务端和业务层都不必知道原始 SDK 回调长什么样。

java
import java.util.Map;

public interface PushProvider {
    String providerId();
    void initialize();
    String getCurrentToken();
    void setListener(PushListener listener);
}

interface PushListener {
    void onTokenChanged(String token);
    void onMessage(PushMessage message);
}

record PushMessage(
        String providerId,
        String messageId,
        String title,
        String body,
        Map<String, String> data
) {}

这是统一层的片段示例,具体 Provider 需要在 Android 工程中注入对应 SDK。关键点是 PushMessage 只描述业务关心的数据,SDK 的原始消息对象不应越过适配器边界。

预期结果

text
编译器能够识别 PushProvider、PushListener 和 PushMessage 三个统一模型;业务层无需引用 FCM 或任一厂商 SDK 类型。

封装 FCM 与厂商 SDK

FCM 适配器负责调用 Firebase SDK 并把 Token 与消息事件转换成统一对象;厂商适配器做相同的事情,但内部保留厂商自己的初始化、Token 获取和回调注册逻辑。业务层只面对 PushProvider。

一个实用的组织方式是让每个 Provider 都实现相同接口,再由一个管理器保存当前启用通道。Provider 的选择依据可以来自构建变体、服务端配置或运行环境,但不要把“如何选择”写进业务页面。

java
import java.util.Map;

public final class PushManager {
    private final PushProvider provider;

    public PushManager(PushProvider provider) {
        this.provider = provider;
    }

    public void start(PushListener listener) {
        provider.setListener(listener);
        provider.initialize();
    }

    public String currentToken() {
        return provider.getCurrentToken();
    }
}

片段示例:PushManager 可被绑定到 FCM Provider 或厂商 Provider;真正的 SDK 初始化代码应留在具体适配器内。

预期结果

text
同一份业务代码只依赖 PushManager 和 PushProvider;切换 FCM 或其他厂商时,无需修改消息处理逻辑。

处理初始化与回调边界

初始化不应该等于“Token 一定已经存在”。应用首次启动、Token 刷新、用户重新安装或 SDK 状态变化都可能让 Token 在之后才出现,因此回调模型需要支持异步更新。

消息回调同样不要直接把厂商对象交给业务层。适配器应完成字段映射,并明确哪些字段可能为空。例如标题、正文和自定义数据都应按统一模型处理,业务层再根据 providerId 决定是否需要额外兼容。

什么时候该拆分 Provider

当两个通道只有 SDK 名称不同、业务语义完全一致时,共用同一个接口即可。若某厂商存在平台专属能力,例如特殊消息分类、设备标签或渠道参数,也不要为了“接口统一”强行塞进所有 Provider。

较稳妥的方式是保持核心接口最小,再为确有业务价值的能力增加可选扩展接口。这样既能保持统一模型,也不会把最低能力抽象成一个包含大量空实现的方法集合。

最终判断标准很简单:业务层应该关心“推送是否初始化、Token 是什么、收到了什么消息”,而具体 SDK 应该只存在于对应 Provider 内部。这样新增通道时,变化主要被限制在适配器和通道选择配置中。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

统一封装多厂商推送通道

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通