原生移动开发 / 系统课时
统一封装多厂商推送通道
统一封装多厂商推送通道
当应用同时接入 FCM 和多个厂商推送 SDK 时,业务代码最容易被初始化、Token 获取和消息回调细节污染。本课把这些差异收敛到统一接口,让上层只处理“注册、获取 Token、接收消息”三个稳定能力。
学习目标
- 设计统一的
PushProvider抽象与标准化消息模型 - 把 FCM、厂商 SDK 的初始化与回调隔离到各自适配器
- 在运行时选择通道,并保证业务层不依赖具体 SDK
为什么需要统一接口
不同推送通道的 SDK 生命周期和回调形式并不一致。有的需要在 Application 初始化,有的通过 Service 或 Receiver 接收事件,Token 刷新时机也可能不同。若页面、业务 Service 直接调用这些 SDK,后续新增通道就会扩散修改范围。
统一封装的核心不是把所有 SDK 方法硬翻译成同名方法,而是先定义业务真正需要的最小能力,例如初始化、获取当前 Token,以及把收到的消息转换成统一事件。SDK 特有能力留在适配器内部。

设计统一模型
先定义业务契约,再写具体适配器。通常至少需要一个 provider 标识、一个 Token 对象和一个统一消息对象,这样服务端和业务层都不必知道原始 SDK 回调长什么样。
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 的原始消息对象不应越过适配器边界。
预期结果
编译器能够识别 PushProvider、PushListener 和 PushMessage 三个统一模型;业务层无需引用 FCM 或任一厂商 SDK 类型。封装 FCM 与厂商 SDK
FCM 适配器负责调用 Firebase SDK 并把 Token 与消息事件转换成统一对象;厂商适配器做相同的事情,但内部保留厂商自己的初始化、Token 获取和回调注册逻辑。业务层只面对 PushProvider。
一个实用的组织方式是让每个 Provider 都实现相同接口,再由一个管理器保存当前启用通道。Provider 的选择依据可以来自构建变体、服务端配置或运行环境,但不要把“如何选择”写进业务页面。
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 初始化代码应留在具体适配器内。
预期结果
同一份业务代码只依赖 PushManager 和 PushProvider;切换 FCM 或其他厂商时,无需修改消息处理逻辑。处理初始化与回调边界
初始化不应该等于“Token 一定已经存在”。应用首次启动、Token 刷新、用户重新安装或 SDK 状态变化都可能让 Token 在之后才出现,因此回调模型需要支持异步更新。
消息回调同样不要直接把厂商对象交给业务层。适配器应完成字段映射,并明确哪些字段可能为空。例如标题、正文和自定义数据都应按统一模型处理,业务层再根据 providerId 决定是否需要额外兼容。
什么时候该拆分 Provider
当两个通道只有 SDK 名称不同、业务语义完全一致时,共用同一个接口即可。若某厂商存在平台专属能力,例如特殊消息分类、设备标签或渠道参数,也不要为了“接口统一”强行塞进所有 Provider。
较稳妥的方式是保持核心接口最小,再为确有业务价值的能力增加可选扩展接口。这样既能保持统一模型,也不会把最低能力抽象成一个包含大量空实现的方法集合。
最终判断标准很简单:业务层应该关心“推送是否初始化、Token 是什么、收到了什么消息”,而具体 SDK 应该只存在于对应 Provider 内部。这样新增通道时,变化主要被限制在适配器和通道选择配置中。