![鸿蒙操作系统开发入门经典](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=1739544691-MRqhkq1Cygag2RpPPDUHDNEFGlR5asqX-0-17198d24982abae8ea44b04e54a0d125)
图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=1739544691-Qe8MmtWGq3i4RBGeszjDOHxs8e9lNIDZ-0-bac6e50d44567baed10c4cffa667c434)
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P41_1282.jpg?sign=1739544691-vDebggzDLHzmhnZH4gcj3PI9EWbXBEAC-0-f0c6b9c1a066f4d7133908a3a128f776)
图2-31 解压后的目录
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P41_1285.jpg?sign=1739544691-4GG5ysFzCkcJkzagu4elizjnaL6tMIoh-0-c12aafa8682c158dc1bf9311e6bd5706)
图2-32 通过USB数据线连接
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P41_1289.jpg?sign=1739544691-ZxfugkPWLibehaOFLMcASqF1d728Z5Fo-0-841047551f5f84c95181ab350abeaed0)
图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=1739544691-r2uQG8v7nyTg4oEWQZEJrSHWL8dr9TKk-0-5e9a38453f9187cce76cdf8198f0a96b)
图2-34 真机设备测试流程
申请真机测试的流程相对比较复杂,开发人员可按照下面的步骤完成申请流程。
步骤1:创建HarmonyOS应用项目。首先需要创建一个鸿蒙应用项目,通过DevEco Studio创建,如图2-35所示。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P42_1309.jpg?sign=1739544691-gXNQIJYuQbCZjUl6dMWuAdwfEmY2RG21-0-2a5c4d11312b0f1c7de3d62bff719fa0)
图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=1739544691-J5c1xZcvuuJRbUXdZsbQgWlB5p97QsGn-0-a6eb02246983499673d1327b59d16e58)
图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=1739544691-DpddDgC4FdDt0QLOep4Rw6xC2fUfu9Rs-0-54ef4cdbfa5b5c4745f9435f9ed970f8)
图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=1739544691-G4CSxyL2eoD5GiIEaumqrwqDH0TquaM8-0-c5dfb2f39cc4f529666f542884801bbe)
图2-38 保存csr文件
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P44_1339.jpg?sign=1739544691-0m4N6Wy66zmBJnEWK2fH9sy2zQn5rVgK-0-644ceaf1ad97736c7b99e6761c71243e)
图2-39 生成的(.p12)和证书请求文件(.csr)
步骤3:申请应用调试证书。登录AppGallery Connect网站,选择“用户与访问”,如图2-40所示。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P44_1345.jpg?sign=1739544691-gr7ttsyld2Y05v6VlJg4awXx6D6w3eL7-0-9d97afa4e429d5e28d635322a4e9c0f5)
图2-40 选择“用户与访问”
在左侧导航栏选择“证书管理”,进入证书管理页面,单击“新增证书”按钮,如图2-41所示。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P44_1349.jpg?sign=1739544691-yYYHIrbWTFXi7LXWozkum07pC8J2ltLm-0-10aebbd1f644ae9562114d3c356903ab)
图2-41 选择“新增证书”按钮
在弹出的“新增证书”窗口,填写要申请的证书信息,填写完毕后单击“提交”按钮,如图2-42所示。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P45_1355.jpg?sign=1739544691-IGH7oR0mnJNgp8CrDoKJGknAxARs2hGP-0-ecc2c5106f2249ce329d9b4a8d261d35)
图2-42 填写证书信息
在左侧导航栏选择“设备管理”,进入设备管理页面,单击右上角的“添加设备”按钮,如图2-43所示。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P45_1359.jpg?sign=1739544691-2IQH6PWW45drH5PkW6ctxrUF6jTdWB1Y-0-28991bf29baa827db50e6af61760f650)
图2-43 选择“添加设备”
在弹出的窗口中填写设备信息,填写完毕后需单击“提交”按钮,如图2-44所示。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P45_1363.jpg?sign=1739544691-NMjW0Z2Cx4xpt3HUbdcBBpGKUZiCFDV1-0-aa2719f4548a805a5cff35e35d603b54)
图2-44 填写设备信息
通过adb命令查看UDID信息,命令如下:
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P46_25485.jpg?sign=1739544691-e2pvn8LH0wyzvcRCbi8JZUe0ca6K8Gay-0-6e2ce3f274610732f0e4115f1e0a3ee9)
步骤4:申请应用调试证书和Profile。登录AppGallery Connect网站,选择“我的项目”,如图2-45所示。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P46_1383.jpg?sign=1739544691-8h7WLc4pKzOSaHCBZwZuju7OuWTSftz0-0-9f2baff289b917d19702dff595f00591)
图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=1739544691-lESm3GhbaBd6dQWfXJ4r5MUK8qzew0u6-0-0f8575ffe1052579e0fb099d8320b7fe)
图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=1739544691-lbKuq9JFOQ4WZOoPHi0YdQetOOn3ggXJ-0-e803ff57f3768c2ad8425a82a4c6bc42)
图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=1739544691-3JruE21YsGmXzlAcEyiRQ64iPq3i0wMF-0-1a33d016e9a834768c56e46df0d9d32c)
图2-48 所有的证书文件列表
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P47_1413.jpg?sign=1739544691-Ma7y12gHrZvdOkAzJrVVSOMkua98N205-0-75ed277ff4352b70a1f0b6223ddad34a)
图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=1739544691-crBeIBk1TnF9yCaXOl3TwQL5Ec0nwqmO-0-bd1013485e7a68949de5ed6f69058c97)
图2-50 生成已签名的Debug HAP
步骤6:运行程序并在真机查看,如图2-51所示。
![](https://epubservercos.yuewen.com/00C4B0/23721626401016106/epubprivate/OEBPS/Images/Figure-P48_1427.jpg?sign=1739544691-fs7kclqBsDEM67BeSnWuBGcWRPFxc8xh-0-3f683431c1771a2b2039abeac5bbf83c)
图2-51 通过选择真机运行