Windows 下使用 HBuilderX 进行 iOS 真机调试

0 阅读3分钟

前言

在开发 uniapp 的时候需要调试 APP,但是手上没有 Mac 设备,也没有申请好的 IOS APP 证书,就只能用自签 ipa 的方式来安装我们的 APP 了。

这种方法的缺点是,只能指定签名的 IOS 设备上使用,而且通过自签 ipa 安装上的 APP,证书的签名时间是有限的。

如果 APP 的签名过期,安装好的 APP 就没法再打开使用了。需要重新签名安装后,APP 才能继续使用。

准备工作

再开始操作前,请确保已经有一个苹果账号,如果没有可以先去注册一下。

爱思助手签名(免证书)

爱思助手提供了 IPA 签名工具,只需要苹果账号和 IOS 设备的 UUID,就能签名 APP。

需要注意的是,这个签名的 APP 只有七天的有效期,过期后 APP 会直接闪退无法打开,就需要重新进行签名。

首先,我们需要下载爱思助手,并通过数据线连接到电脑。找到菜单的 工具箱 > IPA 文件签名 选项

爱思助手-IPA文件签名.png

点击添加 IPA 文件,进入 HBuilderX 安装路径 D:\Software\HBuilderX\plugins\launcher\base,这里需要改成你自己设备的安装路径。然后选中 iPhone_base.ipa 文件后打开

IPA文件签名选项.png

因为我们没有 Apple 的证书,所以我们选择 Apple ID 签名,然后我们添加一个 Apple ID

添加 Apple ID

填写苹果账号密码,另外请确保苹果账号密码正确,不然签名会失败。填写完成后,我们点击确认。

image.png

然后我们选中 HBuilder 和 Apple ID,点击立即签名。签名好后,会生成一个 iPhone_base.ipa 文件在 C:\Users\username\Documents 目录下,这个文件就是我们签名后的文件了。

image.png

image.png

image.png

我们需要把这个文件重命名为 iPhone_base_signed.ipa,然后复制到原来 HBuilderX 安装目录下的 HBuilderX\plugins\launcher\base 目录中

image.png

这个时候,我们的就可以在 HBuilderX 中进行 IOS 真机调试了。

运行到 APP 基座

打开 HBuilderX,点击菜单 运行 > 运行到手机或模拟器 > 运行到 IOS APP 基座

运行到IOS APP基座.png

确保连接到 IOS 设备,并选择使用标准基座运行,然后点击运行。接下来就和 Android 真机调试一样了。

IOS真机调试

需要注意的是,默认连接到基座不会安装上 APP,因为 IOS 不信任我们自签名的 APP 开发者。

信任 IOS 应用

所以我们还需要到设置中手动勾选信任。打开 IOS 的设置,进入 通用 > VPN 与设备管理 > 开发者 APP,点击信任我们刚刚安装上的 APP,然后 APP 就能打开了。

我们再次回到 HBuilderX 中重新运行一次 IOS 真机调试,这个时候 APP 就会自动安装上,并且能够打开了。

踩坑记录

如果签名后失败提示下面的错误,说明爱思助手版本太旧了,需要更新一下,更新后就可以成功签名了。

签名失败: 描述文件申请失败:Get XcodeToken err SRP Setp1 err:plist: error parsing text property list: unexpected hex digit h' at line 0 character 2

扩展阅读