HarmonyOS开发知识指南：软件设备常见功能规范

最新推荐文章于 2024-09-16 08:54:02 发布

不停留的码牛

最新推荐文章于 2024-09-16 08:54:02 发布

阅读量947

点赞数 19

分类专栏： HarmonyOS 鸿蒙 OpenHarmony 文章标签：开发语言 harmonyos 华为 HarmonyOS Next 嵌入式硬件鸿蒙鸿蒙开发

本文链接：https://blog.csdn.net/m0_64422261/article/details/140443952

版权

鸿蒙同时被 3 个专栏收录

166 篇文章 4 订阅

订阅专栏

HarmonyOS

164 篇文章 1 订阅

订阅专栏

OpenHarmony

154 篇文章 1 订阅

订阅专栏

1、编辑器使用技巧

DevEco Studio支持使用多种语言进行应用/服务的开发，包括ArkTS、JS和C/C++。在编写应用/服务阶段，可以通过掌握代码编写的各种常用技巧，来提升编码效率。

代码高亮

支持对代码关键字、运算符、字符串、类、标识符、注释等进行高亮显示，您可以打开File > Settings（macOS为DevEco Studio > Preferences）面板，在Editor > Color Scheme自定义各字段的高亮显示颜色。默认情况下，您可以在Language Defaults中设置源代码中的各种高亮显示方案，该设置将对所有语言生效；如果您需要针对具体语言的源码高亮显示方案进行定制，可以在左侧边栏选择对应的语言，然后取消“Inherit values from”选项后设置对应的颜色即可。

代码自动补齐

提供代码的智能补齐能力，编辑器工具会分析上下文并理解项目内容，并根据输入的内容，提示可补齐的类、方法、字段和关键字的名称等。

自动补齐功能默认按照最近使用过的类、方法、字段和关键字等名称进行排序，如仅需要按最短路径提供补齐内容排序，可以在Settings>Editor>General>Code Completion 中取消勾选"Sort suggestions by recently uesd"。

说明

若已勾选代码补齐按最近使用排序但未生效，请检查Code Completion页面，确保“Sort suggestions alphabetically”已取消勾选。

代码错误检查

如果输入的语法不符合编码规范，或者出现语义语法错误，编辑器会实时的进行代码分析，并在代码中突出显示错误或警告，将鼠标放置在错误代码处，会提示详细的错误信息。

代码自动跳转

在编辑器中，可以按住Ctrl键，鼠标单击代码中引用的类、方法、参数、变量等名称，自动跳转到定义处。若单击定义处的类、变量等名称，当仅有一处引用时，可直接跳转到引用位置；若有多处引用，在弹窗中可以选择想要查看的引用位置。

跨语言跳转

DevEco Studio支持在JS/ArkTS函数上跨语言跳转其对应的C/C++函数，从而提升混合语言开发时的开发效率。您可以在编辑器中右击，在弹出的菜单中选择Go To > Implementation(s)实现跨语言跳转。

代码格式化

代码格式化功能可以帮助您快速的调整和规范代码格式，提升代码的美观度和可读性。默认情况下，DevEco Studio已预置了代码格式化的规范，您也可以个性化的设置各个文件的格式化规范，设置方式如下：在File > Settings > Editor > Code Style（macOS为DevEco Studio > Preferences > Editor > Code Style）下，选择需要定制的文件类型，如ArkTS，然后自定义格式化规范即可。

在使用代码格式化功能时，您可以使用快捷键Ctrl + Alt + L（macOS为Option+Command +L）可以快速对选定范围的代码进行格式化。

如果在进行格式化时，对于部分代码片段不需要进行自动的格式化处理，可以通过如下方式进行设置：

在File>Settings>Editor>Code Style（macOS为DevEco Studio > Preferences > Editor > Code Style），单击“Formatter”，勾选“Turn formatter on/off with markers in code comments”。
在不需要进行格式化操作的代码块前增加“//@formatter:off”，在不格式化代码块的最后增加“//@formatter:on”，即表示对该范围的代码块不需要进行格式化操作。

代码折叠

支持对代码块的快速折叠和展开，既可以单击编辑器左侧边栏的折叠和展开按钮对代码块进行折叠和展开操作，还可以对选中的代码块单机鼠标右键选择折叠方式，包括折叠、递归折叠、全部折叠等操作。

代码快速注释

支持对选择的代码块进行快速注释，使用快捷键Ctrl+/（macOS为Command+/）进行快速注释。对于已注释的代码块，再次使用快捷键Ctrl+/（macOS为Command+/）取消注释。

代码结构树

