当前仓库属于关闭状态,部分功能使用受限,详情请查阅 仓库状态说明
1.4K Star 7.4K Fork 8.2K

OpenHarmony/docs
关闭

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
文件
.config
.gitee
docker
en
zh-cn
application-dev
IDL
ads-service
ai
application-models
figures
public_sys-resources
Readme-CN.md
ability-exit-info-record.md
ability-recover-guideline.md
ability-startup-with-explicit-want.md
abilitykit-overview.md
abilitystage.md
access-dataability.md
access-datashareextensionability-from-fa.md
actions-entities.md
api-switch-overview.md
app-deviceconfig-switch.md
app-linking-startup.md
app-service-extension-ability.md
app-startup-overview.md
app-startup.md
app-uri-config.md
application-component-configuration-fa.md
application-component-configuration-stage.md
application-context-fa.md
application-context-stage.md
application-models.md
autofillextensionablility-guide.md
bind-serviceability-from-stage.md
bind-serviceextensionability-from-fa.md
canopenlink.md
capi-nativechildprocess-exit-info.md
capi_nativechildprocess_development_guideline.md
component-startup-rules-fa.md
component-startup-rules.md
config-file-fa.md
config-file-stage.md
configuration-file-diff.md
connect-serviceability.md
context-switch.md
create-dataability.md
create-pageability.md
create-serviceability.md
dataability-configuration.md
dataability-lifecycle.md
dataability-overview.md
dataability-permission-control.md
dataability-switch.md
dataabilityhelper-switch.md
deep-linking-startup.md
embeddeduiextensionability.md
explicit-implicit-want-mappings.md
extensionability-overview.md
fa-model-development-overview.md
fa-stage-interaction-overview.md
featureability-switch.md
file-processing-apps-startup.md
hop-cross-device-migration.md
hop-multi-device-collaboration.md
insight-intent-access-specifications.md
insight-intent-debug.md
inter-device-interaction-hop-overview.md
lifecycleapp-switch.md
lifecycledata-switch.md
lifecycleform-switch.md
lifecycleservice-switch.md
link-between-apps-overview.md
mission-management-fa.md
mission-management-launch-type.md
mission-management-overview.md
mission-set-icon-name-for-task-snapshot.md
model-switch-overview.md
module-switch.md
page-mission-stack.md
pageability-configuration.md
pageability-launch-type.md
pageability-lifecycle.md
pageability-overview.md
pageability-switch.md
particleability-switch.md
photoEditorExtensionAbility.md
process-model-fa.md
process-model-stage.md
redirection-rules.md
request-permissions.md
request-switch.md
resourcemanager-switch.md
serviceability-configuration.md
serviceability-lifecycle.md
serviceability-overview.md
serviceability-switch.md
serviceextensionability.md
stage-model-development-overview.md
start-dataability.md
start-email-apps-by-mailto.md
start-email-apps.md
start-express-apps.md
start-finance-apps.md
start-flight-apps.md
start-intent-panel.md
start-local-pageability.md
start-navigation-apps.md
start-page.md
start-pageability-from-stage.md
start-remote-pageability.md
start-serviceability.md
start-uiability-from-fa.md
stop-pageability.md
storage-switch.md
subscribe-system-environment-variable-changes.md
system-app-startup.md
thread-model-fa.md
thread-model-stage.md
uiability-data-sync-with-ui.md
uiability-intra-device-interaction.md
uiability-launch-type.md
uiability-lifecycle.md
uiability-overview.md
uiability-startup-adjust.md
uiability-usage.md
uiextensionability.md
uiserviceextension-sys.md
uiserviceextension.md
want-fa.md
want-overview.md
widget-switch.md
window-properties.md
window-switch.md
application-test
arkts-utils
basic-services
calendarmanager
connectivity
contacts
database
device-usage-statistics
device
dfx
displaymanager
distributedservice
enterprise-device-management
faqs
ffrt
file-management
form
graphics
graphics3d
inputmethod
internationalization
ipc
key-features/multi-device-app-dev
mdm
media
napi
network
notification
onlyfortest
performance
public_sys-resources
quick-start
reference
security
task-management
telephony
tools
ui
web
webgl
windowmanager
Readme-CN.md
Samples.md
application-dev-guide-for-gitee.md
application-dev-guide.md
website.md
contribute
design
device-dev
figures
readme
release-notes
third-party-cases
third-party-components
Legal-Notices.md
OpenHarmony-Overview_zh.md
glossary.md
readme.md
website.md
.gitattributes
.gitignore
CODEOWNERS
DCO.txt
LICENSE
OAT.xml
README.md
README_zh.md
image.png
克隆/下载
stage-model-development-overview.md 6.98 KB
一键复制 编辑 原始数据 按行查看 历史
Luobniz 提交于 20天前 . MultiAppMode

Stage模型开发概述

基本概念

下图展示了Stage模型中的基本概念。

图1 Stage模型概念图

