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

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

要回复文章请先登录注册

琦琦宝贝

琦琦宝贝

没看到解决方案啊 人呢
2019-11-11 09:04
AimerQAQ

AimerQAQ

回复 AimerQAQ :
证 书怎么打不出来
2019-10-31 18:02
AimerQAQ

AimerQAQ

回复 AimerQAQ :
证书
2019-10-31 18:01
AimerQAQ

AimerQAQ

回复 DCloud_App_Array :
我觉得这个证书差别问题是论坛这一些列问题未解决的终极原因,应该要把这个区别强调一下,很多人都是区分不出来.
2019-10-31 18:00
DCloud_App_Array

DCloud_App_Array (作者)

回复 AimerQAQ :
对,iOS平台要使用开发证书才能直接安装到设备上。
2019-10-31 17:54
AimerQAQ

AimerQAQ

回复 DCloud_App_Array :
你的意思自定义基座和打正式包的证书还得不一样....是这样吗?
2019-10-31 17:51
DCloud_App_Array

DCloud_App_Array (作者)

回复 AimerQAQ :
自定义基座打包不要使用提交AppStore的发布证书,发布证书只能用于提交AppStore,不能直接安装到手机。
自定义基座应该使用开发证书,注意profile文件中配置添加调试使用的设备。
2019-10-31 17:49
AimerQAQ

AimerQAQ

IOS的自定义基座打包仍然是"安装失败 return code=-402620395,请手动安装/Users/leiat/git/h5app/LeiItSBGLProjects/unpackage/debug/iOS_debug.ipa到手机上(可使用iTools安装),并重新运行真机调试。"
2019-10-31 11:02
AimerQAQ

AimerQAQ

mac版本的HBuilder已经升级到最新了,自定义打包还是报错,这个怎么解决啊?
2019-10-31 11:02