前提
确保电脑上安装好HBuildX和Xcode, 本人的工作机是最新的2021款Mac Book Pro,安装HBuildX版本是3.2.16.20211122(HBuilderX下载地址: 下载地址), Xcode版本是13.1 (13A1030d)(下载地址)。
将iPhone真机连接到电脑上
使用数据线将iPhone真机连接到电脑,首次连接会提示是否信任当前电脑,点击确认
注意问题:在身边没有数据线时,是否可以进行真机调试?对于iOS设备,第一次连接电脑时还是需要数据线的,因为设备必须先信任过电脑。
- 使用数据线连接手机后,打开Xcode, 在Window -> Devices and Simulators打开的界面中,确保手机出现在Devices列表中
- 勾选Show as run destination 与Connect via network, 观察左侧列表相应设备上是否出现对应的标识, 出现表示配置成功
配置成功后,在未使用数据线连接,电脑和手机是否在同一个WIFI下时,调试栏也会出现你配置的设备,能够使用真机进行调试
通过wifi连接iPhone真机进行调试,目前测试只有xcode自己支持,HBuilderX并不支持,还是需要连接数据线
在HBuildX中连接iPhone真机调试运行
不管是HBuildX创建的项目,还是通过vue cli创建的项目,APP调试都必须使用HBuildX。
iPhone真机连接到电脑之后,HBuildX中选中需要运行的项目,点击菜单“运行”-》“运行到手机或模拟器”,或工具栏的运行按钮,在弹出列表中选择连接到电脑的手机,在控制台会输出如下内容
22:09:44.267 正在建立手机连接...
22:10:00.821 正在安装手机端HBuilder调试基座...
22:10:11.359 正在同步手机端程序文件...
22:10:12.820 同步手机端程序文件完成
22:10:14.032 联机调试并非打包,调试基座 HBuilder 是默认的测试包,权限、图标都不可自定义。只有在点菜单"发行-发行为原生安装包"时才能自定义这些设置
22:10:14.054 iOS9.0及以上系统需要在"设置"-"通用"-"设备管理"(或"描述文件")中信任DCloud企业证书(Digital Heaven开头的证书)才可以正常使用
22:10:14.074 如手机上HBuilder调试基座未启动,请手动启动。如应用未更新,请在手机上杀掉基座进程重启
22:11:03.458 App Launch at App.vue:4
22:11:03.483 App Show at App.vue:7
22:11:13.771 正在热重载...
22:11:14.171 DONE Build complete. FILES:["app-service.js"]
22:11:14.175 项目 'my-project' 编译成功。
22:11:14.192 正在同步手机端程序文件...
22:11:15.383 同步手机端程序文件完成
22:11:15.408 正在热刷新,如刷新失败,请点击控制台工具栏上的【重启应用图标】
- 从输出内容可以看出,HBuilder调试基座会首先安装到iPhone,该步只会执行一次,后续调试中如果检测到相同版本的基座,该步会被跳过
- 第一次调试,基座被安装后不能马上运行,会提示“不受信用的开发者”,必须在设置"-"通用"-"设备管理"(或"描述文件")中信任DCloud企业证书(Digital Heaven开头的证书)才可以正常使用
- 证书信任后,基座应用可以被打开,后续代码更新可以通过热刷新直接同步到手机端。
结语
本文介绍了在iPhone真机上开发调试UniApp应用的步骤,重点介绍各步骤中的注意事项及相关问题的解决方案