uni-app 实现IOS原生APP-云打包集成极光推送(JG-JPUSH)详细教程

举报
SHQ5785 发表于 2024/05/10 09:04:18 2024/05/10
【摘要】 一、前言在前期完成 uni-app 实现 Android 原生APP-云打包集成极光推送(JG-JPUSH)操作后,接下来需要 uni-app 实现 IOS 原生APP-云打包集成极光推送(JG-JPUSH)。其操作步骤与Android端相差不多,实现细节略有不同。 二、资源资源部分SDK依赖与Android相同。需要额外新增的步骤是:生成IOS自定义基座需要IOS开发者证书,需要提前准备...

一、前言

在前期完成 uni-app 实现 Android 原生APP-云打包集成极光推送(JG-JPUSH)操作后,接下来需要 uni-app 实现 IOS 原生APP-云打包集成极光推送(JG-JPUSH)。其操作步骤与Android端相差不多,实现细节略有不同。

二、资源

资源部分SDK依赖与Android相同。
需要额外新增的步骤是:生成IOS自定义基座需要IOS开发者证书,需要提前准备好。

三、集成

集成操作与Android相同,这里不再赘述。

四、遇到的问题及解决措施

4.1 IOS开发者证书无推送权限

在制作IOS自定义基座时,提示如下错误信息:

此错误的原因是在新版本XCode编译环境中会校验profile文件中是否配置使用Push功能。

如果应用中添加了“Push(消息推送)”模块(HBuildermanifest.json文件“模块权限”->“模块设置”中配置),profile文件中则必需配置添加“Push Notifications”能力。

针对以上问题,有以下两种解决方案:

  1. 删除Push功能,即在HBuilder的manifest.json文件“模块权限”->“模块设置”中配置删除“Push(消息推送)”模块;如果手动修改过manifest.json文件,请切换到源码视图,将permissions下的所有push节点数据都删除。

  2. 更新profile文件,操作方法如下:

        1. 确保使用的App IDs打开“Push Notifications”服务

  1. 登录苹果开发者网站,输入开发者账号、密码并登录;

  2. 左侧选择“Certificates, IDs & Profiles”,打开iOS证书管理界面;

  3. 左侧“Identifiers”栏下选择“App IDs”,打开应用ID管理界面;

  4. 在右侧ID管理列表中选择需要使用的应用标识;

  5. 点击“Edit”按钮,在打开的服务列表中选中“Push Notifications”服务,点击“Done”保存;

          2. 重新生成profile文件

  1. 左侧“Provisioning Profiles”栏下选择“Distribution”,打开发布profile管理界面;

  2. 在右侧profile管理表中选择需要更新的profile项;

  3. 点击“Edit”按钮,打开profile编辑页面;

  4. 确认配置项正确,点击“Generate”按钮重新生成profile文件;

          3. 验证方法 简单验证profile文件是否配置Push功能的方法是使用记事本打开profile文件,搜索是否存在“aps-environment”。


          如果存在则表明配置Push功能正确,重新提交云端打包即可。

提示⚠️:对于付费打包的用户,若第一次已经提示开发者证书无推送权限时,在未增加推送权限前就不要重复组自定义基座了,否则会重复扣费!

4.2 manifest中并没有配置push模块。但云端打包ios就是一直报Code Signing Error: Provisioning profile “***” doesn’t support the Push Notifications capability.

Dcloud问题库也搜到了以上问题,但是并没有给出合理的解决方案。

4.3 App云端打包时,ios报profile文件与私钥证书文件不匹配

解决方案:尝试重新生成。

4.4 证书不受信任

集成推送服务后,提示证书不受信任:

经查阅资料,发现生成的SSL证书是2022年1月27日之后更新的,之前安装的Worldwide Developer Relations G3过期了,故需要安装G4证书。

下载地址:点击下载

下载Worldwide Developer Relations - G4 (Expiring 12/10/2030 00:00:00 UTC)

然后,双击添加到“钥匙串访问”,证书就正常了。

4.5 极光控制台推送信息失败

极光控制台在推送时,显示推送失败,失败原因为:token获取失败。

解决措施:需要在manifest.json配置文件-APP模块配置处,勾选Push(消息推送)配置,但是切记不勾选下方的任一二级菜单!

注意⚠️:此处使用的HBuilder版本为3.6.4.20220922,使用其他版本可能会导致配置后依然无法获取到推送信息(可能是HBuilder版本问题,目前官方未给出回复)。

五、iOS证书的类型和作用

5.1 iOS证书的类型和作用

iOS证书主要分为四类:

  • iOS开发证书
  • iOS发布证书
  • iOS推送证书
  • iOS企业证书

1、iOS开发证书
iOS开发证书是用于测试APP,在开发过程中安装到苹果手机真机测试APP的运行情况。

2、iOS发布证书
当APP开发测试好后上线就需要用到iOS发布证书,用iOS发布证书打包的ipa才能上传到App Store审核。

3、iOS推送证书
iOS推送证书是用于推送通知的,平时我们在手机的系统栏下拉看到的那些消息就是推送通知,如果要做这个功能就需要配置推送证书。

4、iOS企业证书
iOS企业证书需要企业开发者账号才能申请,用于无法上架App Store的苹果APP打包签名使用。

常用的就是以上这4种iOS证书,当你需要什么功能的时候就知道用哪个类型的iOS证书。

5.2 iOS证书的构成和有效性

iOS证书由两个文件构成。.p12文件和.mobileprovision文件

.p12文件相当于公钥,.mobileprovision文件相当于私钥。

开发证书.p12文件苹果规定只能申请2个,发布证书.p12文件只能申请3个!iOS证书配置.mobileprovision文件是没有任何数量限制的!

.p12可以共用,一个p12可以对应无数个.mobileprovision文件!所以就算.p12申请一个也够用了,可以对应创建无数套iOS证书!

所以对于证书数量的担忧是没有意义的!不会限制你上架多少个APP!

ios证书的有效期是一年,在我们软件的和开发者后台都能看到到期时间。

5.3 iOS证书可以删除吗,到期怎么更新

iOS证书是可以随意删除的(不管有没有到期),不会影响已经上架的APP。

如果你还在测试APP。删除了测试用的开发证书,APP将打不开,当然这个也没什么关系,测试APP是要不停打包的,重新申请证书打包重新安装就可以了。

iOS证书到期了需不需要重新申请呢,具体看需要,如果你要更新已经上架的APP,更新版本,删除到期的证书重新申请打包上传更新。

如果不更新APP,到期了不管他也没什么关系,不会影响上架了的APP。

六、思路拓展

以上只是实现了极光控制台手动推送,当用户任务某一节点完成时,需要做到主动推送消息,就涉及到主动调用推送API,API应用可参考API说明

七、拓展阅读

【版权声明】本文为华为云社区用户原创内容,未经允许不得转载,如需转载请自行联系原作者进行授权。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。