HarmonyOS（鸿蒙）——全面入门，始于而不止于HelloWorld
Posted 李子捌
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了HarmonyOS（鸿蒙）——全面入门，始于而不止于HelloWorld相关的知识，希望对你有一定的参考价值。
目录
一、前言
大多数程序员学习一门编程语言的第一个程序都是HellWorld，虽然HarmonyOS（鸿蒙）并不是一门编程语言，但是我们仍然通过一个HelloWorld程序来全面学习和了解HarmonyOS（鸿蒙）。
文中并不是仅仅教你搭建一个HarmonyOS（鸿蒙）的HelloWorld的应用程序，那样一点意义也没有，而是通过如下四个方面，全面的讲解HarmonyOS（鸿蒙）的入门的必备知识点。
二、创建并运行项目
通过创建一个HelloWorld项目，运行起来之后，再来分析入门鸿蒙开发需要掌握的一些知识点。如您想直接通过官网学习，我这里给您贴出官网地址，或者你也可以先根据我的文章内容，看看是否对鸿蒙开发感兴趣再去官网认真学习！
知识官网地址：
https://developer.harmonyos.com/cn/docs/documentation/doc-guides/tools_overview-0000001053582387
2.1 创建项目
打开开发工具DevEco Studio，选择File -> New -> New Project
选择ability模板，我们这里选择Empty Ability(Java)
填写项目名称Project Name，包名称Package Name，项目存储路径Save Location，设备类型 Device Type(我这里选择的是手机Phone)，最后点击Finish!
项目创建完毕后将会看到如下工程
2.2 开启远程模拟器
harmonyOS现在项目开发暂时只支持远程调试，因此我们需要通过登录华为账号（这个账号没有的可以先去实名认证一下，我的上篇文章有详细的介绍！），开启模拟器进行预览调试，每次调试的时间为一个小时，一小时之后会回收资源，如果有需要重启开启即可！
选择Tools -> Device Manager，进入设备选择界面
点击Login，会自动打开浏览器，进入登录页面
通过认证的账户密码进行登录
登录时弹出授信，我们点击允许即可！
接下来会看到如下页面，这样代表登录成功，但是并不意味着远程模拟器开启成功了！
此时回到DevEco Studio的控制台，看到如下输出则代表成功！如果输出的时Login Fail，这个时候我们去浏览器清空session，然后重新点击上面的Login进行再次登录即可！
登录成功后选择P40，点击右边绿色的启动按钮！
此时DevEco Studio的右边会出现P40的远程模拟器，我们开发的代码将会在这个上面展示，手机最上面时每次调试的时间倒计时，时间到了重新开启远程模拟器即可！
2.3 运行项目
点击右上角的三角形直接运行项目，或者点击甲壳虫进入调试模式都可以，点击后项目会通过Gradle进行构建，需要等待一会儿。
此时远程模拟器展示项目输出——“你好，世界”，第一个项目运行成功！
输出内容的修改路径在src->main->resources->zh->element->string.json
三、Ability&页面的初步认识
3.1、简介
3.1.1 什么是页面
信息以页面信息组织，信息页面由语言来实现，在各个信息页面之间建立超文本链接以便浏览，这就是页面。页面一般包括：文本、图像、表格、超链接等基本元素。
3.1.2 HarmonyOS（鸿蒙）中的页面
当我们打开手机App之后看到的都是页面！
在HarmonyOS中，一个页面可以被当做一个Ability，更准确的说是Page Ability中的AbilitySlice（指应用的单个页面及其控制逻辑的总和），这里先简单介绍Ability。
3.2、Ability
3.2.1 简介
Ability是应用所具备能力的抽象（我感觉也可以理解为模板，模块），也是应用程序的重要组成部分。一个应用可以具备多种能力（即可以包含多个Ability），HarmonyOS支持应用以Ability为单位进行部署。
Ability分为两种：
- FA（Feature Ability）
- PA（Particle Ability）
| Ability类型 | 支持模板 | 描述 |
|---|---|---|
| Feature Ability | Page Ability | Page模板：用于提供与用户交互的能力。一个Page实例可以包含一组相关页面，每个页面用一个AbilitySlice实例表示。 |
| Particle Ability | Service Ability和Data Ability | Service模板：用于提供后台运行任务的能力。
Data模板：用于对外部提供统一的数据访问抽象。 |
3.2.2 Page Ability
Page Ability是 Feature Ability唯一支持的模板。
用于提供与用户的交互能力，其实就是页面的父级。一个Page可以由一个或多个AbilitySlice构成，AbilitySlice是指应用的单个页面及其控制逻辑的总和。官方认为当一个Page由多个AbilitySlice共同构成时，这些AbilitySlice页面提供的业务能力应具有高度相关性。
HarmonyOS支持不同Page之间的跳转，并可以指定跳转到目标Page中某个具体的AbilitySlice。
3.2.3 Service Ability
Service Ability是 Particle Ability支持的模板之一。
用于后台运行任务（如执行音乐播放、文件下载等），但不提供用户交互界面。Service可由其他应用或Ability启动，即使用户切换到其他应用，Service仍将在后台继续运行。
Service是单实例的。在一个设备上，相同的Service只会存在一个实例。如果多个Ability共用这个实例，只有当与Service绑定的所有Ability都退出后，Service才能够退出。由于Service是在主线程里执行的，因此，如果在Service里面的操作时间过长，开发者必须在Service里创建新的线程来处理，防止造成主线程阻塞，应用程序无响应。
如下是HarmonyOS线程间通信开发概述官网地址：
3.2.4 Data Ability
Data Ability是 Particle Ability支持的模板之一。
用于应用管理其自身和其他应用存储数据的访问，并提供与其他应用共享数据的方法。Data既可用于同设备不同应用的数据共享，也支持跨设备不同应用的数据共享。数据的存放形式多样，可以是数据库，也可以是磁盘上的文件。Data对外提供对数据的增、删、改、查，以及打开文件等接口，这些接口的具体实现由开发者提供。
3.3、HarmonyOS页面的设计
3.3.1 原子化服务与HAP简介
HarmonyOS中的应用与传统App应用有一个很大的亮点，HarmonyOS提供了一种面向未来的服务提供方式，原子化服务。
原子化服务可以免安装（无需显示安装，由系统后台按需主动安装非常方便），它支持运行在1+8+N设备上。
原子化服务与传统的App应用对比如下：
| 项目 | 原子化服务 | 传统App应用 |
|---|---|---|
| 件包形态 | APP Pack（.app） | APP Pack（.app） |
| 分发平台 | 由原子化服务平台（Huawei Ability Gallery）管理和分发 | 由应用市场（AppGallery）管理和分发 |
| 安装后有无桌面icon | 无桌面icon，但可手动添加到桌面，显示形式为服务卡片 | 有桌面icon |
| HAP包免安装要求 | 所有HAP包（包括Entry HAP和Feature HAP）均需满足免安装要求 | 所有HAP包（包括Entry HAP和Feature HAP）均为非免安装的 |
官网地址：
原子化服务由HAP包组成，HAP是Ability的部署包，HarmonyOS应用代码围绕Ability组件展开。一个HAP是由代码、资源、第三方库及应用配置文件组成的模块包，可分为entry和feature两种模块类型。
详细内容可以查看官网：
https://developer.harmonyos.com/cn/docs/documentation/doc-guides/basic-fundamentals-0000000000041611
一个原子化服务可以有一个或者多个HAP组成，而一个HAP对应1个FA或者1个PA，每个FA或PA均可独立运行，完成1个特定功能；1个或多个功能（对应FA或PA）完成1个特定的便捷服务。
所以HarmonyOS的App安装包的结构示意图如下：
3.3.2 可分可合思想
根据3.1中HarmonyOS的App安装包的结构可知，一个HarmonyOS安装包可以由任意需要的一个或者多个HAP组成，这里的组成是可以选择的，可以根据用户需求和硬件设备做合理的选择进行应用组合。
打个比方使用搭载HarmonyOS系统的电视和手机分别可以具有如下的一些功能：
HarmonyOS电视机：
HarmonyOS手机：
电视机没有短信和通话的功能，但是它拥有控制频道切换的功能，因此可以安装控制频道.HAP；而手机拥有短信和通话的功能，因此可以安装短信.HAP和通过.HAP。两者都拥有游戏的功能，因此均可以安装游戏.HAP。因此HarmonyOS的HAP安装包，可以根据用户的实际需求或者硬件设施进行合理的安装，实现安装包的可分可合思想。
针对不同的功能，建议统一写入同一个HAP中，比如短信.HAP，这样可以减少用户使用某一个特定功能的时候，系统下载安装包的复杂度或者用户字段安装的复杂度。
3.3.3 HAP中的Ability
针对上面的游戏.HAP，比如说是男人就下一百层，我们会开发一个Ability，它会存在很多子功能，比如登录、注册、游戏、装备、聊天、等等。这些不同的功能都可以整合到不同的AbilitySlice中，一个AbilitySlice对应一个页面。
游戏.HAP的Ability与其AbilitySlice关系图如下：
登录、注册、游戏、装备、聊天、等等AbilitySlice统一加入一个Ability中，不同的AbilitySlice之间可以实现跳转，最终打包成一个可以运行的游戏.HAP
四、配置文件Config.json了解
4.1、简介
4.1.1 结构
应用的每个HAP的根目录下都存在一个“config.json”配置文件。文件内容主要涵盖以下三个方面：
如下是一个简单的HarmonyOS应用程序创建后所看到的应用代码结构，entry -> src -> main -> config.json文件。其中三个模块分别为app、deviceConfig、module（我这里展示的三块是缩放后的内容。）
4.1.2 编辑视图
config.json文件采用JSON文件格式，其每一项都包含都由一个属性和值组成。其中属性值不分先后顺序，但是不能重复出现，必须唯一。值为JSON的基本数据类型。HarmonyOS的DevEco Studio支持两种编辑config.json的方式，分别是代码编辑视图和可视化编辑视图。
代码编辑视图：
可视化编辑视图：
4.2、配置文件详细介绍
配置文件由app、deviceConfig、module三部分组成，三者均必须存在。以下会根据上面的HarmonyOS的基础HelloWorld程序分析一个最基础的config.json配置文件，如果需要十分详细的介绍，请直接去HarmonyOS的官网进行查阅，以下是直达的官网地址：
4.2.1 app
app对象包含应用的全局配置信息，HarmonyOS的基础HelloWorld程序的config.json配置文件中的app部分如下所示：
"app": {
"bundleName": "com.example.demo",
"vendor": "example",
"version": {
"code": 1000000,
"name": "1.0.0"
}
}
| 属性名称 | 子属性名称 | 含义 | 数据类型 | 是否可缺省 |
|---|---|---|---|---|
| bundleName | - | 表示应用的包名，用于标识应用的唯一性。 | 字符串 | 否 |
| vendor | - | 表示对应用开发厂商的描述。字符串长度不超过255字节。 | 字符串 | 可缺省，缺省值为空。 |
| version | - | 表示应用的版本信息。 | 对象 | 否 |
| code | 表示应用的版本号，仅用于HarmonyOS管理该应用，不对应用的终端用户呈现。 | 数值 | 否 | 数值 | 否 | |
| name | 表示应用的版本号，用于向应用的终端用户呈现。小于127个字节。 | 字符串 | 否 |
4.2.2 deviceConfig
deviceConfig包含在具体设备上的应用配置信息，可以包含default、phone、tablet、tv、car、wearable、liteWearable和smartVision等属性。default标签内的配置是适用于所有设备通用，其他设备类型如果有特殊的需求，则需要在该设备类型的标签下进行配置。HarmonyOS的基础HelloWorld程序的config.json配置文件中的deviceConfig部分如下所示：
"deviceConfig": {}
4.2.3 module
module对象包含HAP包的配置信息，包含每个Ability必须定义的基本属性（如包名、类名、类型以及Ability提供的能力），以及应用访问系统或其他应用受保护部分所需的权限等。HarmonyOS的基础HelloWorld程序的config.json配置文件中的module部分如下所示：
"module": {
"package": "com.example.demo",
"name": ".MyApplication",
"mainAbility": "com.example.demo.MainAbility",
"deviceType": [
"phone"
],
"distro": {
"deliveryWithInstall": true,
"moduleName": "entry",
"moduleType": "entry",
"installationFree": true
},
"abilities": [
{
"skills": [
{
"entities": [
"entity.system.home"
],
"actions": [
"action.system.home"
]
}
],
"orientation": "unspecified",
"name": "com.example.demo.MainAbility",
"icon": "$media:icon",
"description": "$string:mainability_description",
"label": "$string:entry_MainAbility",
"type": "page",
"launchType": "standard"
}
]
}
| 属性名称 | 子属性名称 | 含义 | 数据类型 | 是否可缺省 |
|---|---|---|---|---|
| package | - | 表示HAP的包结构名称，在应用内应保证唯一性。采用反向域名格式（建议与HAP的工程目录保持一致）。字符串长度不超过127字节。 | 字符串 | 否 |
| name | - | 表示HAP的类名。采用反向域名方式表示，前缀需要与同级的package标签指定的包名一致，也可采用“.”开头的命名方式。字符串长度不超过255字节。 | 字符串 | 否 |
| mainAbility | - | 表示HAP包的入口ability名称。 | 字符串 | page类型的Ability为否 |
| deviceType | - | 表示允许Ability运行的设备类型。系统预定义的设备类型包括：phone（手机）、tablet（平板）、tv（智慧屏）、car（车机）、wearable（智能穿戴）、liteWearable（轻量级智能穿戴）等。 | 字符串数组 | 否 |
| distro | - | 表示HAP发布的具体描述 | 对象 | 否 |
| deliveryWithInstall | 表示当前HAP是否支持随应用安装。
| 布尔类型 | 否 | |
| moduleName | HAP的名称 | 字符串 | 否 | |
| moduleType | 表示当前HAP的类型，包括两种类型：entry和feature | 字符串 | 否 | |
| installationFree | 表示当前该FA是否支持免安装特性。
| 布尔类型 | entry.hap可缺省，feature.hap不可缺省。 | |
| abilities | - | 表示当前模块内的所有Ability。采用对象数组格式，其中每个元素表示一个Ability对象。 | 对象数组 | 是 |
| skills | 表示Ability能够接收的Intent的特征。 | 对象数组 | 是 | |
| orientation | 表示该Ability的显示模式。该标签仅适用于page类型的Ability。取值范围如下：
| 字符串 | 是 | |
| name | 表示Ability名称。取值可采用反向域名方式表示，由包名和类名组成，如“com.example.myapplication.MainAbility”；也可采用“.”开头的类名方式表示，如“.MainAbility”。该标签仅适用于手机、平板、智慧屏、车机、智能穿戴。 | 字符串 | 否 | |
| icon | 表示Ability图标资源文件的索引。取值示例：$media:ability_icon。如果在该Ability的“skills”属性中，“actions”的取值包含 “action.system.home”，“entities”取值中包含“entity.system.home”，则该Ability的icon将同时作为应用的icon。如果存在多个符合条件的Ability，则取位置靠前的Ability的icon作为应用的icon。 | 字符串 | 是 | |
| description | 表示对Ability的描述。取值可以是描述性内容，也可以是对描述性内容的资源索引，以支持多语言。 | 字符串 | 是 | |
| label | 表示Ability对用户显示的名称。取值可以是Ability名称，也可以是对该名称的资源索引，以支持多语言。 | 字符串 | 是 | |
| type | 表示Ability的类型。取值范围如下：
| 字符串 | 否 | |
| launchType | 表示Ability的启动模式，支持“standard”、“singleMission”和“singleton”三种模式：
该标签仅适用于手机、平板、智慧屏、车机、智能穿戴。 | 字符串 | 否 |
abilities -> skills
| 属性名称 | 子属性名称 | 含义 | 数据类型 | 是否可缺省 |
|---|---|---|---|---|
| skills | - | 表示Ability能够接收的Intent的特征 | 对象数组 | 是 |
| entities | 表示能够接收的Intent的Ability的类别（如视频、桌面应用等），可以包含一个或多个entity。 | 字符串数组 | 是 | |
| actions | 表示能够接收的Intent的action值，可以包含一个或多个action。 | 字符串数组 | 是 |
五、HarmonyOS应用程序的运行流程
5.1、准备
5.1.1 创建项目
进入HarmonyOS（鸿蒙）正式开发之前，可以通过一个简单的HelloWorld的示例代码来了解其运行时的相关流程。如下是通过DevEco Studio创建的一个简单HelloWorld示例代码结构，接下来会分析其启动流程。
5.1.2 运行项目
运行上面的HelloWorld，展示效果如下所示：
5.2、分析启动流程
5.2.1 启动流程图
一个简单的HarmonyOS（鸿蒙）HelloWorld程序，其基本运行流程，可以分为如下几个阶段：
5.2.2 解析config.json文件
config.json文件是HarmonyOS（鸿蒙）应用程序的主要配置文件，其位于entry -> src -> main -> config.json，配置文件分为三大块，具体的说明可以参考我的另一篇文件，《HarmonyOS（鸿蒙）——config.json详解》
5.2.3 初始化
初始化主要通过config.json的module下的package和name来定位类com.example.demo.MyApplication.
MyApplication的内容如下，它会做一些应用的初始化工作
package com.example.demo;
import ohos.aafwk.ability.AbilityPackage;
public class MyApplication extends AbilityPackage {
@Override
public void onInitialize() {
super.onInitialize();
}
}
5.2.4 获取入口Ability全类名
入口Ability的全类名，也在config.json文件中进行配置
MainAbility对应config.json中的abilities中的相关配置信息
MainAbility的主要内容如下，主界面中会加载子界面，通过 super.setMainRoute(MainAbilitySlice.class.getName());的方式进行加载，关于页面的相关介绍可以查看我的另一篇文件《HarmonyOS（鸿蒙）—— Ability与页面》
1package com.example.demo;
2
3import com.example.demo.slice.MainAbilitySlice;
4import ohos.aafwk.ability.Ability;
5import ohos.aafwk.content.Intent;
6
7public class MainAbility extends Ability {
8 @Override
9 public void onStart(Intent intent) {
10 super.onStart(intent);
11 super.setMainRoute(MainAbilitySlice.class.getName());
12 }
13}
5.2.5 运行Ability
这一步就是启动上面的类
5.2.6 运行Ability的子界面
MainAbility运行后执行onStart方法会加载子页面，这里的子页面是MainAbilitySlice，其主要内容如下所示。
package com.example.demo.slice;
import com.example.demo.ResourceTable;
import ohos.aafwk.ability.AbilitySlice;
import ohos.aafwk.content.Intent;
public class MainAbilitySlice extends AbilitySlice {
@Override
public void onStart(Intent intent) {
super.onStart(intent);
super.setUIContent(ResourceTable.Layout_ability_main);
}
@Override
public void onActive() {
super.onActive();
}
@Override
public void onForeground(Intent intent) {
super.onForeground(intent);
}
}
在MainAbilitySlice中我们发现，onStart加载类相关UI配置，ResourceTable.Layout_ability_main，ResourceTable是HarmonyOS应用程序启动时动态生成的常量类，它会给每一个xml等文件分配一个标志ID。要是想查看这个类，可以运行应用程序后在class文件中查阅
5.2.7 加载xml文件，展示内容
关于子页面中的内容，均可以通过xml文件来进行配置，这种基于xml配置内容样式的方式也比较方便，易于统一管理和系统解析。
至此一个HarmonyOS（鸿蒙）HelloWorld程序的执行流程就这么多了。
六、精选好文
HarmonyOS（鸿蒙）DevEco Studio开发环境搭建
以上是关于HarmonyOS（鸿蒙）——全面入门，始于而不止于HelloWorld的主要内容，如果未能解决你的问题，请参考以下文章