DCloud_App_Array
DCloud_App_Array
  • 发布:2019-10-29 12:50
  • 更新:2022-10-31 09:52
  • 阅读:10878

iOS平台HBuilder基座证书过期无法真机运行的说明(return code=-402620395)

分类:HTML5+
iOS

原因

HBuilder/HBuilderX真机运行时需在iPhone/iPad手机上安装HBuilder运行基座App,此App非苹果企业证书(iEP)签名发布,通过数据线安装到iOS设备。
因为苹果政策要求,这样的App证书有效期只有1年,过期后将无法安装,需要重新打包基座

故障现象

在HBuilder/HBuilderX上真机运行证书过期的基座,控制台会提示以下错误:

正在建立手机连接...  
正在安装手机端HBuilder调试基座...  
安装失败 return code=-402620395,请手动安装..\HBuilder\plugins\com.pandora.tools.android_1.0.0.201811231756\base\iPhone_base.ipa到手机上(可使用iTools安装),并重新运行真机调试。

注:这个提示语不太精准,未来HBuilderX会提供更准确的提示。

影响范围

老HBuilder早已停止更新(1年前已经公告过),请开发者及时升级最新版HBuilderX。
HBuilderX在2.3.3.20190923及以下版本也已过期。
但这个只影响HBuilder/HBuilderX的默认运行基座,用户使用自己证书制作的自定义运行基座不受影响,自定义基座的证书过期时间是开发者自己管理的。
已经安装过的运行基座仍然可以使用。

解决方案

  1. 升级到HBuilderX 2.3.4及以上版本,目前最新版是HBuilder 2.3.7
  2. 在老版HBuilder或HBuilderX里自行制作自定义基座。运行菜单里有自定义基座的制作选项和教程。

升级注意

老版HBuilder/HBuilderX升级新版,有一些常见的升级注意事项,比如新版默认的webview从UIWebview调整为WKWebview,比如微信SDK升级引发要求通用链接。
请开发者仔细阅读升级公告指南:https://ask.dcloud.net.cn/article/36260

使用自定义调试基座出现此问题

通常出现此问题是提交云端打包自定义基座时使用了提交appstore的证书及profile文件,这种包只能用于提交appstore,不能作为自定义基座。
应该使用开发(Development)证书及profile文件打包生成自定义基座

苹果官方提供的profile类型,分别适用的场景:

Development

  • iOS App Development
    开发者调试使用,在特定设备上测试使用。可用于制作自定义基座。

Distribution

  • Ad Hoc
    发布测试时使用,在有限的设备上可安装使用。可以用于制作自定义基座,必须在指定的设备上真机运行
  • App Store
    发布到AppStore使用,只能用于提交AppStore。不能用于制作自定义基座
  • In House
    仅iEP账号可创建,可用于企业内部发行应用使用。可以用于制作自定义基座。
6 关注 分享
DCloud_uniCloud_WYQ zircon 萌龙 亢老师 望 8***@qq.com

要回复文章请先登录注册

ztb

ztb

回复 BoredApe :
已经看到 谢谢
2022-10-31 09:52
BoredApe

BoredApe

回复 ztb :
请阅读公告,现在不支持标准基座。需要自己打自定义基座进行测试 :《[关于iOS真机无法运行标准基座的公告](https://ask.dcloud.net.cn/article/40041)》
2022-10-28 14:00
ztb

ztb

运行在手机上的时候是标准运行基座 就已经提示安装失败了 下面一大片评论都说是证书过期了 这刚创建的项目 都还没有申请证书呢 也没有打包过自定义基座 有没有大佬遇到同样的问题呀
2022-10-28 13:57
一切安好

一切安好

回复 AimerQAQ :
谢谢了,用的就是开发证书,问题找到了,调试的手机是第一次用所以要添加一下,然后重新生成一个证书再重新打自定义基座。
2020-09-23 16:29
AimerQAQ

AimerQAQ

回复 一切安好 :
证 书
2020-09-23 11:35
AimerQAQ

AimerQAQ

回复 一切安好 :
调试的时候用developer证书,打包的时候用正式证书
2020-09-23 11:35
一切安好

一切安好

回复 AimerQAQ :
我的问题跟你一样,请问怎么解决的啊?
2020-09-23 11:26
有问

有问

回复 DCloud_App_Array :
谢谢,我今天重新更新了证书,果然是提前一个月就不能下载描述文件了。
2019-12-02 10:02
DCloud_App_Array

DCloud_App_Array (作者)

回复 有问 :
添加新设备需要更新profile文件,下载新的profile文件后再提交云端打包。
2019-11-29 18:49
有问

有问

然而还是不行,在我之前的IP6S上可以。添加了新机器是否还要等一天才能生效?今天试了十几遍都没用,我的各项证书也没过期,用的是开发版证书,但不用自定义基座就能安装成功。
2019-11-28 13:18