╰つ栺尖篴夢ゞ

一、什么是 HarmonyOS ？HarmonyOS 是一款“面向未来”、面向全场景（移动办公、运动健康、社交通信、媒体娱乐等）的分布式操作系统。在传统的单设备系统能力的基础上，HarmonyOS 提出了基于同一套系统能力、适配多种终端形态的分布式理念，能够支持多种终端设备。对消费者而言，HarmonyOS 能够将生活场景中的各类终端进行能力整合，形成一个“超级虚拟终端”，可以实现不同的终端设备之间的快速连接、能力互助、资源共享，匹配合适的设备、提供流畅的全场景体验。对应用开发者而言，Harmony

一、搭建开发环境流程DevEco Studio 支持 Windows 系统和 macOS 系统，在开发 HarmonyOS 应用前，需要准备 HarmonyOS 应用的开发环境。环境准备流程如下所示：如上图所示，搭建 HarmonyOS 应用开发的环境包括软件安装、配置开发环境和运行 HelloWorld 三个环节。二、下载与安装软件① Windows 环境为保证 DevEco Studio 正常运行，电脑配置需满足如下要求：操作系统：Windows10 64位内存：8

一、HarmonyOS APP 工程结构① HarmonyOS 应用的逻辑结构HarmonyOS 应用发布形态为 APP Pack（Application Package，简称APP），它是由一个或多个 HAP（HarmonyOS Ability Package）包以及描述 APP Pack 属性的 pack.info 文件组成。一个 HAP 在工程目录中对应一个 Module，它是由代码、资源、第三方库及应用清单文件组成，可以分为 Entry 和 Feature 两种类型：Entry：应用的

一、导入 Sample 工程① Sample 说明DevEco Studio 支持 HarmonyOS Sample 工程的导入功能，通过对接 Gitee 开源社区中的 Sample 资源，可一键导入 Sample 工程到 DevEco Studio 中。目前，HarmonyOS 和 OpenHarmony 的 Sample 均在同一个 Gitee 仓中，但 OpenHarmony 的 Sample 示例并不适用于 HarmonyOS SDK。在导入时，请不要导入在 Sample 简介中存在 “Th

一、Ability 概述Ability 是应用所具备能力的抽象，也是应用程序的重要组成部分。一个应用可以具备多种能力（即可以包含多个 Ability），HarmonyOS 支持应用以 Ability 为单位进行部署。Ability 可以分为 FA（Feature Ability）和 PA（Particle Ability）两种类型，每种类型为开发者提供了不同的模板，以便实现不同的业务功能。FA 支持 Page Ability：Page 模板是 FA 唯一支持的模板，用于提供与用户交互的能力。一个 P

一、概述① 分布式任务调度在 HarmonyOS 中，分布式任务调度平台对搭载 HarmonyOS 的多设备构筑的“超级虚拟终端”提供统一的组件管理能力，为应用定义统一的能力基线、接口形式、数据结构、服务描述语言，屏蔽硬件差异；支持远程启动、远程调用、业务无缝迁移等分布式任务。分布式任务调度平台在底层实现 Ability（分布式任务调度的基本组件）跨设备的启动/关闭、连接及断开连接以及迁移等能力，实现跨设备的组件管理：启动和关闭：向开发者提供管理远程 Ability 的能力，即支持启动 Page

一、剪贴板概述用户通过系统剪贴板服务，可实现应用之间的简单数据传递。例如：在应用 A 中复制的数据，可以在应用 B 中粘贴，反之亦可。HarmonyOS 提供系统剪贴板服务的操作接口，支持用户程序从系统剪贴板中读取、写入和查询剪贴板数据，以及添加、移除系统剪贴板数据变化的回调。HarmonyOS 提供剪贴板数据的对象定义，包含内容对象和属性对象。二、使用场景同一设备的应用程序 A、B 之间可以借助系统剪贴板服务完成简单数据的传递，即应用程序 A 向剪贴板服务写入数据后，应用程序 B 可以从中

一、ComponentComponent 是所有组件的基类。Component 支持的 XML 属性，其它组件都支持。二、基础属性Component 支持的 XML 的基础属性如下所示： 属性名称 中文描述 取值 取值说明 使用案例 id 控件identity，用以识别不同控件对象，每个控

