【HarmonyOS 5】鸿蒙中的UIAbility详解(一)

简介: HarmonyOS 5 中的 UIAbility 是应用框架的核心组件,负责管理用户界面生命周期和上下文信息。它类似于 Android 的 Activity 或 iOS 的 UIViewController,主要用于与用户交互。本文详细解析了 UIAbility 的基本概念、启动页面设置、上下文获取、生命周期管理及常用操作(如终止实例、跨 Ability 信息传递)。

【HarmonyOS 5】鸿蒙中的UIAbility详解(一)

一、UIAbility是什么?

Stage模型中的组件类型名,即UIAbility组件,包含UI,提供展示UI的能力,主要用于和用户交互。

UIAbility类似于传统移动开发Android中的Activity或者Fragment。类似IOS开发中的 UIViewController。

UIAbility 是 HarmonyOS 应用框架的核心组件,负责管理应用的用户界面生命周期和上下文信息。

二、设置指定启动页面

启动页面必须设置:否则应用启动后会白屏。

避免应用启动后白屏,需在onWindowStageCreate生命周期中设置默认加载页面。通过WindowStageloadContent()方法指定页面路径。

  export default class EntryAbility extends UIAbility {
   
    onWindowStageCreate(windowStage: window.WindowStage): void {
   
      windowStage.loadContent('pages/Index', (err, data) => {
    /* 处理回调 */ });
    }
  }

DevEco Studio默认生成的项目会自动加载Index页面,可按需修改路径。

三、获取上下文信息(UIAbilityContext)

获取应用配置信息(如包名、Ability名称等),或调用操作Ability的方法(如启动、终止Ability)。通过this.context直接访问。

  export default class EntryAbility extends UIAbility {
   
    onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
   
      const context = this.context; // 直接获取上下文
    }
  }

在页面组件中获取
通过getUIContext().getHostContext()转换为UIAbilityContext

  @Entry
  @Component
  struct Page {
   
    private context = this.getUIContext().getHostContext() as common.UIAbilityContext;
    startAbilityTest() {
    this.context.startAbility(want); } // 启动其他Ability
  }

启动页面设置与上下文使用代码示例

// UIAbility定义
export default class EntryAbility extends UIAbility {
   
  onWindowStageCreate(windowStage: window.WindowStage) {
   
    windowStage.loadContent('pages/Main', () => {
   }); // 设置启动页面
  }

  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
   
    const context = this.context; // 获取上下文
    context.startAbility({
    abilityName: 'OtherAbility' }); // 启动其他Ability
  }
}

// 页面组件中使用上下文
@Entry
@Component
struct MainPage {
   
  private context = this.getUIContext().getHostContext() as common.UIAbilityContext;
  build() {
   
    Button('终止当前Ability').onClick(() => this.context.terminateSelf());
  }
}

四、UIAbility生命周期与操作

UIAbility的生命周期包含 Create(创建)、Foreground(前台)、Background(后台)、Destroy(销毁) 四个核心状态,以及与窗口(WindowStage)相关的子状态。通过生命周期回调钩子函数,可监听状态变化并执行对应操作。

生命周期状态流转图

创建实例          窗口创建       进入前台         切到后台         窗口销毁       实例销毁
  ↓               ↓             ↓               ↓               ↓             ↓
onCreate() → onWindowStageCreate() → onForeground() → onBackground() → onWindowStageDestroy() → onDestroy()
         ↑       ↖                ↗                ↖                ↑
         └─────── WindowStageWillDestroy() ────────────────────────┘

1、onCreate

UIAbility实例创建完成时触发。初始化页面数据、加载资源(如定义变量、获取上下文this.context)。

  export default class EntryAbility extends UIAbility {
   
    onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
   
      // 初始化操作(如获取上下文、配置数据)
      const context = this.context; 
    }
  }

2、WindowStageCreate

UIAbility实例创建后,进入前台前,系统创建WindowStage时触发。设置启动页面(loadContent())、订阅窗口事件(如前后台切换、焦点变化)。


    onWindowStageCreate(windowStage: window.WindowStage) {
   
      windowStage.loadContent('pages/Index'); // 设置启动页面
      windowStage.on('windowStageEvent', (event) => {
    // 订阅窗口事件
        switch (event) {
   
          case window.WindowStageEventType.SHOWN: // 切到前台
            console.log('窗口切到前台');
            break;
        }
      });
    }

