HamonyOS真机调试的步骤(基于DevEco Studio)

大家好，欢迎来到IT知识分享网。

这是华为官方提供的真机调试文档，刚开始使用真机调试走了不少弯路，现在把我自己使用真机调试的过程记录下来。

1、首先配置应用的签名信息。

第一步：准备签名文件

（1）在菜单栏点击Build—>Generate Key and CSR。

说明：如果本地已有对应的密钥，就无需生成新的密钥，可以在Generate Key界面中点击下方的Skip跳过密钥生成过程，直接使用已有密钥生成证书请求文件。

（2）在Key Store File中，如果已有对应的密钥文件，可以点击Choose Existing去选择；如果没有密钥文件，点击New去创建。

以创建新的密钥文件为例：
在Create Key Store窗口填写密钥库的信息，然后点击OK。

• Key Store File：选择密钥文件的存储路径。
  
  

密钥文件名最好和Alias一致。

• Password：设置密钥库密码，必须由大写字母、小写字母、数字和特殊符号中的两种以上字符的组合，长度至少为8位。请记住该密码，后续签名配置需要使用。
• Confirm Password：再次输入密钥库密码。

（3）完成上述操作后，继续填写其它密钥库信息，全部填写完，点击Next。

• Alias：密钥的别名信息，用于标识密钥名称，记住该别名，后续签名配置需要使用。
• Password：密钥对应的密码，与密钥库密码保持一致，无需手动输入。
• Validity：证书有效期，建议设置为25年及以上，覆盖应用的完整生命周期。
• Certificate：输入证书基本信息，如组织、城市或地区、国家码等。
  
  （4）在Generate CSR界面，选择密钥和设置CSR文件存储路径；点击Finish，创建CSR文件成功，可以在存储路径下获取到生成的密钥文件（.p12文件）和证书请求文件（.csr文件）。
  
  
  
  
  
  

第二步：申请发布证书和Profile文件

HarmonyOS应用通过数字证书（.cer文件）和Profile文件（.p7b文件）来保证应用的完整性，通过生成的证书请求文件，向AppGallery Connect申请发布证书和Profile文件。

（1）登录AppGallery Connect网站去创建一个AGC项目。

• 点击我的项目去添加项目，项目名称自己随便起。
  
  

选择平台APP（HarmonyOS）；支持设备看需求，一般都是应用在手机上；应用名称随便取；应用包名一定要与DevEco Studio对应项目的包名一致；应用分类是游戏就选游戏，应用就选应用；默认语言选择简体中文。

（3）申请发布证书和Profile文件。

2、申请发布证书

1、登录AppGallery Connect网站，在网站里点击“用户与访问”。
2、在左侧导航栏点击”证书管理“，进入”证书管理“页面。

3、点击”新增证书“，弹出”新增证书“窗口，在里面填写要申请的证书信息，点击提交。

4、证书申请成功后，“证书管理”页面展示“证书名称”、“证书类型”,“失效日期”和“操作”列信息。

• 在“操作”列点击“下载”，可下载证书。
• 在“操作”列点击“废除”，且在弹出的“提示”窗口中点击“确认”，可废除证书。

3、申请发布Profile

1. 登录AppGallery Connect网站，在网站首页中点击“我的项目”。
2. 找到您的项目，点击您创建的HarmonyOS应用。
3. 在左侧导航栏选择“HarmonyOS应用 > HAP Provision Profile管理”，进入“管理HAP ProvisionProfile”页面。
   
   
4. 点击右上角”添加“，在弹出的“HarmonyAppProvision信息”窗口中添加Profile。
   
   

5. 发布Profile申请成功后，“管理HAP ProvisionProfile”页面展示“名称”、“类型”、“证书”、“失效日期”和“操作”列信息。

• 在“操作”列点击“下载”，可下载Profile文件。
• 在“操作”列点击“删除”，且在弹出的“提示”窗口中点击“确认”，可删除Profile文件。

4、添加真机调试设备

1、登录AppGallery Connect网站，在网站里点击“用户与访问”。
2、在左侧导航栏点击”设备管理“，进入”设备管理“页面。

3、点击”添加设备“，弹出”添加设备“窗口，在里面填写要申请的证书信息，点击提交。

5、获取设备的udid

• 配置hdc环境变量，将sdk目录下的toolchains路径配置到环境变量的path中。
  
  
• 连接带有HarmonyOS系统的手机，Windows+r打开系统命令行，输入cmd，在里面输入hdc shell bm get -u就得到手机的udid了。
• 

6、配置签名信息

编译构建APP需要使用到制作的私钥（.p12）文件、在AppGallery Connect中申请的证书（.cer）文件和Profile（.p7b）文件。然后在DevEco Studio中对工程进行配置。

在File > Project Structure > Project > Signing Configs > Release窗口中，配置工程的签名信息。

• Store File：选择密钥库文件，文件后缀为.p12。
• Store Password：输入密钥库密码。
• Key Alias：输入密钥的别名信息。
• Key Password：输入密钥的密码。
• Sign Alg：签名算法，固定为SHA256withECDSA。
• Profile File：选择申请的发布Profile文件，文件后缀为.p7b。
• Certpath File：选择申请的发布数字证书文件，文件后缀为.cer。
  
  设置完签名信息后，点击OK进行保存，然后使用DevEco Studio生成APP。点击右上角的绿色三角就可以真机调试了。