一、支持的 XML 属性Text 是用来显示字符串的组件，在界面上显示为一块文本区域。Text 作为一个基本组件，有很多扩展，常见的有按钮组件 Button，文本编辑组件 TextField。Text 的共有 XML 属性继承自：Component，详情请参考：HarmonyOS之组件通用的XML属性总览Text 的自有 XML 属性： 我是占位符 我是占位符 我是占位符 我是占位符

一、Button 组件Button 是一种常见的组件，点击可以触发对应的操作，通常由文本或图标组成，也可以由图标和文本共同组成。文本按钮，如下所示：图标按钮，如下所示：图标和文本共同组成的按钮，如下所示：二、支持的 XML 属性Button 无自有的 XML 属性，共有 XML 属性继承自 Text；Text 的自有 XML 属性，请参考我之前的博客：HarmonyOS之深入分析常用组件Text的功能和使用。三、创建 Button创建如下样式的按钮：在 la

一、支持的 XML 属性TextField 的共有 XML 属性继承自：Text。Text 的自有 XML 属性，请参考我之前的博客：HarmonyOS之深入分析常用组件Text的功能和使用。TextField 的自有 XML 属性见下表： 属性名称 中文描述 取值 取值说明 使用案例 basement

一、HiLog 日志HarmonyOS 提供了 HiLog 日志系统，让应用可以按照指定类型、指定级别、指定格式字符串输出日志内容，帮助开发者了解应用的运行状态，更好地调试程序。输出日志的接口由 HiLog 类提供，在输出日志前，需要先调用 HiLog 的辅助类 HiLogLabel 定义日志标签。二、定义日志标签使用 HiLogLabel(int type, int domain, String tag)定义日志标签，其中包括了日志类型、业务领域和 TAG。使用示例： static fi

一、组件与布局HarmonyOS 提供了Ability 和 AbilitySlice 两个基础类，一个有界面的 Ability 可以由一个或多个 AbilitySlice 构成，AbilitySlice 主要用于承载单个页面的具体逻辑实现和界面 UI，是应用显示、运行和跳转的最小单元AbilitySlice 通过 setUIContent 为界面设置布局。AbilitySlice 的 UI 接口：接口声明接口描述setUIContent(ComponentContainer

TableLayout 使用表格的方式划分子组件，如下所示：TableLayout 的共有 XML 属性继承自 Component，详情请参考我之前的博客：HarmonyOS之组件通用的XML属性总览。TableLayout 的自有 XML 属性如下表： 属性名称 中文描述 取值 取值说明 使用案例 align.

一、PositionLayout 说明在 PositionLayout 中，子组件通过指定准确的x/y坐标值在屏幕上显示，(0, 0)为左上角；当向下或向右移动时，坐标值变大；允许组件之间互相重叠。PositionLayout 示意如下：二、布局方式PositionLayout 以坐标的形式控制组件的显示位置，允许组件相互重叠。在 layout 目录下的 XML 文件中创建 PositionLayout 并添加多个组件，并通过 position_x 和 position_y 属性设置子组件

一、AdaptiveBoxLayout 简介AdaptiveBoxLayout 是自适应盒子布局，该布局提供了在不同屏幕尺寸设备上的自适应布局能力，主要用于相同级别的多个组件需要在不同屏幕尺寸设备上自动调整列数的场景。AdaptiveBoxLayout 布局中的每个子组件都用一个单独的“盒子”装起来，子组件设置的布局参数都是以盒子作为父布局生效，不以整个自适应布局为生效范围。AdaptiveBoxLayout 布局中每个盒子的宽度固定为布局总宽度除以自适应得到的列数，高度为 match_conten

一、StackLayout 简介StackLayout 直接在屏幕上开辟出一块空白的区域，添加到这个布局中的视图都是以层叠的方式显示，而它会把这些视图默认放到这块区域的左上角，第一个添加到布局中的视图显示在最底层，最后一个被放在最顶层。上一层的视图会覆盖下一层的视图。StackLayout 示意如下：二、支持的 XML 属性StackLayout 无自有的 XML 属性，共有 XML 属性继承自 Component。详情请参考我之前的博客：HarmonyOS之组件通用的XML属性总览。St

一、DirectionalLayoutDirectionalLayout 是 Java UI 中的一种重要组件布局，用于将一组组件(Component)按照水平或者垂直方向排布，能够方便地对齐布局内的组件。该布局和其他布局的组合，可以实现更加丰富的布局方式。DirectionalLayout 示意如下：二、支持的 XML 属性DirectionalLayout 的共有 XML 属性继承自 Component，详情请参考我之前的博客：HarmonyOS之组件通用的XML属性总览。Direct

一、DependentLayout 简介DependentLayout 是 Java UI 系统里的一种常见布局。与DirectionalLayout 相比，拥有更多的排布方式，每个组件可以指定相对于其他同级元素的位置，或者指定相对于父组件的位置。DirectionalLayout 布局方式，请参考我的博客：HarmonyOS之常用布局DirectionalLayout的使用。DependentLayout 布局示意如下：二、支持的 XML 属性DependentLayout 的共有 XM

一、概述HarmonyOS 提供了一套复杂且强大的 Java UI 框架，其中 Component 提供内容显示，是界面中所有组件的基类。ComponentContainer 作为容器容纳 Component 或 ComponentContainer 对象，并对它们进行布局。Java UI 框架也提供了一部分 Component 和 ComponentContainer 的具体子类，即常用的组件（比如：Text、Button、Image 等）和常用的布局（比如：DirectionalLayout、De

一、概述动画是组件的基础特性之一，精心设计的动画使UI变化更直观，有助于改进应用程序的外观并改善用户体验。Java UI 框架提供了帧动画、数值动画和属性动画，并提供了将多个动画同时操作的动画集合。二、帧动画帧动画是利用视觉暂留现象，将一系列静止的图片按序播放，给用户产生动画的效果。在“Project”窗口，打开“entry > src > main > resources > base > media”，添加一系列图片至“media”目录下：在“gra

一、支持的 XML 属性Image 的共有 XML 属性继承自 Component，详情请参考我的博客：HarmonyOS之组件通用的XML属性总览。Image 的自有 XML 属性见下表： 属性名称 中文描述 取值 取值说明 使用案例 clip_alignment 图像裁剪对齐方式

一、ScrollView 功能ScrollView 是一种带滚动功能的组件，它采用滑动的方式在有限的区域内显示更多的内容。二、支持的 XML 属性ScrollView 的共有 XML 属性继承自 StackLayout，StackLayout 详情请参考我的博客：HarmonyOS之常用布局StackLayout的使用。ScrollView 的自有 XML 属性见下表：属性名称中文描述取值取值说明使用案例match_viewport是否拉伸匹配boolean类

一、什么是 Tablist 与 Tab ？Tablist 可以实现多个页签栏的切换，Tab 为某个页签。子页签通常放在内容区上方，展示不同的分类。页签名称应该简洁明了，清晰描述分类的内容。二、支持的 XML 属性...

一、码生成码生成能够根据开发者给定的字符串信息和二维码图片尺寸，返回相应的二维码图片字节流。调用方可以通过二维码字节流生成二维码图片。二、约束与限制当前仅支持生成 QR 二维码（Quick Response Code）。由于 QR 二维码算法的限制，字符串信息的长度不能超过2953个字符。生成的二维码图片的宽度不能超过 1920 像素，高度不能超过 1680 像素。由于 QR 二维码是通过正方形阵列承载信息的，建议二维码图片采用正方形，当二维码图片采用长方形时，会在 QR 二维码信息的周边

一、通用文字识别技术通用文字识别的核心技术是 OCR（Optical Character Recognition，光学字符识别）。OCR 是一种通过拍照、扫描等光学输入方式，把各种票据、卡证、表格、报刊、书籍等印刷品文字转化为图像信息，再利用文字识别技术将图像信息转化为计算机等设备可以使用的字符信息的技术。二、约束与限制支持处理的图片格式包括 JPEG、JPG、PNG。通用文字识别目前支持的语言有：中文、英文、日语、韩语、俄语、意大利语、西班牙语、葡萄牙语、德语，以及法语（将来会增加更多语种

一、基本概念针对图片分辨率不足的问题，传统的解决方案是使用双线性或双三次插值的方法来放大图像；而针对图片压缩噪声的问题，传统的解决方案则是通过各种算法实现平滑、去噪。本 SDK 使用智能的方法，基于深度神经网络，依托硬件的神经网络加速器，提供适用于移动终端的1x和3x超分能力；1x超分可以去除图片的压缩噪声，3x超分在有效抑制压缩噪声的同时，提供3倍的边长放大能力。“超分”，即单张图片空间域超分辨率（SISR：Single Image Super-Resolution），指给定单张图片，使用智能方法

一、概念在日常生活中充满了各种各样的信息，这些信息千变万化。文本语言作为信息传递的一种载体，同样面临有用信息和无用信息糅杂在一起的问题。关键字提取帮助用户在众多文本信息中快速提取出关键信息和核心内容，节省时间提高效率。关键字提取 API 提供了一个提取关键字的接口，通过该 API 可以在大量信息中提取出文本想要表达的核心内容，可以是具有特定意义的实体，如：人名，地点，电影等，也可以是一些基础但是在文本中很关键的词汇。通过该 API 可以对提取的关键字按照在文本中所占权重由高到低排序。排序越靠前，权重

一、概念语音播报（Text to Speech，下文简称 TTS），基于华为智慧引擎（HUAWEI HiAI Engine）中的语音播报引擎，向开发者提供人工智能应用层 API。该技术提供将文本转换为语音并进行播报的能力。支持超长文本播报，最大文本长度为 100000 个字符。语音播报不支持多线程调用。二、应用场景实时语音交互：生成音频信息用于语音交互。例如：与智能音箱或手机智能助手的交互，后台会将回答信息以音频方式进行语音播报。超长文本播报：用于小说、新闻等较长文本的自动朗读。三、A

一、基本概念语音识别功能提供面向移动终端的语音识别能力。它基于华为智慧引擎（HUAWEI HiAI Engine）中的语音识别引擎，向开发者提供人工智能应用层 API。该技术可以将语音文件、实时语音数据流转换为汉字序列，准确率达到 90% 以上（本地识别 95%）。语音识别技术，也称为自动语音识别（Automatic Speech Recognition, ASR），可以基于机器识别和理解，将语音信号转变为文本或命令。语音识别支持的输入文件格式有 wav 或 pcm。语音识别当前仅支持对普通话的识

一、简介实体识别能够从自然语言中提取出具有特定意义的实体，并在此基础上完成搜索等一系列相关操作及功能。实体识别覆盖范围大，能够满足日常开发中对实体识别的需求，让应用体验更好。识别准确率高，能够准确地提取到实体信息，对应用基于信息的后续服务形成关键影响。实体识别当前只支持中文语境。实体识别文本限制在 500 个字符以内，超过字符数限制将返回参数错误；文本需要为 UTF-8 格式，格式错误不报错，但会导致分析结果错误。Engine 支持多用户同时接入，但是不支持同一用户并发调用同一个特性，如同一个特

一、简介文字图像超分辨率可以对包含文字内容的图像进行 9 倍放大（高宽各放大 3 倍），同时增强图像内文字的清晰度，称为“文字图像超分辨率”，简称“文字图像超分”。本超分算法 SDK 基于深度神经网络开发，使用本 SDK 可以节省算法开发的时间，节省算法模型占用的 ROM 空间，让应用更加轻便。文字图像超分辨率支持处理的图片格式包括 JPEG、JPG、PNG，最终输出的图片仅支持 JPEG 格式。文字图像超分辨率输入图片分辨率（长宽之积）应不大于 134 万像素，并且宽高均不小于 506 像素。

一、简介随着人机交互越来越普遍，设备需要理解用户下达的各种指令，方便用户的操作。助手类意图识别能够利用机器学习技术，对用户发送给设备的文本消息进行语义分析和意图识别，进而衍生出各种智能的应用场景，使设备更智慧、更智能。助手类意图识别当前只支持中文语境。助手类意图识别文本限制在 50 个字符以内，超过字数将返回参数错误。文本要求 UTF-8 格式，如果格式错误不会引发报错，但将导致分析结果不正确。Engine 支持多用户同时接入，但是不支持同一用户并发调用同一特性。若同一特性被同一进程同一时间多次

一、基本概念文档校正提供了文档翻拍过程的辅助增强功能，包含两个子功能：文档检测和文档校验。文档检测：能够自动识别图片中的文档，返回文档在原图中的位置信息。这里的文档泛指外形方正的事物，比如书本、相片、画框等。文档校正：能根据文档在原始图片中的位置信息校正文档的拍摄角度，自动将拍摄视角调整到正对文档的角度上。二、运作机制① 文档检测调用文档检测接口，识别图片中的文档，返回文档在原图中的位置信息；如下图中的红点所示，文档检测接口返回了图中相片文档四个顶点相对图像左上角的坐标信息：文档

一、基本概念随着信息技术的发展，网络中的信息量成几何级增长逐步成为当今社会的主要特征。准确提取文本关键信息，是搜索引擎等领域的技术基础，而分词作为文本信息提取的第一步则尤为重要。分词作为自然语言处理领域的基础研究，衍生出各类不同的文本处理相关应用。分词模块提供了文本自动分词的接口，对于一段输入文本，可以自动进行分词，同时提供不同的分词粒度。开发者可以根据需要自定义分词粒度。分词当前只支持中文语境。分词文本限制在 500 个字符以内，超过字符数限制将返回参数错误。文本需要为 UTF-8 格式，格式

一、基本概念IM 类意图识别，是指利用机器学习技术，针对用户短信或聊天类 APP 等 IM 应用的文本消息进行内容分析，并识别出消息内容代表的用户意图。基于语义分析，利用机器学习的相关技术识别并理解用户消息的意图，通过IM意图识别，可以衍生出各种智能的应用场景，使智能设备更聪明，更懂用户。基于 IM 意图识别接口，可以对文本消息中包含的用户意图进行自动分析识别。目前仅开放支持通知消息类的三个意图的智能识别（称为“意图模块”），包括：还款提醒通知还款成功通知未接来电通知

一、简介随着信息技术的发展，网络中的信息量成几何级增长逐步成为当今社会的主要特征。准确提取文本关键信息，是搜索引擎等领域的技术基础，而分词作为文本信息提取的第一步则尤为重要。分词作为自然语言处理领域的基础研究，衍生出各类不同的文本处理相关应用。词性标注包括分词以及为分词结果中的每个单词标注一个正确的词性（标注每个词是名词、动词、形容词或其他词性），开发者可自定义分词的粒度。词性标注提供了文本自动分词并给出词性的接口。对于输入的一段文本，自动通过词性标注接口对其进行分词，并为分词结果中的每个单词标注

一、电话服务电话服务系统提供了一系列的 API 用于获取无线蜂窝网络和 SIM 卡相关的一些信息。应用可以通过调用 RadioInfoManager 中的 API，来获取当前注册网络名称、网络服务状态以及信号强度等信息；以及调用 SimInfoManager 中的 API，来获取 SIM 卡的相关信息。注册获取 SIM 卡状态接口仅针对有 SIM 卡在位场景生效，若用户拔出 SIM 卡，则接收不到回调事件。应用可通过调用 hasSimCard 接口来确定当前卡槽是否有卡在位。二、获取当前蜂窝网络

一、简介NFC（Near Field Communication，近距离无线通信技术) 是一种非接触式识别和互联技术，让移动设备、消费类电子产品、PC 和智能设备之间可以进行近距离无线通信。HarmonyOS 的 NFC 提供的功能有：NFC 基础查询：在进行 NFC 功能开发之前，开发者应该先确认设备是否支持 NFC 功能、NFC 是否打开等基本信息。访问安全单元（Secure Element，简称为 SE）：SE 可用于保存重要信息，应用可以访问指定 SE，并发送数据到 SE 上。

一、WLAN 简介无线局域网（Wireless Local Area Networks，WLAN），是通过无线电、红外光信号或者其他技术发送和接收数据的局域网，用户可以通过 WLAN 实现结点之间无物理连接的网络通讯。常用于用户携带可移动终端的办公、公众环境中。HarmonyOS WLAN 服务系统为用户提供 WLAN 基础功能、P2P（peer-to-peer）功能和 WLAN 消息通知的相应服务，让应用可以通过 WLAN 和其他设备互联互通。本开发指南提供多个开发场景的指导，涉及多个 API 接