讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Laper
Laper

剧本策划到成片协作

AniShort
AniShort

AI短剧协同制作平台

uni-app怎么配置Apple Push推送证书

陌强大大_9095

陌强大大_9095

发布时间:2026-11-22 05:43:48

|

725人浏览过

|

来源于php中文网

原创

必须用p8而非p12:p8是苹果官方推荐的Auth Key机制,长期有效、多App复用、无需频繁更新;p12已过时,易失效且DCloud后台仅对p8提供完整支持。

uni-app怎么配置apple push推送证书

UniApp 配置 Apple Push 证书,现在应该直接用 p8 方式,别再折腾 p12 —— 它过时、易失效、多环境切换麻烦,且 DCloud 官方已明确推荐 p8 为 uni-push 2.0 的首选方案。

为什么必须用 p8 而不是 p12?

p12 是基于证书+私钥的双向绑定方式,每次 iOS 系统更新或证书过期就得重导、重传、重打包;而 p8 是苹果官方 Auth Key 机制,一个密钥文件可复用于同一团队下多个 App,且有效期无限(除非手动删除),DCloud 后台也只对 p8 提供完整支持。

  • p12 在 uni-push 2.0 中已被标记为“兼容模式”,新项目上传会收到警告
  • 苹果开发者后台已将 p8 列为推送配置唯一推荐路径,p12 入口正逐步隐藏
  • 如果你在 DCloud 控制台看到「APNs 推送证书(p8)」输入框但没看到 p12 选项,不是界面 bug,是它真没了

Apple Developer 后台必须完成的三步

跳过任何一步,p8 都无法生效。重点不是“怎么生成”,而是“是否满足前置条件”。

Connect Claude Code to Apple apps and tmux with Claude Apple Bridges
Connect Claude Code to Apple apps and tmux with Claude Apple Bridges

为Claude Code提供对提醒事项、日历、联系人、笔记、邮件和tmux的本地命令访问权限,以便在macOS上进行工作流感知的个人操作。

下载
  • 确认你的 App ID 已启用 Push Notifications:进入 Identifiers → 找到对应 Bundle ID → 点击编辑 → 勾选 Push Notifications 并保存(不点保存=没开)
  • 创建 p8 Key 时必须勾选 Apple Push Notifications service (APNs):在 Keys 页面点击 + → 名称随意(如 uniapp-apns-prod)→ 勾选该服务 → 下载前务必记下页面显示的 Key ID
  • Team ID 必须从账号页获取:不是组织名,不是 Bundle ID,是 Apple Developer 账号首页右上角「Account」→「Membership」页里显示的 10 位字母数字组合(如 A1B2C3D4E5)

manifest.json 和 DCloud 控制台怎么填?

字段名和位置错一个,iOS 离线推送就静默失败——不会报错,但设备收不到通知。

  • DCloud 控制台「Uni Push」→「配置管理」中,填入:
      Key ID(来自苹果后台 Key 创建页)
      Team ID(来自 Membership 页面)
      Bundle ID(必须和 manifest.json 中 bundleIdentifier 完全一致,区分大小写)
      上传下载好的 AuthKey_XXXXXXXXXX.p8 文件(仅限一次,丢了只能重建)
  • manifest.json 中确保有:
    {
      "app-plus": {
        "distribute": {
          "ios": {
            "bundleIdentifier": "com.yourcompany.appname"
          }
        },
        "push": {
          "unipush": {
            "enable": true
          }
        }
      }
    }
  • 别漏掉 push 模块启用:如果 modules 下没显式声明 "push": {},即使 unipush.enable 为 true,云打包也会忽略推送能力

常见静默失败原因(无报错但收不到通知)

这类问题最耗时间,因为控制台和日志都显示“配置成功”,实际链路在某处断了。

  • iOS 设备未开启通知权限:uni.getProvider 返回 apns 成功 ≠ 设备允许通知,必须调用 uni.authorize({scope: 'scope.notification'}) 并引导用户手动开启
  • 测试时用了开发版 profile 却配了生产环境 p8:苹果不区分环境,p8 本身是环境无关的,但你打包时用的 mobileprovision 文件必须匹配 App ID 的推送开关状态(即:若 App ID 开的是 Production Push,则 profile 必须是 Distribution 类型)
  • Bundle ID 在苹果后台、manifest.json、DCloud 控制台三处不完全一致:比如多了一个空格、大小写混用(com.MyApp ≠ com.myapp),这种差异不会报错,但 APNs 拒绝路由

真正卡住人的从来不是“怎么点按钮”,而是这三处 ID 是否咬死对齐、权限是否真实授予、profile 是否与推送开关类型匹配——这些细节不验证,光上传 p8 文件毫无意义。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

3163

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

6923

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

7730

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

7718

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

1103

2024.05.22

Navicat创建数据库教程
Navicat创建数据库教程

本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。

0

2026.11.20

Navicat入门教程大全
Navicat入门教程大全

本专题整理Navicat入门教程,从认识软件界面到开展数据库操作,介绍初次使用需要了解的知识和方法。内容兼顾连接配置、数据管理及日常使用中的疑问,方便用户按学习进度查阅,为后续实践和独立操作打好基础。

0

2026.11.20

Navicat数据库连接配置指南
Navicat数据库连接配置指南

从确认数据库信息到建立可用连接,本专题串联Navicat连接数据库的相关知识和操作方法。既有初次配置时需要了解的基础内容,也有连接后的检查思路,方便用户按实际需求查阅教程,逐步熟悉数据库连接的设置流程。

0

2026.11.20

PHP8.6数组与数据处理教程
PHP8.6数组与数据处理教程

本专题汇总PHP8.6数组与数据处理教程,涵盖CSV读取和导出、引用遍历删除、array_filter回调模式、配置键名冲突、pathinfo文件名校验、GMP大整数进制转换及UTF-8正则筛选,说明升级兼容变化、输入范围和失败处理方法。

0

2026.11.20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn