鸿蒙开发学习入门之开发基础知识
鸿蒙开发学习入门之开发基础知识
鸿蒙HarmonyOS开发wiki
一、HAP的概念
HarmonyOS的软件包很有意思，叫做 APP Pack，它和Android的APK不同，因为分布式系统的缘故，它的软件包是个整体的概念，包含多个独立HAP（这个才相当于APK）。
而HAP和APK一样，都是由代码，资源，第三方库，应用配置文件组成的模块包。
HAP有两种模块类型，分别是entry，feature。前者是主入口模块。后者是单独的业务模块。
二、Ability的概念
相当于Android中的四大组件（Activity，Service，ContentProvider，BroadcastReceiver）。
Ability分为两种类型：FA（Feature Ability）和PA（particle Abiltiy）。
Ability又拥有三种模板：
Page Ability
是FA唯一支持的模板，提供用户交互能力。
Service Ability
PA支持的模板，提供后台运行任务的能力。
Data Ability
PA支持的模板，提供统一的数据访问抽象。
在配置文件（config.json）中注册 Ability 时，可以通过配置 Ability 元素中的“type”属性来
指定 Ability 模板类型，示例如下：
{ "module": { ..."abilities": [ {..."type": "page"... }] ... }三、Page Ability
Page Ability是个整体概念，不单独指的是一个页面，而是可能包含多个页面，Page 是模块的概念。每个页面是AbilitySlice实例表示，指的是应用的单个页面及其控制逻辑的总和。
所以Page Ability包含于AbilitySlice。这两者之间是有高度相关性，简单来说，就是同个模块的不同界面。例如商城模块，包含商品详情界面，商品列表界面。不能商城模块里，放一个用户权益界面。
Page模块不是一个简单概念，而是有操作实体的模块。因为它不像Android中简单的通过文件夹命名，包名区分模块，整个应用的跳转是统一路由维护。所以跳转到单独界面时，Page模块会维护一个路由，来维护跳转规则。
Page模块的默认展示页面AbilitySlice，通过setMainRoute() 来设置。
AbilitySlice的暴露对外的路由规则，用于其他Page模块跳转进入，通过AddActionroute() 来设置。
public class MyAbility extends Ability {@Overridepublic void onStart(Intent intent) { super.onStart(intent); // set the main routesetMainRoute(MainSlice.class.getName());// set the action routeaddActionRoute("action.pay", PaySlice.class.getName());addActionRoute("action.scan", ScanSlice.class.getName());}}addActionRoute()方法中使用的动作命名，需要在应用配置文件（config.json）中注册：
{"module": {"abilities": [{"skills":[{"actions":["action.pay","action.scan" ] }]... } ]...} ...}三、Page Ability和AbilitySlice 生命周期
Page 生命周期：
onStart()
首次创建，只会触发一次。
onActive()
在前台展示，应用与用户交互的状态。
onInactive()
当 Page 失去焦点时
onBackground()
当Page 不再对用户可见，在后台
onForeground()
当重新回到前台时
onStop()
系统将要销毁 Page 时
当系统首次创建 Page 实例时，触发 onStart()回调。对于一个 Page 实例，该回调在其生命周期过程
中仅触发一次，Page 在该逻辑后将进入 INACTIVE 状态。开发者必须重写该方法，并在此配
置默认展示的 AbilitySlice。
@Overridepublic void onStart(Intent intent) {super.onStart(intent);super.setMainRoute(FooSlice.class.getName());}AbilitySlice 作为 Page 的组成单元，其生命周期是依托于其所属 Page 生命周期的。
由于 AbilitySlice 承载具
体的页面，必须重写 AbilitySlice 的 onStart()回调，并在此方法中通过 setUIContent()
方法设置页面，如下所示：
@Overrideprotected void onStart(Intent intent) {super.onStart(intent);setUIContent(ResourceTable.Layout_main_layout);}四、路由跳转处理
通过present()/presentForResult() 方法实现AbilitySlice间导航
@Overrideprotected void onStart(Intent intent) { ... Button button = ...; button.setClickedListener(listener -> present(new TargetSlice(), new Intent())); ...}int requestCode = positiveInteger; // Any positive integer.@Overrideprotected void onStart(Intent intent) { ... Button button = ...; button.setClickedListener( listener -> presentForResult(new TargetSlice(), new Intent(), positiveInteger)); ...}@Overrideprotected void onResult(int requestCode, Intent resultIntent) { if (requestCode == positiveInteger) { // Process resultIntent here. }}构造Operation对象，通过startAbility()/startAbilityForResult()实现不同Page间导航
请求方
在Ability中构造Intent以及包含Action的Operation对象，并调用startAbilityForResult()方法发起请求。然后重写onAbilityResult()回调方法，对请求结果进行处理。
private void queryWeather() { Intent intent = new Intent(); Operation operation = new Intent.OperationBuilder() .withAction(Intent.ACTION_QUERY_WEATHER) .build(); intent.setOperation(operation); startAbilityForResult(intent, REQ_CODE_QUERY_WEATHER);}@Overrideprotected void onAbilityResult(int requestCode, int resultCode, Intent resultData) { switch (requestCode) { case REQ_CODE_QUERY_WEATHER: // Do something with result. ... return; default: ... }}处理方
作为处理请求的对象，首先需要在配置文件中声明对外提供的能力，以便系统据此找到自身并作为候选的请求处理者
{ "module": { ... "abilities": [ { ... "skills":[ { "actions":["ability.intent.QUERY_WEATHER" ] } ] ... } ] ... } ...}在Ability中配置路由以便支持以此action导航到对应的AbilitySlice。
@Overrideprotected void onStart(Intent intent) { ... addActionRoute(Intent.ACTION_QUERY_WEATHER, DemoSlice.class.getName()); ...}在Ability中处理请求，并调用setResult()方法暂存返回结果。
@Overrideprotected void onActive() { ... Intent resultIntent = new Intent(); setResult(0, resultIntent); //0为当前Ability销毁后返回的resultCode。 ...}五、UI框架的选择
目前HarmonyOS有两种开发UI框架：Java和JS。声明式编程是目前的趋势，推荐使用JS。