stage-concepts

  • AbilityStage

    每个Entry类型或者Feature类型的HAP在运行期都有一个AbilityStage实例,当HAP中的代码首次被加载到进程中的时候,系统会先创建AbilityStage实例。

  • UIAbility组件ExtensionAbility组件

    Stage模型提供UIAbility和ExtensionAbility两种类型的组件,这两种组件都有具体的类承载,支持面向对象的开发方式。

    • UIAbility组件是一种包含UI的应用组件,主要用于和用户交互。例如,图库类应用可以在UIAbility组件中展示图片瀑布流,在用户选择某个图片后,在新的页面中展示图片的详细内容。同时用户可以通过返回键返回到瀑布流页面。UIAbility组件的生命周期只包含创建、销毁、前台、后台等状态,与显示相关的状态通过WindowStage的事件暴露给开发者。

    • ExtensionAbility组件是一种面向特定场景的应用组件。开发者并不直接从ExtensionAbility组件派生,而是需要使用ExtensionAbility组件的派生类。目前ExtensionAbility组件有用于卡片场景的FormExtensionAbility,用于输入法场景的InputMethodExtensionAbility,用于延时任务场景的WorkSchedulerExtensionAbility等多种派生类,这些派生类都是基于特定场景提供的。例如,用户在桌面创建应用的卡片,需要应用开发者从FormExtensionAbility派生,实现其中的回调函数,并在配置文件中配置该能力。ExtensionAbility组件的派生类实例由用户触发创建,并由系统管理生命周期。在Stage模型上,三方应用开发者不能开发自定义服务,而需要根据自身的业务场景通过ExtensionAbility组件的派生类来实现。

    一个HAP包中可以包含一个或多个UIAbility/ExtensionAbility组件,这些组件在运行时共用同一个AbilityStage实例。当HAP中的代码(无论是UIAbility组件还是ExtensionAbility组件)首次被加载到进程中的时候,系统会先创建对应的AbilityStage实例。

  • WindowStage

    每个UIAbility实例都会与一个WindowStage类实例绑定,该类起到了应用进程内窗口管理器的作用。它包含一个主窗口。也就是说UIAbility实例通过WindowStage持有了一个主窗口,该主窗口为ArkUI提供了绘制区域,可以加载不同的ArkUI页面。

  • Context

    在Stage模型上,Context及其派生类向开发者提供在运行期可以调用的各种资源和能力。UIAbility组件和各种ExtensionAbility组件的派生类都有各自不同的Context类,他们都继承自基类Context,但是各自又根据所属组件,提供不同的能力。

构成要素

应用模型章节中介绍了应用模型的构成要素,主要包含应用组件、配置文件、进程模型、线程模型和任务管理模型。下面我们以Demo.app这个应用为例,从应用的开发阶段和运行阶段分别展开介绍,帮助开发者更好地理解Stage模型的构成要素。

该Demo应用主要实现了如下功能:

  • 实现了两个独立的带界面的窗口(UIAbilityA、UIAbilityB),可以与用户交互。
  • 实现了卡片功能,便于用户将应用的卡片添加到桌面上。

图2 Stage模型构成要素

stage-model-components

开发阶段 :需要通过Stage模型提供的应用组件(UIAbility组件和ExtensionAbility组件)开发应用功能,并在应用的配置文件(app.json5和module.json5)中注册应用的相关信息。

  • 应用组件:本例中使用UIAbility组件开发带界面的与用户交互的模块,使用FormExtensionAbility组件开发卡片模块,实现卡片的添加、删除、更新功能。为了减少不同功能模块间的依赖和耦合,将UIAbility和FormExtensionAbility的实现分别放在不同的HAP包中,同时,将两者共同依赖的一些通用功能放在HSP包中。

  • 配置文件:开发者可以在app.json5中配置应用的应用名、版本号、应用图标等,在module.json5中配置该HAP包下的组件清单、组件权限等信息。这些配置信息会在应用安装时注册到系统,便于系统和其他模块获取这个应用的详细信息,与应用进行交互。

运行阶段:当应用安装到设备运行时,系统通过一套应用进程和线程的管理机制,确保功能的有序运行。此外,还提供了一套任务管理机制,用于管理任务的创建、销毁、前后台切换等。

  • 进程模型:UIAbility组件默认运行在主进程中,FormExtensionAbility组件运行在独立进程中,UIAbility和FormExtensionAbility组件之间是进程隔离的。

  • 线程模型:Stage模型提供了worker、taskpool等机制支撑应用多线程开发场景。应用如果有复杂的耗时逻辑需要处理,可以通过创建worker的方式开启worker线程,交由worker线程处理。

  • 任务管理模型:UIAbility组件在运行时,系统会创建一个任务与之对应。例如,当图中的UIAbilityA运行时,从“最近任务”界面,可以看到Demo应用的这个任务。用户点击这个任务时,系统会把UIAbilityA切换到前台。

开发流程

基于Stage模型开发应用时,在应用模型部分,涉及如下开发过程。

表1 Stage模型开发流程

任务 简介 相关指导
应用组件开发 本章节介绍了如何使用Stage模型的UIAbility组件和ExtensionAbility组件开发应用。 应用/组件级配置
UIAbility组件
ExtensionAbility组件
AbilityStage组件容器
应用上下文Context
组件启动规则
了解进程模型 本章节介绍了Stage模型的进程模型以及几种常用的进程间通信方式。 进程模型概述
了解线程模型 本章节介绍了Stage模型的线程模型以及几种常用的线程间通信方式。 线程模型概述
应用配置文件 本章节介绍Stage模型中应用配置文件的开发要求。 Stage模型应用配置文件

相关实例

针对Stage模型开发,有以下相关实例可供参考:

Loading...
马建仓 AI 助手
尝试更多
代码解读
代码找茬
代码优化
其他
1
https://gitee.com/openharmony/docs.git
git@gitee.com:openharmony/docs.git
openharmony
docs
docs
master

搜索帮助