1# 概述 2 3 4用户程序框架是OpenHarmony为开发者提供开发OpenHarmony应用的开发框架,包含两个子系统:Ability子系统和包管理子系统。 5 6 7## 基本概念 8 9开发者在开发前需要先了解以下基本概念,方便开发者更好的理解OpenHarmony用户程序框架。 10 11 12### Ability子系统 13 14 Ability子系统是管理OpenHarmony应用运行状态的开发框架。 15 16 **图1** Ability子系统框架图 17 18 ![zh-cn_image_0000001151375648](figures/zh-cn_image_0000001151375648.png) 19 20 21- **Ability**:系统调度应用的最小单元,是能够完成一个独立功能的组件,一个应用可以包含一个或多个Ability。Ability分为两种类型:Page类型的Ability和Service类型的Ability。 22 - **Page类型的Ability**:带有界面,为用户提供人机交互的能力。 23 - **Service类型的Ability**:不带界面,为用户提供后台任务机制。 24 25- **AbilitySlice**:单个页面及其控制逻辑的总和,是Page类型Ability特有的组件,一个Page类型的Ability可以包含多个AbilitySlice,此时,这些页面提供的业务能力应当是高度相关的。 26 27 **图2** Ability与AbilitySlice的关系图 28 29 ![zh-cn_image_0000001197415205](figures/zh-cn_image_0000001197415205.png) 30 31- **生命周期**:Ability被调度到启动、激活、隐藏和退出等各个状态的统称。 32 33 **图3** Ability生命周期流转 34 35 ![zh-cn_image_0000001197896843](figures/zh-cn_image_0000001197896843.png) 36 - **OnStart()** 37 系统首次创建Page实例时触发该回调。对于一个Page实例,该回调在其生命周期过程中仅触发一次,Page在该逻辑后进入INACTIVE状态。开发者必须重写该方法,并在此配置默认展示的AbilitySlice。 38 39 - **OnActive()** 40 Page会在进入INACTIVE状态后来到前台,然后系统调用此回调。Page在此之后进入ACTIVE状态,该状态是应用与用户交互的状态。Page将保持在此状态,除非某类事件发生导致Page失去焦点,比如用户点击返回键或导航到其他Page。 41 42 当此类事件发生时,会触发Page回到INACTIVE状态,系统将调用OnInactive()回调。此后,Page可能重新回到ACTIVE状态,系统将再次调用OnActive()回调。因此,开发者通常需要成对实现OnActive()和OnInactive(),并在OnActive()中获取在OnInactive()中被释放的资源。 43 44 - **OnInactive()** 45 当Page失去焦点时,系统将调用此回调,此后Page进入INACTIVE状态。开发者可以在此回调中实现Page失去焦点时应表现的恰当行为。 46 47 - **OnBackground()** 48 如果Page不再对用户可见,系统将可能根据资源状况调用此回调,此后Page进入BACKGROUND状态。开发者应该在此回调中释放Page不可见时无用的资源,或在此回调中执行较为耗时的状态保存操作。 49 50 - **OnForeground()** 51 处于BACKGROUND状态的Page仍然驻留在内存中,当重新回到前台时(比如用户重新导航到此Page),系统将先调用OnForeground()回调使Page回到INACTIVE状态,然后调用OnActive()回调使Page回到ACTIVE状态。开发者应当在此回调中重新申请在OnBackground()中释放的资源。轻量化设备目前不支持该接口。 52 53 - **OnStop()** 54 此回调表示系统正在销毁Page。销毁Page的可能原因包括: 55 56 - 用户通过系统管理能力显式关闭Page,例如使用任务管理器关闭Page。 57 - 用户行为触发Page的TerminateAbility()方法调用,例如使用应用的退出功能。 58 - 配置变更导致系统暂时销毁Page并重建。 59 - 系统出于资源管理目的,自动触发对处于BACKGROUND状态Page的销毁。 60 61- **AbilityKit**:Ability框架提供给开发者的开发包,开发者基于该开发包可以开发出基于Ability组件的应用。基于Ability组件开发的应用有两种类型:基于JavaScript语言开发的Ability(JS Ability)和基于C/C++语言开发的Ability(Native Ability)。JS应用开发框架是开发者开发JS Ability所用到框架,是在AbilityKit基础封装的包含JS UI组件的一套方便开发者能够迅速开发Ability应用的框架。 62 63- **AbilityLoader**:负责注册和加载开发者Ability的模块。开发者开发的Ability先要调用AbilityLoader的注册接口注册到框架中,接着Ability启动时会被实例化。 64 65- **AbilityManager**:负责AbilityKit和Ability管理服务进行IPC的通信。 66 67- **EventHandler**:AbilityKit提供给开发者的用于在Ability中实现线程间通信的一个模块。 68 69- **AbilityManagerService**:元能力运行管理服务。该服务用于协调各Ability运行关系、及生命周期进行调度的系统服务。其中,服务启动模块负责Ability管理服务的启动、注册等。服务接口管理模块负责Ability管理服务对外能力的管理。进程管理模块负责Ability应用所在进程的启动和销毁、及其进程信息维护等功能。Ability栈管理模块负责维护各个Ability之间跳转的先后关系。生命周期调度模块是Ability管理服务根据系统当前的操作调度Ability进入相应的状态的模块。连接管理模块是Ability管理服务对Service类型Ability连接管理的模块。 70 71- **AppSpawn**:负责创建Ability应用所在进程的系统服务,该服务有较高的权限,为Ability应用设置相应的权限,并预加载一些通用的模块,加速应用的启动。 72 73 74### 包管理子系统 75 76包管理子系统是OpenHarmony为开发者提供的安装包管理框架。 77 78 **图4** 包管理子系统框架图 79 80 ![zh-cn_image_0000001197495305](figures/zh-cn_image_0000001197495305.png) 81 82 83- **BundleKit**:是包管理服务对外提供的接口,有安装/卸载接口、包信息查询接口、包状态变化listen接口。 84 85- **包扫描器**:用来解析本地预制或者安装的安装包,提取里面的各种信息,供管理子模块进行管理,持久化。 86 87- **包安装子模块**:安装,卸载,升级一个包。包安装服务是一个单独进程和包管理服务通过IPC进行通信,该服务用于创建、删除安装目录和数据目录等,具有较高的权限。 88 89- **包管理子模块**:管理安装包相关的信息,存储持久化包信息。 90 91- **包安全管理子模块**:签名检查、权限授予、权限管理。 92 93 94## 运作机制 95 96Ability子系统的核心模块是Ability管理服务、包管理子系统的核心模块是包管理服务,这两个服务是系统级服务,借助系统服务框架SAMgr实现服务的注册与发现,并对其他进程提供Ability管理服务和包管理服务。Ability管理服务和包管理服务通过AbilityKit和BundleKit以接口的形式向外提供服务。 97 98 **图5** Ability管理服务和包管理服务启动 99 100 ![zh-cn_image_0000001062014699](figures/zh-cn_image_0000001062014699.png) 101 102Ability管理服务和包管理服务启动后,就可以安装OpenHarmony应用和启动运行OpenHarmony应用。 103 104 **图6** 应用启动流程 105 106 ![zh-cn_image_0000001062068389](figures/zh-cn_image_0000001062068389.png) 107 108桌面为Ability管理服务启动的第一个OpenHarmony应用。桌面启动后,用户可以在桌面上点击安装的OpenHarmony应用并启动该应用。上图6为从桌面启动一个已安装应用的交互流程。 109 110从图中可知,Ability管理服务负责协调Ability之间的显示隐藏,包管理服务负责Ability信息的存储查询。 111 112 113## 约束与限制 114 115- 语言版本 116 117 - C++11版本或以上 118 119- 框架针对不同的芯片平台和底层OS能力,规格有所区别 120 121 - Cortex-M RAM/ROM: 122 123 - RAM:建议大于20K 124 - ROM: > 300K (包含JS应用开发框架,UIKit及引擎等强相关子系统) 125 - Cortex-A RAM/ROM: 126 127 - RAM:建议大于2M 128 - ROM:> 2M (包含JS应用开发框架,UIKit及引擎等强相关子系统) 129