uni-app xcode 制作iOS Notification Service Extension 远程推送图文原生插件

WeiAreYoung2026-01-22 8:11

由于uni-app不支持iOS 的Notification Service Extension推送类型,所以只能自己做推送的图文插件,对原来的只有文本的推送消息不影响

uni-app 官方文档：

https://nativesupport.dcloud.net.cn/NativePlugin/course/package.html

在xcode中制作Notification Service Extension

https://help.aliyun.com/document_detail/434703.html?spm=5176.product30047.6.159.afmd1u

NotificationService描述文件创建教程

http://www.qianfanyun.com/help/475

1、新建一个空项目，在空项目中创建.a 静态插件库，在空项目中创建Notification Service Extension tag

2、实现Notification Service Extension 内容逻辑,我参考的阿里demohttps://github.com/aliyun/alicloud-ios-demo/blob/master/mpush_ios_demo/mpush_service_extension/NotificationService.m

3、主项目XCode环境中archive以后,找到ipa,将ipa解压后在Payload/XXX.app/PlugIns/ 下可以找到.appex文件将.appex添加到uni原生插件下的 ios/Plugins/ 目录中即可，这个.appex文件就是Notification Service Extension tag 扩展文件

4、按照官方教程，在nativeplugins目录下配置自定义的uni-app插件内容，测试的时候hbuilderx中自定义iOS基座

*遇到的一些问题：

1、主项目的bundle id不能和Notification Service Extension的bundle id一样,不然uni-app 制作完插件以后,云打包会报错编译不通过

https://www.jianshu.com/p/f5abaa2dd715

2、Notification Service Extension的bundle id必须和主项目的bundle id前面标识一样，比如主项目的bundle id是：com.aa.look ,Notification Service Extension的bundle id就必须是：com.aa.look.pushservice ，'pushservice'一般是Notification Service Extension创建的tag名称

3、证书一定要配置对,不然云打包会报很多合并的错误

*推送的内容格式一般是如下格式：

复制代码

// 远程推送图文多媒体格式消息，attachment是图片路径
{
  "aps": {
    "alert": {
      "title": "通知标题",
      "subtitle": "通知副标题",
      "body": "通知的主要内容"
    },
    "url-args":['/pages/AIImage/AIImage'],
    "sound": "default",
    "badge": 1,
    "mutable-content": 1
  },
  "attachment": "https://img2.baidu.com/it/u=11915139,601311520&fm=253&app=120&f=JPEG?w=800&h=800"
}

*最终效果：