App 推送通道申请及费用

配置字段对应关系

push:
  contentDetailOn: true
  pushPoolSize: 100
  apns:
    dev: false
    topic: ""
    password: ""
    cert: ""
  hms:
    packageName: ""
    appID: ""
    appSecret: ""
  mi:
    packageName: ""
    appID: ""
    appSecret: ""
    channelID: ""
  vivo:
    packageName: ""
    appID: ""
    appKey: ""
    appSecret: ""
  oppo:
    packageName: ""
    appID: ""
    appKey: ""
    appSecret: ""
    masterSecret: ""
  firebase:
    jsonPath: ""
    projectId: ""
    packageName: ""

APNs 申请和费用

费用

• APNs 不按推送量单独收费。
• 需要 Apple Developer Program 会员资格，国内常见为 688 元/年，详见 iOS 开发者账号申请流程及费用。

申请步骤

1. 登录 Apple Developer。
2. 进入 Certificates, Identifiers & Profiles。
3. 在 Identifiers 中找到 App ID，确认 Bundle ID 与 iOS 工程一致。
4. 开启 Push Notifications 能力。
5. 创建 APNs 证书：
   • 证书方式：创建 Apple Push Notification service SSL 证书，下载 .cer 后导出 .p12。
   • 推荐长期方式：创建 APNs Auth Key，使用 Key ID、Team ID、Bundle ID 进行鉴权；如果当前后端只支持 .p12，先按证书方式配置。
6. 在服务器配置：
   • topic：Bundle ID。
   • cert：.p12 文件路径。
   • password：导出 .p12 时设置的密码。
   • dev：测试环境为 true，生产环境为 false。

注意事项

• 开发环境和生产环境 token 不通用，dev 配错会导致推送失败。
• APNs 证书和应用 Bundle ID 绑定，换包名、转移 App 或换团队后要重新检查证书。
• .p12 文件属于敏感凭据，不要放进公开仓库。

华为 Push Kit 申请和费用

费用

• 华为 Push Kit 通常不单独收推送费。
• 华为 HMS Core 大部分服务免费，部分服务有免费额度或按量计费；Push Kit 是否产生额外费用以 AppGallery Connect 和服务价格页为准。

申请步骤

1. 注册并登录 华为开发者联盟。
2. 完成开发者实名认证，企业应用建议使用企业开发者账号。
3. 进入 AppGallery Connect，创建项目和应用。
4. 填写 Android 包名，配置 SHA-256 证书指纹。
5. 在“项目设置 > API 管理”中启用 Push Kit。
6. 在应用或项目配置中获取：
   • packageName
   • appID
   • appSecret 或 Client Secret
7. Android 客户端集成 HMS Push SDK，服务端按华为 Push Kit API 发送消息。

注意事项

• 华为通道主要覆盖安装了 HMS Core 的设备。
• App ID、Client ID、Client Secret 名称在不同版本控制台中可能略有差异，按后端 SDK 要求填入。
• 如果接入消息回执，要在 AppGallery Connect 配置回执地址。

小米推送申请和费用

费用

• 小米官方 FAQ 说明，小米推送基础服务目前免费。
• 可能存在消息分类、频控、每日限额、运营消息审核等规则，超出或违规不一定是收费问题，更多是限流或权限问题。

申请步骤

1. 注册并登录 小米澎湃 OS 开发者平台。
2. 完成开发者认证。
3. 在控制台创建应用，填写包名。
4. 进入消息推送/推送运营平台，为应用启用推送服务。
5. 阅读并同意小米推送相关协议。
6. 获取：
   • packageName
   • appID
   • appKey
   • appSecret
   • channelID
7. Android 客户端集成 Mi Push SDK，服务端使用 AppSecret 调用小米推送 API。

注意事项

• channelID 要与客户端 Android 通知渠道匹配，否则可能影响通知展示样式或分类。
• 小米对通知消息分类、营销消息、私信消息等有管理规则，运营类推送要避免高频骚扰。
• 国行小米设备通常优先走小米系统通道，海外设备可考虑 FCM。

vivo 推送申请和费用

费用

• vivo 推送通常不单独收推送费。
• 正式推送通常受应用状态、推送权限和每日额度限制；不同类别消息、运营消息可能需要审核。

申请步骤

