鸿蒙开发学习入门之开发基础知识

鸿蒙开发学习入门之开发基础知识

鸿蒙HarmonyOS开发wiki
鸿蒙开发学习入门之开发基础知识_第1张图片

一、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

鸿蒙开发学习入门之开发基础知识_第2张图片

Page Ability是个整体概念,不单独指的是一个页面,而是可能包含多个页面,Page 是模块的概念。每个页面是AbilitySlice实例表示,指的是应用的单个页面及其控制逻辑的总和

所以Page Ability包含于AbilitySlice。这两者之间是有高度相关性,简单来说,就是同个模块的不同界面。例如商城模块,包含商品详情界面,商品列表界面。不能商城模块里,放一个用户权益界面。

Page模块不是一个简单概念,而是有操作实体的模块。因为它不像Android中简单的通过文件夹命名,包名区分模块,整个应用的跳转是统一路由维护。所以跳转到单独界面时,Page模块会维护一个路由,来维护跳转规则。

Page模块的默认展示页面AbilitySlice,通过setMainRoute() 来设置。
AbilitySlice的暴露对外的路由规则,用于其他Page模块跳转进入,通过AddActionroute() 来设置。

public class MyAbility extends Ability {
	@Override
	public void onStart(Intent intent) {
 		super.onStart(intent);
 		
		// set the main route
		setMainRoute(MainSlice.class.getName());

		// set the action route
		addActionRoute("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 生命周期

鸿蒙开发学习入门之开发基础知识_第3张图片
Page 生命周期:
onStart()
首次创建,只会触发一次。
onActive()
在前台展示,应用与用户交互的状态。
onInactive()
当 Page 失去焦点时
onBackground()
当Page 不再对用户可见,在后台
onForeground()
当重新回到前台时
onStop()
系统将要销毁 Page 时

当系统首次创建 Page 实例时,触发 onStart()回调。对于一个 Page 实例,该回调在其生命周期过程
中仅触发一次,Page 在该逻辑后将进入 INACTIVE 状态。开发者必须重写该方法,并在此配
置默认展示的 AbilitySlice。

@Override
public void onStart(Intent intent) {
	super.onStart(intent);
	super.setMainRoute(FooSlice.class.getName());
}

AbilitySlice 作为 Page 的组成单元,其生命周期是依托于其所属 Page 生命周期的。
由于 AbilitySlice 承载具
体的页面,必须重写 AbilitySlice 的 onStart()回调,并在此方法中通过 setUIContent()
方法设置页面,如下所示:

@Override
protected void onStart(Intent intent) {
	super.onStart(intent);

	setUIContent(ResourceTable.Layout_main_layout);
}

四、路由跳转处理

通过present()/presentForResult() 方法实现AbilitySlice间导航
鸿蒙开发学习入门之开发基础知识_第4张图片

@Override
protected void onStart(Intent intent) {

    ...
    Button button = ...;
    button.setClickedListener(listener -> present(new TargetSlice(), new Intent()));
    ...

}
int requestCode = positiveInteger; // Any positive integer.

@Override
protected void onStart(Intent intent) {

    ...
    Button button = ...;
    button.setClickedListener(
        listener -> presentForResult(new TargetSlice(), new Intent(), positiveInteger));
    ...

}

@Override
protected void onResult(int requestCode, Intent resultIntent) {
    if (requestCode == positiveInteger) {
        // Process resultIntent here.
    }
}

构造Operation对象,通过startAbility()/startAbilityForResult()实现不同Page间导航
鸿蒙开发学习入门之开发基础知识_第5张图片
请求方

在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);
}

@Override
protected 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。

@Override
protected void onStart(Intent intent) {
    ...
    addActionRoute(Intent.ACTION_QUERY_WEATHER, DemoSlice.class.getName());
    ...
}

在Ability中处理请求,并调用setResult()方法暂存返回结果。

@Override
protected void onActive() {
    ...
    Intent resultIntent = new Intent();
    setResult(0, resultIntent);   //0为当前Ability销毁后返回的resultCode。
    ...
}

五、UI框架的选择

目前HarmonyOS有两种开发UI框架:Java和JS。声明式编程是目前的趋势,推荐使用JS。
鸿蒙开发学习入门之开发基础知识_第6张图片
鸿蒙开发学习入门之开发基础知识_第7张图片

你可能感兴趣的:(Harmonyos知识体系,HarmonyOS,分布式系统,跨平台,JS,Java)