3、WindowStageWillDestroy

WindowStage销毁前触发(此时窗口仍可用)。释放通过WindowStage获取的资源,注销事件订阅(off('windowStageEvent'))。

4、WindowStageDestroy

WindowStage销毁时触发(UI资源释放)。释放UI相关资源(如临时文件、图形对象)。

5、Foreground

UIAbility切换至前台、UI可见前触发。申请系统资源(如定位、传感器权限)、恢复后台释放的资源。

    onForeground() {
   
      // 开启定位功能
      location.start(); 
    }

6、Background

UIAbility切换至后台、UI完全不可见后触发。释放无用资源、执行耗时操作(如数据持久化)。

    onBackground() {
   
      // 停止定位、保存当前状态
      location.stop(); 
      saveDataToLocal();
   }

7、onDestroy

UIAbility实例被终止时触发(如调用terminateSelf())。释放全局资源、清理内存(如关闭网络连接、注销监听器)。

  onDestroy() {
   
    // 释放数据库连接、取消定时器
    db.close(); 
    clearInterval(timer);
  }

注意:API 13+中,若用户通过最近任务一键清理应用,不会触发onDestroy(),而是直接终止进程。

四、UIAbility的常用函数操作

1. 终止UIAbility实例

调用terminateSelf()终止当前Ability。

  context.terminateSelf((err) => {
   
    if (err) {
    console.error('终止失败:', err); } 
    else {
    console.info('终止成功'); }
  });

2. 获取拉起方信息

当UIAbilityA通过startAbility启动UIAbilityB时,UIAbilityB可获取调用方信息。

  export default class UIAbilityB extends UIAbility {
   
    onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
   
      console.log(`调用方Pid: ${
     want.parameters?.['ohos.aafwk.param.callerPid']}`);
    }
  }

跨Ability信息传递代码示例

// UIAbilityA中启动UIAbilityB
@Entry
@Component
struct UIAbilityAPage {
   
  private context = this.getUIContext().getHostContext() as common.UIAbilityContext;
  build() {
   
    Button('拉起UIAbilityB').onClick(() => {
   
      this.context.startAbility({
    
        bundleName: this.context.abilityInfo.bundleName, 
        abilityName: 'UIAbilityB' 
      });
    });
  }
}

// UIAbilityB中获取调用方信息
export default class UIAbilityB extends UIAbility {
   
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
   
    console.log(`调用方包名: ${
     want.parameters?.['ohos.aafwk.param.callerBundleName']}`);
  }
}

注意

当UIAbility设置为singleton启动模式时,重复调用startAbility()启动同一实例,不会重新走onCreateonWindowStageCreate流程,而是触发onNewWant回调。

  onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam) {
   
    // 根据新的Want参数更新页面数据
    this.data = want.parameters?.data; 
  }