1. 注册并登录 vivo 开放平台。
2. 完成开发者认证，企业应用建议使用企业账号。
3. 创建应用并填写包名。
4. 在管理中心申请推送服务。
5. 按要求提交应用信息、隐私合规资料、推送用途等。
6. 审核通过后，在推送服务后台获取：
   • packageName
   • appID
   • appKey
   • appSecret
7. Android 客户端集成 vivo Push SDK，服务端使用 AppID、AppKey、AppSecret 获取鉴权 token 后发送。

注意事项

• vivo 正式推送权限通常要求应用审核通过或满足平台要求；未通过时可能只能测试推送。
• vivo 服务端接口一般要求时间戳和签名，服务器时间要准确。
• 建议配置回执地址，方便统计到达、点击和失败原因。

OPPO PUSH 申请和费用

费用

• OPPO PUSH 通常不单独收推送费。
• 需要 OPPO 企业开发者账号；如果账号认证、应用上架、软著或合规材料需要代理，会产生外部服务费用。

申请步骤

1. 注册并登录 OPPO 开放平台。
2. 完成企业开发者认证。
3. 创建应用并填写包名。
4. 在“应用服务/开发服务/推送服务”中申请 OPPO PUSH 权限。
5. 权限通过后进入 OPPO PUSH 运营平台。
6. 在配置管理或应用配置中获取：
   • packageName
   • appID
   • appKey
   • appSecret
   • masterSecret
7. Android 客户端集成 OPPO Push SDK，服务端使用 AppKey、MasterSecret 等参数签名发送。

注意事项

• OPPO PUSH 使用 MasterSecret 参与服务端签名，泄露后风险很高。
• 申请权限时可能要求应用已创建、包名一致、企业资质完整。
• OPPO、一加、realme 的覆盖范围和系统版本有关，实际到达情况要用真机测试。

Firebase FCM 申请和费用

费用

• Firebase Cloud Messaging 本身属于 Firebase 免费产品。
• 如果同时使用 Firebase Functions、Firestore、Storage、Authentication 短信验证等能力，可能产生费用；不要把 FCM 免费理解成整个 Firebase 项目都免费。

申请步骤

1. 登录 Firebase Console。
2. 创建 Firebase 项目。
3. 添加 Android 应用，填写包名。
4. 下载 google-services.json 给 Android 客户端使用。
5. 在 Google Cloud 或 Firebase 项目设置中创建服务账号密钥，下载服务账号 JSON。
6. 在服务器配置：
   • jsonPath：服务账号 JSON 路径。
   • projectId：Firebase Project ID。
   • packageName：Android 包名。
7. Android 客户端集成 Firebase Messaging SDK，服务端通过 Firebase Admin SDK 或 HTTP v1 API 发送消息。

注意事项

• FCM 在海外 Android 设备上更常用；中国大陆国行 Android 设备通常不能稳定依赖 FCM。
• iOS 也可以通过 FCM 转发到 APNs，但仍然需要配置 Apple APNs 凭据。
• 服务账号 JSON 是高敏感凭据，不要提交到 Git。

国内 Android 推荐接入策略

国内 Android 没有统一可用的系统推送通道，通常需要多厂商推送组合：

如果不想自己维护多厂商 SDK 和服务端签名，可以选择极光、个推、友盟、腾讯云移动推送、阿里云移动推送等聚合服务。聚合推送通常会有免费版、MAU 阶梯、厂商通道增强、数据统计和 SLA 套餐，费用按服务商报价。

安全和合规注意事项

• 所有 appSecret、masterSecret、APNs .p12、Firebase JSON 都只能放在服务端，不能写进 App 客户端。
• 不要把推送密钥提交到 Git；建议放入环境变量、配置中心或密钥管理服务。
• 推送内容涉及手机号、订单、验证码、聊天内容时，建议关闭通知详情或只展示摘要。
• 营销推送要提供退订/关闭入口，避免高频打扰。
• 国内应用市场会检查隐私政策中是否说明推送 SDK 收集的设备信息、网络信息、应用信息等。
• 客户端要处理用户关闭通知权限、系统省电限制、厂商消息分类和通知渠道。

费用预算建议

官方链接

• Apple APNs 远程通知服务端配置
• Apple 证书概览
• 华为 Push Kit
• 华为 HMS Core 服务价格
• 小米推送服务
• 小米推送常见问题
• vivo 开放平台
• vivo PUSH 开放平台 API 文档
• OPPO PUSH
• OPPO PUSH 服务开启指南
• Firebase Cloud Messaging
• Firebase 价格