HarmonyOS NEXT 原生应用/元服务-自定义运行/调试设置

一、设置调试代码范例
点击Run > Edit Configurations > Debugger，选择相应模块，设置Debug type即可。
 

工程调试范例默以为Detect Automatically，关于各调试范例的阐明如下表所示：
表1 调试范例设置项
 

二、设置HAP安装方式
在调试阶段，HAP在装备上的安装方式有2种，可以根据现实需要进行设置。
安装方式一：先卸载应用/元服务后，再重新安装，该方式会清除装备上的所有应用/元服务缓存数据。
从DevEco Studio 4.1 Canary2版本开始，支持今世码无变化时，不进行推包安装。即根据模块有无变化来判定是否重新推送安装模块包，在运行调试时仅将有变化的模块及依赖它的模块重新推送安装至装备上。如entry依赖了HSP模块，当HSP模块有变化，运行调试时将同时推送安装HSP模块和entry模块。
安装方式二：采用覆盖安装方式，不卸载应用/元服务，该方式会保留应用/元服务的缓存数据。
设置方法如下：
单击Run > Edit Configurations，设置指定模块的HAP安装方式，勾选“Keep Application Data”，则表现采用覆盖安装方式，保留应用/元服务缓存数据。
阐明
从DevEco Studio NEXT Developer Beta1开始，默认勾选“Keep Application Data”。
 

三、设置自定义调试参数
如果未进行自定义，将按默认设置安装和运行应用。如果开辟者需要对应用安装、运行等流程增长参数设置，可在“Installation Options”和“Launch Options”下进行设置。
 

Installation Options
DebugLine Support：勾选Enable DebugLine表现在build产物中系统组件增长debugline属性，用于开启ArkUI Inspector源码跳转功能。
Install Flags：输入bm install下令相关的选项，请参见bm install 参数。如可以设置“-w 360”，表现将超时等待时间设置为360秒。
Launch Options
Launch：指定在安装应用后启动的Ability。
 

Nothing：只安装不启动任何Ability。
Default Ability：默认的EntryAbility。
Stage模型：module.json5文件中设置了“skills”属性的第一个ability；若无设置“skills”属性的ability，则取“mainElement”指定的ability（该ability需存在于“abilities”数组内）；若“mainElement”未指定，则取“abilities”数组内的第一个ability。
 

FA模型：config.json文件中设置了“skills”属性的第一个ability；若无设置“skills”属性的ability，则取“mainAbility”指定的ability（该ability需存在于“abilities”数组内）；若“mainAbility”未指定，则取“abilities”数组内的第一个ability。
Specified Ability：工程中的ExtensionAbility。
您可以在工程中添加ExtensionAbility，如需了解开辟ExtensionAbility，请参阅ExtensionAbility开辟指导。
如果您的工程中包含ExtensionAbility，可以选择Specified Ability，在Ability指定您希望调试的ExtensionAbility进行调试。
 

Launch Flags：输入aa start下令相关的选项，请参见aa start 参数。
四、设置环境变量
如果开辟者需要设置和管理应用开辟环境，以及控制应用步伐的行为，可在“Environment Variables”下设置环境变量。
 

点击

按钮，新增一行设置项。当前支持以下设置项：
ASAN_OPTIONS：在运行时设置ASan的行为，包罗设置检测级别、输出格式、内存错误报告的具体程度等，具体可设置的value请参见表1。若开辟者未设置log_exe_name、abort_on_error，DevEco Studio将主动填充。因NEXT.0.0.68及以上版本的ROM不再需要log_path参数，DevEco Studio 5.0.3.810及以上版本不再主动填充该值，5.0.3.810以下的版本会主动填充。如果需要在NEXT.0.0.68以下版本的ROM中设置ASAN_OPTIONS，请手动设置log_path，否则检测出的内存错误日志无法上报。ASAN_OPTIONS是应用级别的，只在entry和feature模块中设置生效，HAR/HSP模块设置不生效。
阐明
当设置Environment Variables后，“Keep Application Data”覆盖安装不生效。
环境变量设置完成后，需确保环境变量已勾选，勾选后点击Apply才可生效。
 

五、开启非常检测
如需开启非常检测相关能力，请点击Diagnostics。当前支持Runtime Sanitization，勾选Address Sanitizer表现启用ASan功能，具体请参见ASan检测。
 

六、多模块调试
1.安装多个模块
如果一个工程中同一个装备存在多个模块（如存在entry和feature模块），且存在模块间的调用时，在调试阶段需要同时安装多个模块的Hap包到装备中。此时，需要在Deploy Multi Hap中选择多个模块，启动调试时，DevEco Studio会将所有的模块都安装到装备上。
从DevEco Studio V3.1 Release开始支持。
设置方法如下：
单击Run > Edit Configurations，在Deploy Multi Hap中，勾选Deploy Multi Hap Packages，选择多个模块。
 

2.主动安装依赖
如果一个工程中entry/feature/HSP模块直接依赖其他HAR/HSP模块（如entry模块依赖HSP模块）及间接依赖其他模块（如entry模块依赖HAR模块，HAR又依赖HSP模块）时，在调试阶段需要同时安装模块包及其所有依赖模块的包到装备中。此时，可以设置Auto Dependencies，启动调试时会主动将所有依赖的模块都安装到装备上。
从DevEco Studio 4.1 Canary1版本开始支持。
设置方法如下：
单击Run > Edit Configurations，在General中，勾选Auto Dependencies。
 

在Before launch窗格中，您可以点击

添加应用启动前的任务。
 

也可以点击移除

任务。
 

在勾选Auto Dependencies后，可以同时勾选Deploy Multi Hap Packages，从而到达推送所有包的效果。
本文主要参考与引用自HarmonyOS官方文档。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。