目录
相关文章
|
5月前
|
开发者 容器
鸿蒙HarmonyOS - SideBarContainer 组件自学指南
`SideBarContainer` 是 HarmonyOS 提供的双区域容器组件,适用于「左侧导航 + 右侧内容」布局,如后台管理界面、文件管理器等。它支持三种布局类型:Embed(并排)、Overlay(悬浮)和 Auto(自动切换),并提供折叠、拖拽、控制按钮等功能。本文通过示例代码详解其用法,包括子组件限制、显示模式控制、尺寸参数设置、控制按钮与分割线样式定制,以及常见问题解答。掌握该组件可高效构建复杂页面结构,推荐从 Embed 模式入手逐步进阶。
115 9
鸿蒙HarmonyOS - SideBarContainer 组件自学指南
|
5月前
|
传感器 人工智能 物联网
HarmonyOS NEXT~鸿蒙操作系统功耗优化特性深度解析
本文深入解析了华为鸿蒙(HarmonyOS)操作系统的功耗优化特性,涵盖低功耗设计原理、核心技术及实际应用效果。通过与Android对比,展现其在待机功耗、CPU调度效率和内存占用上的优势。文章重点阐述分布式任务调度、微内核架构及智能感知技术,并针对智能穿戴、物联网和智能手机等场景优化进行分析,同时为开发者提供优化建议。未来,鸿蒙将探索AI预测性管理等新技术,进一步提升能效表现。
594 30
|
6月前
|
数据采集 搜索推荐 前端开发
鸿蒙HarmonyOS埋点SDK,ClkLog适配鸿蒙埋点分析
ClkLog鸿蒙埋点SDK通过手动埋点的方式实现HarmonyOS 原生应用的前端数据采集。快速接入即可获取埋点数据,同时支持分析功能(基础统计分析、自定义分析、用户画像等)。
270 59
|
5月前
|
人工智能 自然语言处理 开发者
HarmonyOS NEXT~鸿蒙开发利器:CodeGenie AI辅助编程工具全面解析
鸿蒙开发迎来新利器!DevEco CodeGenie 是华为推出的 AI 辅助编程工具,专为 HarmonyOS NEXT 开发者设计。它具备智能代码生成(支持 ArkTS 和 C++)、精准知识问答以及万能卡片生成三大核心功能,大幅提升编码效率。通过与 DeepSeek 深度整合,CodeGenie 实现流畅的问答体验,帮助开发者解决技术难题。无论是新手还是资深开发者,都能从中受益,享受更智能高效的开发过程。快来体验吧!
431 5
|
20天前
|
存储 缓存 5G
鸿蒙 HarmonyOS NEXT端云一体化开发-云存储篇
本文介绍用户登录后获取昵称、头像的方法,包括通过云端API和AppStorage两种方式,并实现上传头像至云存储及更新用户信息。同时解决图片缓存问题,添加上传进度提示,支持自动登录判断,提升用户体验。
93 0
|
20天前
|
存储 负载均衡 数据库
鸿蒙 HarmonyOS NEXT端云一体化开发-云函数篇
本文介绍基于华为AGC的端云一体化开发流程,涵盖项目创建、云函数开通、应用配置及DevEco集成。重点讲解云函数的编写、部署、调用与传参,并涉及环境变量设置、负载均衡、重试机制与熔断策略等高阶特性,助力开发者高效构建稳定云端服务。
193 0
鸿蒙 HarmonyOS NEXT端云一体化开发-云函数篇
|
20天前
|
存储 JSON 数据建模
鸿蒙 HarmonyOS NEXT端云一体化开发-云数据库篇
云数据库采用存储区、对象类型、对象三级结构,支持灵活的数据建模与权限管理,可通过AGC平台或本地项目初始化,实现数据的增删改查及端侧高效调用。
56 0
|
20天前
|
存储 开发者 容器
鸿蒙 HarmonyOS NEXT星河版APP应用开发-ArkTS面向对象及组件化UI开发使用实例
本文介绍了ArkTS语言中的Class类、泛型、接口、模块化、自定义组件及状态管理等核心概念,并结合代码示例讲解了对象属性、构造方法、继承、静态成员、访问修饰符等内容,同时涵盖了路由管理、生命周期和Stage模型等应用开发关键知识点。
156 0
鸿蒙 HarmonyOS NEXT星河版APP应用开发-ArkTS面向对象及组件化UI开发使用实例
|
20天前
鸿蒙 HarmonyOS NEXT星河版APP应用开发-阶段三
本文介绍了UI开发中的样式复用与组件构建技术,涵盖@Extend、@Styles和@Builder的使用方法,并通过Swiper轮播、Scroll滚动、Tabs导航等常用组件实现典型界面效果,结合生肖抽卡、小米轮播、回顶按钮等案例,展示实际应用技巧。
78 0
|
20天前
鸿蒙 HarmonyOS NEXT星河版APP应用开发-阶段二
本文介绍鸿蒙应用界面开发中的弹性布局(Flex)、绝对定位、层叠布局及ArkTS语法进阶,涵盖字符串拼接、类型转换、数组操作、条件与循环语句,并结合B站视频卡、支付宝首页等案例,深入讲解点击事件、状态管理与界面交互功能。
89 0
鸿蒙 HarmonyOS NEXT星河版APP应用开发-阶段二