![鸿蒙操作系统开发入门经典](https://wfqqreader-1252317822.image.myqcloud.com/cover/903/44509903/b_44509903.jpg)
2.4 使用真机设备运行应用
使用模拟器测试后,还需要在真机进行测试。真机测试首先需要申请应用调试证书,下面将讲解申请真机测试证书的详细流程。
2.4.1 安装真机投屏软件
scrcpy Android投屏是通过adb调试的方式将手机屏幕投到计算机上,并可以通过计算机控制Android设备。它可以通过USB连接,也可以通过WiFi连接(类似于隔空投屏),而且不需要任何root权限,不需要在手机里安装任何程序。scrcpy同时适用于GNU/ Linux、Windows、macOS和鸿蒙操作系统。
首先需要下载scrcpy,目前最新版本为v1.10,如图2-30所示。下载网址为https://github.com/Genymobile/scrcpy/releases。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P40_1265.jpg?sign=1739674392-tTedku0CCwox4LKW2F4700UsbD5Uj0BM-0-02ae2fce65e9020cb28acc7ed48da75a)
图2-30 下载scrcpy
在解压后的目录中,adb.exe为adb调试程序,scrcpy.exe为启动投屏软件,如图2-31所示。
打开cmd并定位到此目录(在网址栏中输入cmd并按Enter键),或者将该目录,如D:\test\scrcpy-win64-v1.10加入系统环境变量中,这样便可在cmd命令行中进行操作。
大多数手机默认禁止ADB通过网络与之连接,因此第一次使用ADB时只能通过USB数据线连接,如图2-32所示。
有些手机还需要再打开一个关于调试模式的附加选项——USB调试(安全设置),如图2-33所示,否则将无法在计算机上操控手机。
在命令行中运行scrcpy,手机屏幕即可投射到计算机屏幕上。如果有多个设备,则需要指定序列号,序列号可以通过adbdevices命令获得,代码如下:
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P40_25478.jpg?sign=1739674392-JOlK7FWGsJBSeCjrRa55xtJ7pvxmaXaI-0-bd9f8ffd35bd1f366d957c4fe8a1771a)
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P41_1282.jpg?sign=1739674392-z6tmA86EYNxM6VwRK0Yxrws1CpGLVG8A-0-095b372243635e641802e653511af4ac)
图2-31 解压后的目录
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P41_1285.jpg?sign=1739674392-qsfT9kiiXw4TG3xoTbFGZlgLHIU7sZAr-0-27e6f19337c9c5989bba5ce698299f38)
图2-32 通过USB数据线连接
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P41_1289.jpg?sign=1739674392-jCHEWMkpxuxUZUT4apEchPaVyA8N0SgU-0-ae2ae3f99f201df6eb90a88fe49226e6)
图2-33 开启USB调试
2.4.2 真机设备测试流程
使用真机进行项目测试,需要申请应用调试证书,具体申请流程如图2-34所示。
注意:目前只有受邀请开发者才能访问HarmonyOS应用相关菜单,如果AGC页面未展示文档中的菜单,需联系华为运营人员(邮箱:agconnect@huawei.com)。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P42_1304.jpg?sign=1739674392-K9Z5SeZu4e7jb3xgZSOorjofwrVLuYHJ-0-08972bf282084e564c54cf234a5c84da)
图2-34 真机设备测试流程
申请真机测试的流程相对比较复杂,开发人员可按照下面的步骤完成申请流程。
步骤1:创建HarmonyOS应用项目。首先需要创建一个鸿蒙应用项目,通过DevEco Studio创建,如图2-35所示。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P42_1309.jpg?sign=1739674392-Ejw7dZBUnN1zk647odo2jt1aa1nWcTOm-0-5576b74d138623bf86b8697bf41e3508)
图2-35 创建项目
这里需要注意Package Name,Package Name框所填信息用于生成应用签名信息。
步骤2:使用DevEco Studio生成证书请求文件。在主菜单栏单击Build→Generate Key,如图2-36所示。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P43_1318.jpg?sign=1739674392-lwnwwabqRfWJDLeffzmjT731uHabg6Rf-0-867e51ed69af37a43ab3601e1213174d)
图2-36 生成p12文件
在Generate Key界面中,继续填写密钥等信息,填写完毕后单击Generate Key and CSR按钮,如图2-37所示。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P43_1325.jpg?sign=1739674392-V0iErStM8ib3QHYBObBQqmND2ER6G2hR-0-eca24dfa49d85323ceefb810a495a0de)
图2-37 生成csr文件
在弹出的窗口中,单击CSR File Path对应的图标,选择CSR文件存储路径,如图2-38所示。
单击OK按钮,创建csr文件成功,工具会同时生成密钥文件(.p12)和证书请求文件(.csr),如图2-39所示。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P44_1336.jpg?sign=1739674392-lJWFgwmqmcWaKm9RNQmOB1VXmRsgvzrs-0-2443e8b2c4bfce1759a5a4f35ee855d9)
图2-38 保存csr文件
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P44_1339.jpg?sign=1739674392-xYRwFf7CLZy4EbIjDc44qmlYPpbjMXwu-0-c6fb14f3907d9c4de1fa776394b96ea6)
图2-39 生成的(.p12)和证书请求文件(.csr)
步骤3:申请应用调试证书。登录AppGallery Connect网站,选择“用户与访问”,如图2-40所示。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P44_1345.jpg?sign=1739674392-Er2i4BBmLWBmduF19JhI9ubeFYaQvjHh-0-cfe98980da79098e4a1f53be7a78d511)
图2-40 选择“用户与访问”
在左侧导航栏选择“证书管理”,进入证书管理页面,单击“新增证书”按钮,如图2-41所示。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P44_1349.jpg?sign=1739674392-SkKO4jzU19LrkPayA3TvvbfSjlqbWZoc-0-0c087c65a52306e485b878e7701e0754)
图2-41 选择“新增证书”按钮
在弹出的“新增证书”窗口,填写要申请的证书信息,填写完毕后单击“提交”按钮,如图2-42所示。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P45_1355.jpg?sign=1739674392-HeG2OAVQxLbssFOlc3vfpLzGbBNrrNm8-0-cff6364427d39a31a9217ffadd9bd0b6)
图2-42 填写证书信息
在左侧导航栏选择“设备管理”,进入设备管理页面,单击右上角的“添加设备”按钮,如图2-43所示。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P45_1359.jpg?sign=1739674392-VQoYGI7yJ1xHGPtxtZja3t7qxLw2XOaT-0-d32fb6dff399e5aac522ed11b60f880d)
图2-43 选择“添加设备”
在弹出的窗口中填写设备信息,填写完毕后需单击“提交”按钮,如图2-44所示。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P45_1363.jpg?sign=1739674392-mqcFakuZFrxwrahS2itUW3L9FfFXMxqj-0-6b8b9dbac4c095fff3e93e52cf82319d)
图2-44 填写设备信息
通过adb命令查看UDID信息,命令如下:
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P46_25485.jpg?sign=1739674392-1N6C74yu8jXMD17ZPs6gIfMVIwYg6RS4-0-a4ac78191d9400ca24a4ea9c17503e04)
步骤4:申请应用调试证书和Profile。登录AppGallery Connect网站,选择“我的项目”,如图2-45所示。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P46_1383.jpg?sign=1739674392-vQB8oAqoTxBhyhtMwXHPA0AaiU8OCokC-0-767c74301c15fcc208eeba4d3109c101)
图2-45 选择“我的项目”
提示:当前在同一个项目下可以创建多个应用,这样就可以共用之前生成的csr文件和密钥文件(.p12),新的应用只需生成Profile文件就可以了。
找到你的项目,单击所创建的HarmonyOS应用。
选择“HarmonyOS应用”→“HAP Provision Profile管理”,进入“管理HAP Provision Profile”页面,单击右上角“添加”按钮,如图2-46所示。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P46_1398.jpg?sign=1739674392-5jXjQb8bnficCspognh39dmLzdWZbDtx-0-4d637ad1e1937ff77c154b00ef928115)
图2-46 选择并添加HAP Provision Profile
在弹出的HarmonyAppProvision信息窗口添加调试Profile,如图2-47所示。
调试Profile申请成功后,管理HAP Provision Profile页面会展示Profile名称、Profile类型、添加的证书和失效日期。下载生成的Profile文件,如图2-48所示。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P47_1406.jpg?sign=1739674392-wEdJTrCcGAwC2qlFwtdehywQrlr7tGmw-0-559ac10377af47a2647641d3db8adfe9)
图2-47 添加调试Profile
步骤5:构建类型为Debug的HAP(带调试签名信息)。打开File→Project Structure,在Modules →entry→Signing Configs→debug窗口中,配置指定模块的调试签名信息,如图2-49所示。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P47_1409.jpg?sign=1739674392-VaJUyDBm3yZ4W4ErwKIbWPUC7S5nThn6-0-492b368bbd3a149a3411cf306f3e9329)
图2-48 所有的证书文件列表
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P47_1413.jpg?sign=1739674392-hL0f9dlWBlabwzEzhrBOPvzAXTEFfcNa-0-99da3637ec2a0ba56ca1aa509af969ed)
图2-49 配置指定模块的调试签名信息
在主菜单栏,单击Build→Build APP(s)/Hap(s)→Build Debug Hap(s),生成已签名的DebugHAP,如图2-50所示。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P48_1423.jpg?sign=1739674392-ZO02aLa0Zb1OSv9TF3yxxLUDIsS9xlDI-0-f35c933aadf9870502f44fcdce670741)
图2-50 生成已签名的Debug HAP
步骤6:运行程序并在真机查看,如图2-51所示。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P48_1427.jpg?sign=1739674392-vokcfLXhECGCl5yGj6aH5dtjW5dYdCqJ-0-fffe5d19c083ff24037a8ac2c6fc1141)
图2-51 通过选择真机运行