DelphiRemotePushSender 项目介绍
一、项目概述
DelphiRemotePushSender 是由 Grijjy 团队开发的一个开源 Delphi 项目,用于向移动设备发送远程推送通知(Remote Push Notifications)。它同时支持 iOS(APNs) 和 Android(FCM) 两大主流推送平台,让 Delphi 开发者能够直接在服务端(或桌面端工具)中构造并发送推送消息,而无需依赖第三方推送服务网关。
项目地址:https://github.com/grijjy/DelphiRemotePushSender
对于需要自建后端推送能力、或者想在 Delphi 生态内完成”端到端”推送链路的团队来说,这是一个非常实用的基础组件。
二、为什么需要它
在移动应用开发中,推送通知几乎是标配功能。但传统的做法往往是:
- 使用第三方聚合推送服务(如极光、个推、OneSignal 等),引入外部依赖和费用;
- 或者用其他语言(Node.js、Java、Python)单独写一个推送微服务,与 Delphi 后端割裂。
DelphiRemotePushSender 的价值在于:用纯 Delphi 直接对接 APNs 和 FCM 的官方 HTTP/2 接口,把推送能力原生地集成进 Delphi 后端体系。这样一来:
- 技术栈统一,维护成本低;
- 可以精细控制推送内容、设备令牌管理、错误处理;
- 不与任何第三方服务商绑定。
三、核心特性
1. 双平台支持
| 平台 | 推送服务 | 底层协议 |
|---|---|---|
| iOS / macOS | APNs(Apple Push Notification service) | 基于 HTTP/2 的 Provider API |
| Android | FCM(Firebase Cloud Messaging) | HTTP v1 API |
两者都基于现代的 HTTP/2 + JSON 载荷方式,取代了老旧的二进制协议和 legacy FCM 接口。
2. 基于 HTTP/2 的现代实现
APNs 和 FCM 都要求通过 HTTP/2 与服务器通信,涉及 TLS、长连接、HPACK 头压缩等细节。项目封装了这些底层复杂度(底层可依赖 Grijjy 自家的 DelphiHttp2 等库),开发者只需关注”发什么”,而不用操心”怎么连”。
3. 认证方式
- APNs:支持基于 JWT Token(.p8 私钥)的认证方式,这是 Apple 推荐的现代做法,一个 Token 可覆盖多个 App、长期有效,无需频繁更换证书。
- FCM:支持基于 Service Account(OAuth 2.0) 的认证,符合 FCM HTTP v1 API 的规范。
4. 简化的 API 设计
典型使用流程大致为:
- 配置认证信息(APNs 的 Team ID、Key ID、.p8 文件;FCM 的服务账号 JSON);
- 准备目标设备的 Device Token;
- 构造通知载荷(标题、正文、角标、自定义数据等 JSON 结构);
- 调用发送方法,处理返回结果与错误。
项目通过面向对象的方式把这些步骤封装成清晰的类和方法,减少了手工拼接 HTTP 请求和 JSON 的易错工作。
四、适用场景
- Delphi 自建后端需要向 App 用户推送消息(订单提醒、聊天消息、系统公告等);
- 需要在 Delphi 桌面程序里做推送测试工具,快速验证设备令牌和载荷是否生效;
- 想摆脱第三方推送服务,构建自主可控的推送管道;
- 学习 APNs / FCM 官方接口在 Delphi 中如何落地实现。
五、使用前的准备
要真正跑通推送,你需要先在平台侧完成配置:
iOS(APNs) - 在 Apple Developer 后台创建 APNs Auth Key(.p8),记录 Team ID 和 Key ID; - 应用端需具备推送权限并拿到 APNs Device Token。
Android(FCM) - 在 Firebase 控制台创建项目、添加应用; - 下载 Service Account 私钥 JSON; - 应用端集成 Firebase SDK,获取 FCM Registration Token。
准备好这些凭据后,才能在 Delphi 端配置并发送。
六、技术要点与注意事项
- 必须使用 HTTP/2:APNs 和 FCM 新接口都只接受 HTTP/2 连接,项目已在底层处理,但运行环境需支持 TLS 1.2+。
- 令牌管理:APNs Token 有有效期,需按 Apple 要求定期刷新(不要生成过于频繁,也不要过期);FCM 的 OAuth Token 也需处理过期刷新。
- 错误反馈机制:两平台都会返回 HTTP 状态码和结构化错误体(如 APNs 的
reason字段、FCM 的错误码),生产环境要据此做重试、清理失效令牌等处理。 - 载荷大小限制:APNs 载荷通常限制在 4KB(VoIP 等特殊类型另有规定),FCM 也有相应限制,超限会被拒收。
- 与客户端配合:服务端发送只是链路一半,客户端还需正确注册、接收并处理通知,才能真正形成闭环。
七、总结
DelphiRemotePushSender 填补了 Delphi 生态在”自建移动推送后端”方面的一个空白。它以现代 HTTP/2 接口为基础,原生支持 APNs 与 FCM,帮助 Delphi 开发者在熟悉的语言与工具链内完成从设备令牌到推送载荷的完整发送流程。
如果你的项目是用 Delphi 写后端、并且需要向 iOS/Android 用户推送消息,这个库值得纳入技术选型评估。建议先在其 GitHub 仓库阅读示例代码与 README,结合官方 APNs / FCM 文档理解认证与载荷结构,再动手接入。
仓库地址:https://github.com/grijjy/DelphiRemotePushSender
提示:请以仓库最新提交文档为准,平台接口与库的 API 都可能随版本演进发生变化。




还没有评论,来说两句吧...