HarmonyOS实战-软件开发环境搭建

Posted 何以解忧 `唯有暴富

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了HarmonyOS实战-软件开发环境搭建相关的知识,希望对你有一定的参考价值。

【本文正在参与“有奖征文 | HarmonyOS征文大赛”活动】

DevEco Studio集成开发环境下载,网址如下,因为要开发HarmonyOS应用,选择2.0进行下载下

https://developer.huawei.com/consumer/cn/deveco_studio

下载完毕后,运行安装程序,一路下一步知道安装完成,选择立即重启,重启后运行 

DevEco Studio 2.1.0.501 x64

选择一个位置安装SDK

下一步

等待下载

然后漫长的等待

安装好后新建一个工程,由于华为集成开发环境自带只有手表和相机的模拟器,所以新建Lite工程

运行

使用HarmonyOS系统手机作为调试器,华为官方例程

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ide_debug_device-0000001053822404#ZH-CN_TOPIC_0000001154985555__section837891802519

调试流程

DevEco Studio提供了丰富的HarmonyOS应用调试能力,支持Java、JS、C/C++单语言调试和JS+Java、Java+C/C++跨语言调试能力,同时还支持分布式应用的跨设备调试,帮助开发者更方便、高效的调试应用。

HarmonyOS应用调试支持使用真机设备调试。使用真机设备进行调试前,需要对HAP进行签名后进行调试。详细的调试流程如下图所示。

配置应用签名信息

对应用进行签名

调试应用签名的方式包括如下两种:

  • 方式一:通过DevEco Studio自动化签名的方式对应用进行签名;
  • 方式二:通过从AppGallery Connect中申请调试证书和Profile文件后,再进行签名。

通过DevEco Studio自动化签名的方式更加简单和高效,因此推荐开发者使用自动化签名。关于AppGallery Connect中申请调测证书和Profile的方式,可以参考申请发布证书和Profile文件流程。

  1. 连接真机设备,确保DevEco Studio与真机设备已连接。
  2. 进入File > Project Structure > Project > Signing Configs界面,点击“Sign In”按钮进行登录。

  3. 在AppGallery Connect中创建项目和应用。
    1. 登录AppGallery Connect,创建一个项目。
    2. 在项目中,点击添加应用按钮,创建一个应用。如果是非实名认证的用户,请点击“HAP Provision Profile管理”界面的HarmonyOS应用按钮。
      • 选择平台:选择APP(HarmonyOS应用)。
      • 支持设备:选择调试的设备类型。
      • 应用包名:必须与config.json文件中的“bundleName”取值保持一致。
      • 应用名称、应用分类、默认语言请根据实际需要进行设置。

  4. 返回DevEco Studio的自动签名界面,点击Try Again,即可自动进行签名。自动生成签名所需的密钥(.p12)、数字证书(.cer)和Profile文件(.p7b)会存放到用户user目录下的.ohos\\config目录下。

    说明

    如果是非实名认证用户,需要先接受“HUAWEI Developer Basic Service Agreement”协议。

    设置完签名信息后,点击OK进行保存,然后可以在工程下的build.gradle中查看签名的配置信息。

通过配置文件存储签名信息

(可选)由于签名配置是开发者的私有信息,DevEco Studio会对签名配置中的密码进行安全保护,但是这个保护会对提交build.gradle到代码仓中带来不便。因此,开发者可以将签名配置信息放在一个独立的文件中,从而可以方便的将build.gradle提交到代码仓,而存放签名配置信息的文件不用提交。

  1. 在工程的根目录下创建一个名为signing-config.properties的文件。
  2. 打开signing-config.properties文件,写入签名配置信息。签名配置信息可以从工程的build.gradle文件中进行拷贝,p12、p7b和cer文件存储地址可以自定义。
     
    1. storeFile=D:\\\\key\\\\auto_debug_900086000300430549.p12
    2. storePassword=0000001BA1E0B33A4507FAAD0CD0F378CE4E6AC5AEBDEA75C3283753284436002D859E52C3836DAD3A3D1C
    3. keyAlias=myApplication_debug
    4. keyPassword=0000001BAC7C26C59AC5EB95E56DFC155C911ED08C658839127F4CEC6AB548B39BE8CC499CE7F27F13AE57
    5. profile=D:\\\\key\\\\auto_debug_Myapplication_900086000300430549.p7b
    6. certpath=D:\\\\key\\\\auto_debug_900086000300430549.cer
  3. 打开build.gradle,修改debug或release类型的签名配置信息从signing-config.properties文件中读取。下面是debug类型签名信息的配置示例:
     
    1. apply plugin: 'com.huawei.ohos.hap'
    2. ...
    3. //加载签名信息配置文件
    4. def signingConfigPropsFile = rootProject.file("signing-config")
    5. def signingConfigProps = new Properties()
    6. signingConfigProps.load((new FileInputStream(signingConfigPropsFile)))
    7.  
    8. ohos {
    9. ...
    10. //配置签名信息索引
    11. signingConfigs {
    12. debug {
    13. storeFile file(signingConfigProps['storeFile'])
    14. storePassword signingConfigProps['storePassword']
    15. keyAlias signingConfigProps['keyAlias']
    16. keyPassword signingConfigProps['keyPassword']
    17. signAlg = 'SHA256withECDSA'
    18. profile file(signingConfigProps['profile'])
    19. certpath file(signingConfigProps['certpath'])
    20. }
    21. }
  4. 修改完成后重新同步工程即可。

调试设置

设置调试代码类型

调试类型默认情况下为Detect Automatically,支持Java、JS、C/C++、JS+Java、Java+C/C++工程的调试。只有在JS+Java混合工程中,如果需要单独调试Java代码,这种情况下需要手动修改Debug Type为“Java”。

关于各调试类型的说明如下表所示。

表1 调试类型配置项

调试类型

调试代码

Java Only

仅调试Java代码

Js Only

仅调试javascript代码

Native Only

仅调试C/C++代码

Dual(Js + Java)

调试JS FA调用Java PA场景的JS和Java代码

Dual(Java + Native)

调试C/C++工程的Java和C/C++代码

Detect Automatically

新建工程默认调试器选项,根据调试的工程类型,自动启动对应的调试器。

说明

JS+Java混合工程中,如果需要单独调试Java代码,这种情况下需要手动修改Debug Type为“Java”。

修改调试类型的方法如下。

点击Run > Edit Configurations > Debugger,在HarmonyOS App中,选择相应模块, 可以进行Java/JS/C++调试配置。

检查config.json文件属性

在启动Feature模块的调试前,请检查Feature模块下的config.json文件的abilities数组是否存在“visible”属性,如果不存在,请手动添加,否则Feature模块的调试无法进入断点。Entry模块的调试不需要做该检查。

  1. 在工程目录中,点击Feature模块下的src > main > config.json文件,检查abilities数组是否存在“visible”属性。
    • 存在visible属性,且取值为true:可以正常启动调试
    • 不存在,或者取值为false,请根据2进行设置。
  2. 在abilities数组中手动添加“visible”属性,取值为true。

    说明

    如果Feature模块手动添加了“visible”属性为true,表示该模块可以被其它的应用所调用。如果您不允许该模块被其它应用调用,请在调试完成后手动删除visible属性。

设置Hap包安装方式

在调试阶段,Hap包在设备上的安装方式有2种,您可以根据实际需要进行设置

  • 安装方式一:先卸载应用后,再重新安装,该方式会清除设备上的所有应用缓存数据(默认安装方式)。
  • 安装方式二:采用覆盖安装方式,不卸载应用,该方式会保留应用的缓存数据。

设置方法如下:

点击Run > Edit Configurations,设置指定模块的Hap包安装方式,勾选 ”Replace existing application”,则表示采用覆盖安装方式,保留应用缓存数据。

如果一个工程中同一个设备存在多个模块(如Phone设备,存在entry和feature模块),且存在模块间的调用时,在调试阶段需要同时安装多个模块的hap包到设备中。此时,需要在待调试模块的设置项中勾选“Deploy Multi Hap Package”。例如entry模块调用feature模块,在调试entry模块时,需要同时安装feature模块,您应该在entry模块的调试设置项中勾选“Deploy Multi Hap Package”后再启动调试。

启动调试

  1. 在工具栏中,选择调试的设备,并点击Debug Attach Debugger to Process启动调试。

    说明

    Debug和Attach Debugger的区别在于,Attach Debugger to Process可以先运行应用,然后再启动调试,或者直接启动设备上已安装的应用进行调试;而Debug是直接运行应用后立即启动调试。目前JS代码不支持Attach Debugger to Process调试。

  2. 如果需要设置断点调试,则需要选定要设置断点的有效代码行,在行号(比如:24行)的区域后,单击鼠标左键设置断点(如图示的红点)。

    设置断点后,调试能够在正确的断点处中断,并高亮显示该行。

  3. 启动调试后,开发者可以通过调试器进行代码调试。调试器的功能说明如下表所示。

     

    表2 调试器按钮

    按钮

    名称

    快捷键

    功能

    Resume Program

    F9(Mac为Option+Command+R

    当程序执行到断点时停止执行,点击此按钮程序继续执行。

    Step Over

    F8(Mac为F8

    在单步调试时,直接前进到下一行(如果在函数中存在子函数时,不会进入子函数内单步执行,而是将整个子函数当作一步执行)。

    Step Into

    F7(Mac为F7

    在单步调试时,遇到子函数后,进入子函数并继续单步执行。

    Force Step Into

    Alt+Shift+F7(Mac为Option+Shift+F7

    在单步调试时,强制下一步。

    Step Out

    Shift+F8(Mac为Shift+F8

    在单步调试执行到子函数内时,点击Step Out会执行完子函数剩余部分,并跳出返回到上一层函数。

    Stop

    Ctrl+F2(Mac为Command+F2

    停止调试任务。

    Run To Cursor

    Alt+F9(Mac为Option+F9

    断点执行到鼠标停留处。

对于原子化服务,由于原子化服务在设备中没有桌面图标,可以通过如下方式在设备中运行/调试原子化服务。

  • 在服务中心露出的原子化服务:
    • 通过DevEco Studio的运行/调试按钮,将原子化服务推送到真机设备上安装,安装完成后便可以启动原子化服务;同时在服务中心的最近使用中可以看到该原子化服务的卡片。
    • 通过hdc命令行工具,将原子化服务推送到真机设备上安装,安装完成后便可以启动原子化服务;同时在服务中心的最近使用中可以看到该原子化服务的卡片。
  • 在服务中心不露出的原子化服务:
    • 通过DevEco Studio的运行/调试按钮,将原子化服务推送到真机设备上安装,安装完成后便可以启动原子化服务。
    • 通过hdc命令行工具,将原子化服务推送到真机设备上安装,安装完成后便可以启动原子化服务。
    • 设备控制类的原子化服务,可通过碰一碰、扫一扫等方式运行。

断点管理

在设置的程序断点红点处,点击鼠标右键,然后点击More或按快捷键Ctrl+Shift+F8(Mac为Shift+Command+F8),可以管理断点。

wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==

表3 不同代码类型的断点管理功能

代码类型

断点管理

JS(JavaScript)

普通行断点

Java

  • 普通行断点
  • Exception(异常)断点

C/C++

  • 普通行断点
  • Exception(异常)断点
  • Symbolic(符号)断点

【本文正在参与“有奖征文 | HarmonyOS征文大赛”活动】 

以上是关于HarmonyOS实战-软件开发环境搭建的主要内容,如果未能解决你的问题,请参考以下文章

HarmonyOS之搭建和配置开发环境的流程

鸿蒙-南向轻内核开发实战系列基于小熊派鸿蒙季开发板环境搭建

华为HarmonyOS系统应用软件开发环境搭建

HarmonyOS实战一原子化服务初尝试(ClockFACardDemo学习)

HarmonyOS实战一原子化服务初尝试(ClockFACardDemo学习)

HarmonyOS实战-基础知识