使用快捷键Alt + 7 / Ctrl + F12（macOS为Command+7）打开代码结构树，快速查看文件代码的结构树，包括全局变量和函数，类成员变量和方法等，并可以跳转到对应代码行。

代码引用查找

提供Find Usages代码引用查找功能，帮助开发者快速查看某个对象(变量、函数或者类等)被引用的地方，用于后续的代码重构，可以极大的提升开发者的开发效率。

使用方法：在要查找的对象上，单击鼠标右键 > Find Usages或使用快捷键Alt +F7（macOS为Command + F7）。

代码查找

通过对符号、类或文件的即时导航来查找代码。检查调用或类型层次结构，轻松地搜索工程里的所有内容。通过连续按压两次Shift快捷键，打开代码查找界面，双击查找的结果可以快速打开所在文件的位置。

快速查阅API接口及组件参考文档

在编辑器中调用ArkTS API接口或ArkTS/JS组件时，支持在编辑器中快速、精准调取出对应的参考文档。

可在编辑器中，选中需要查阅的接口或组件，单击鼠标右键 > Show in API Reference，便可以快速查阅。

说明

DevEco Studio集成了离线版API参考类文档，最新版本请参考官网HarmonyOS API参考和OpenHarmony API参考。

2、在模块中添加Ability

Ability是应用/服务所具备的能力的抽象，一个Module可以包含一个或多个Ability。应用/服务先后提供了两种应用模型：

FA（Feature Ability）模型： API 7开始支持的模型，已经不再主推。
Stage模型：API 9开始新增的模型，是目前主推且会长期演进的模型。在该模型中，由于提供了AbilityStage、WindowStage等类作为应用组件和Window窗口的“舞台”，因此称这种应用模型为Stage模型。
Stage模型包含两种Ability组件类型：
- UIAbility组件：包含UI界面，提供展示UI的能力，主要用于和用户交互。
- ExtensionAbility组件：提供特定场景的扩展能力，满足更多的使用场景。当前仅OpenHarmony工程支持使用ExtensionAbility组件，详细介绍请参见ExtensionAbility概述。

Stage模型添加UIAbility

在模块中添加UIAbility

选中对应的模块，单击鼠标右键，选择New > Ability。

设置Ability名称，选择是否在设备主屏幕上显示该功能的启动图标，单击Finish完成Ability创建。

在模块中添加Extension Ability

在OpenHarmony工程中选中对应的模块，单击鼠标右键，选择New > Extension Ability，选择不同的场景类型。
- Accessibility：用于提供辅助功能业务的能力；
- WorkScheduler：用于提供延迟任务回调实现的能力。
设置Ability名称，单击Finish完成Extension Ability创建。

FA模型添加Ability

ArkTS工程与JS工程在FA模型中添加Ability的操作方式一致，本节内容以ArkTS工程为例介绍在模块中添加Ability。

创建Particle Ability

选中对应的模块，单击鼠标右键，选择New > Ability ，然后选择对应的Data Ability/Service Ability模板。
根据选择的Ability模板，设置Ability的基本信息。
- Ability name：Ability类名称，由大小写字母、数字和下划线组成。
- Language：该Ability使用的开发语言。
单击Finish完成Ability的创建，可以在工程目录对应的模块中查看和编辑Ability。

创建Feature Ability

选中对应的模块，单击鼠标右键，选择New > Ability ，然后选择对应的Page Ability模板。
根据选择的Ability模板，设置Ability的基本信息。
- Ability name：Ability类名称，由大小写字母、数字和下划线组成。
- Launcher ability：表示该Ability在终端桌面上是否有启动图标，一个HAP可以有多个启动图标，来启动不同的FA。
- Language：该Ability使用的开发语言。
- Enable Super Visual：如果选择低代码方式开发，可打开此开关。
单击Finish完成Ability的创建，可以在工程目录对应的模块中查看和编辑Ability。

3、添加JS Component和Page

在支持JS语言的工程中，支持添加新的JS Component（仅支持API Version 4~7）和Page，在支持ArkTS语言的工程中，支持添加Page。

JS Component：在JS工程中，可以存在多个JS Component（例如js目录下的default文件夹就是一个JS Component），一个JS FA对应一个JS Component，可以独立编译、运行和调试。
说明

Lite Wearable和Smart Vision设备对应的JS工程，只存在一个JS FA，因此，Lite Wearable和Smart Vision设备的JS工程不允许创建新的JS Component。
Page：Page是表示Feature Ability的一个前台页面，其中JS工程添加Page后，在pages文件夹下生成新的page文件夹，包含JS、HML和CSS文件，是Component的最基本单元，构成了JS FA的每一个界面。ArkTS语言的工程添加Page后，会在pages文件夹下生成一个新的ets文件。