鸿蒙开发实践案例分析——管理应用窗口（FA模型）

于 2025-06-06 17:31:48 发布
阅读量927 收藏 9
点赞数 24
分类专栏： HarmonyOS 移动开发 鸿蒙开发 文章标签： harmonyos OpenHarmony ArkTS ArkUI 移动开发 鸿蒙开发 鸿蒙系统
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2501_91726491/article/details/148479239
版权

📝往期推文全新看点（文中附带最新·鸿蒙全栈学习笔记）

1️⃣ 鸿蒙应用开发与鸿蒙系统开发哪个更有前景？

2️⃣ 嵌入式开发适不适合做鸿蒙南向开发？看完这篇你就了解了~

3️⃣ 对于大前端开发来说，转鸿蒙开发究竟是福还是祸？

4️⃣ 鸿蒙岗位需求突增！移动端、PC端、IoT到底该怎么选？

5️⃣ 记录一场鸿蒙开发岗位面试经历~

6️⃣ 持续更新中……

基本概念

窗口沉浸式能力：指对状态栏、导航栏等系统窗口进行控制，减少状态栏导航栏等系统界面的突兀感，从而使用户获得最佳体验的能力。 沉浸式能力只在应用主窗口作为全屏窗口时生效。通常情况下，应用子窗口（弹窗、悬浮窗口等辅助窗口）和处于自由窗口下的应用主窗口无法使用沉浸式能力。

场景介绍

在FA模型下，管理应用窗口的典型场景有：

  • 设置应用子窗口属性及目标页面
  • 体验窗口沉浸式能力

以下分别介绍具体开发方式。

接口说明

上述场景涉及的常用接口如下表所示。

设置应用子窗口

开发者可以按需创建应用子窗口，如弹窗等，并对其进行属性设置等操作。

开发步骤

  1. 创建/获取子窗口对象。

    • 可以通过window.createWindow接口创建子窗口。
    • 也可以通过window.findWindow接口来查找已经创建的窗口从而得到子窗口。
import window from '@ohos.window';
import { BusinessError } from '@ohos.base';

let windowClass: window.Window | null = null;
// 方式一：创建子窗口。
let config: window.Configuration = { name: "subWindow", windowType: window.WindowType.TYPE_APP };
window.createWindow(config, (err: BusinessError, data) => {
  let errCode: number = err.code;
  if (errCode) {
    console.error('Failed to create the subWindow. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Succeeded in creating subWindow. Data: ' + JSON.stringify(data));
  windowClass = data;
});
// 方式二：查找得到子窗口。
try {
  windowClass = window.findWindow('subWindow');
} catch (exception) {
  console.error('Failed to find the Window. Cause: ' + JSON.stringify(exception));
}

  1. 设置子窗口属性。

    子窗口创建成功后，可以改变其大小、位置等，还可以根据应用需要设置窗口背景色、亮度等属性。

// 移动子窗口位置。
let windowClass: window.Window = window.findWindow("test");
windowClass.moveWindowTo(300, 300, (err: BusinessError) => {
  let errCode: number = err.code;
  if (errCode) {
    console.error('Failed to move the window. Cause:' + JSON.stringify(err));
    return;
  }
  console.info('Succeeded in moving the window.');
});
// 改变子窗口大小。
windowClass.resize(500, 500, (err: BusinessError) => {
  let errCode: number = err.code;
  if (errCode) {
    console.error('Failed to change the window size. Cause:' + JSON.stringify(err));
    return;
  }
  console.info('Succeeded in changing the window size.');
});
  1. 加载显示子窗口的具体内容。

使用setUIContent和showWindow接口加载显示子窗口的具体内容。

// 为子窗口加载对应的目标页面。
let windowClass: window.Window = window.findWindow("test");
windowClass.setUIContent("pages/page2", (err: BusinessError) => {
  let errCode: number = err.code;
  if (errCode) {
    console.error('Failed to load the content. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Succeeded in loading the content.');
  // 显示子窗口。
  windowClass.showWindow((err: BusinessError) => {
    let errCode: number = err.code;
    if (errCode) {
      console.error('Failed to show the window. Cause: ' + JSON.stringify(err));
      return;
    }
    console.info('Succeeded in showing the window.');
  });
});

  1. 销毁子窗口。

    当不再需要某些子窗口时，可根据场景的具体实现逻辑，使用destroyWindow接口销毁子窗口。

// 销毁子窗口。当不再需要某些子窗口时，可根据场景的具体实现逻辑，使用destroy接口销毁子窗口。
let windowClass: window.Window = window.findWindow("test");
windowClass.destroyWindow((err: BusinessError) => {
  let errCode: number = err.code;
  if (errCode) {
    console.error('Failed to destroy the subwindow. Cause:' + JSON.stringify(err));
    return;
  }
  console.info('Succeeded in destroying the subwindow.');
});

体验窗口沉浸式能力

在看视频、玩游戏等场景下，用户往往希望隐藏状态栏、导航栏等不必要的系统窗口，从而获得更佳的沉浸式体验。此时可以借助窗口沉浸式能力（窗口沉浸式能力都是针对应用主窗口而言的），达到预期效果。从API version 10开始，沉浸式窗口默认配置为全屏大小并由组件模块控制布局，状态栏、导航栏背景颜色为透明，文字颜色为黑色；应用窗口调用setWindowLayoutFullScreen接口，设置为true表示由组件模块控制忽略状态栏、导航栏的沉浸式全屏布局，设置为false表示由组件模块控制避让状态栏、导航栏的非沉浸式全屏布局。

开发步骤

  1. 获取主窗口对象。

说明：
沉浸式能力需要在成功获取应用主窗口对象的前提下进行。

确保应用内最后显示的窗口为主窗口，然后再使用window.getLastWindow接口来获取得到主窗口。

import window from '@ohos.window';
import { BusinessError } from '@ohos.base';

let mainWindowClass: window.Window | null = null;

// 获取主窗口。
class BaseContext {
  stageMode: boolean = false;
}

let context: BaseContext = { stageMode: false };
window.getLastWindow(context, (err: BusinessError, data) => {
  let errCode: number = err.code;
  if (errCode) {
    console.error('Failed to get the subWindow. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Succeeded in getting subWindow. Data: ' + JSON.stringify(data));
  mainWindowClass = data;
});

  1. 实现沉浸式效果。有以下两种方式：

    • 方式一：应用主窗口为全屏窗口时，调用setWindowSystemBarEnable接口，设置导航栏、状态栏不显示，从而达到沉浸式效果。
    • 方式二：调用setWindowLayoutFullScreen接口，设置应用主窗口为全屏布局；然后调用setWindowSystemBarProperties接口，设置导航栏、状态栏的透明度、背景/文字颜色以及高亮图标等属性，使之保持与主窗口显示协调一致，从而达到沉浸式效果。
// 实现沉浸式效果。方式一：设置导航栏、状态栏不显示。
let names: Array<'status' | 'navigation'> = [];
let mainWindowClass: window.Window = window.findWindow("test");
mainWindowClass.setWindowSystemBarEnable(names, (err: BusinessError) => {
 let errCode: number = err.code;
 if (errCode) {
   console.error('Failed to set the system bar to be visible. Cause:' + JSON.stringify(err));
   return;
 }
 console.info('Succeeded in setting the system bar to be visible.');
});
// 实现沉浸式效果。
// 方式二：设置窗口为全屏布局，配合设置状态栏、导航栏的透明度、背景/文字颜色及高亮图标等属性，与主窗口显示保持协调一致。
let isLayoutFullScreen: boolean = true;
mainWindowClass.setWindowLayoutFullScreen(isLayoutFullScreen, (err: BusinessError) => {
 let errCode: number = err.code;
 if (errCode) {
   console.error('Failed to set the window layout to full-screen mode. Cause:' + JSON.stringify(err));
   return;
 }
 console.info('Succeeded in setting the window layout to full-screen mode.');
});
let sysBarProps: window.SystemBarProperties = {
 statusBarColor: '#ff00ff',
 navigationBarColor: '#00ff00',
 // 以下两个属性从API Version8开始支持。
 statusBarContentColor: '#ffffff',
 navigationBarContentColor: '#ffffff'
};
mainWindowClass.setWindowSystemBarProperties(sysBarProps, (err: BusinessError) => {
 let errCode: number = err.code;
 if (errCode) {
   console.error('Failed to set the system bar properties. Cause: ' + JSON.stringify(err));
   return;
 }
 console.info('Succeeded in setting the system bar properties.');
});

  1. 加载显示沉浸式窗口的具体内容。

    使用setUIContent和showWindow接口加载显示沉浸式窗口的具体内容。

// 为沉浸式窗口加载对应的目标页面。
let mainWindowClass: window.Window = window.findWindow("test");
mainWindowClass.setUIContent("pages/page3", (err: BusinessError) => {
  let errCode: number = err.code;
  if (errCode) {
    console.error('Failed to load the content. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Succeeded in loading the content.');
  // 显示沉浸式窗口。
  mainWindowClass.showWindow((err: BusinessError) => {
    let errCode: number = err.code;
    if (errCode) {
      console.error('Failed to show the window. Cause: ' + JSON.stringify(err));
      return;
    }
    console.info('Succeeded in showing the window.');
  });
});

OpenHarmony/HarmonyOS服务卡片详解
坚果的博客
03-23 1万+
FormExtensionAbility作为服务卡片扩展组件是一种界面展示形式，可以将应用的重要信息或操作前置到卡片，以达到服务直达，减少体验层级的目的。
操作系统领域，鸿蒙应用商店的兼容性_副本
最新发布
操作系统内核探秘的博客
05-02 824
随着物联网设备的爆发式增长，传统操作系统面临设备碎片化、应用适配成本高的难题。鸿蒙操作系统（HarmonyOS）通过分布式架构创新，构建了"设备即服务，服务即应用"的全新生态。本文聚焦鸿蒙应用商店的兼容性实现机制，解析其如何支持手机、平板、智能手表、智慧屏、物联网终端等多形态设备的应用无缝运行，为开发者提供跨设备适配的技术指南。核心概念：解析鸿蒙分布式架构下的兼容性核心要素技术实现：包括设备建模、适配算法、数学模型等关键技术实战指南：通过完整案例演示多端适配的开发与调试流程。
HarmonyOS 应用开发之管理应用窗口（FA模型）
1
03-29 1303
设置应用子窗口属性及目标页面体验窗口沉浸式能力以下分别介绍具体开发方式。
HarmonyOS ArkUI实战开发-窗口模块（Window）
1
04-22 1634
窗口模块用于在同一物理屏幕上，提供多个应用界面显示、交互的机制。
鸿蒙开发：【组件启动规则（FA模型）】
鸿蒙的技术博客
06-21 829
基于API 8或更早版本SDK开发的应用在启动ServiceAbility组件或DataAbility组件时不受此限制的约束。应用前后台判断标准：若应用进程获焦或所属的UIAbility位于前台则判定为前台应用，否则为后台应用。需校验权限（该权限仅系统应用可申请）。启动组件的具体校验流程见下文。
鸿蒙开发入门：应用配置文件概述（FA模型）
Android23333的博客
12-15 1207
这里整理了一份《鸿蒙零基础入门学习指南》，希望能对那些想要学习鸿蒙，但是有没有方向的人提供一点帮助。本文档适用于HarmonyOS应用开发的初学者（由于文档内容过多，因此为了避免影响到大家的阅读体验，在此只以截图展示部分内容，详细完整版的看文末有免费的获取方式！
新书速览|鸿蒙之光HarmonyOS NEXT原生应用开发入门
quanzhankaifaqua的博客
12-27 944
内容涵盖HarmonyOS架构、DevEco Studio使用、应用结构解析、ArkTS编程语言、Ability组件、ArkUI开发、公共事件处理、窗口管理、网络编程、安全管理、数据管理、多媒体开发、多端部署及应用测试等关键主题。书中不仅详细阐述了相关理论知识，还结合了多个实战项目，如计算器开发、WeLink打卡系统、图片轮播播放器、购物车功能实现、录音机与音乐播放器创建、购物应用设计与微信应用模拟、图片查看器构建等，旨在通过实际操作提升读者的动手能力和解决实际问题的能力。
鸿蒙HarmonyOS实战开发：分析AppFreeze（应用无响应）
m0_67143533的博客
11-18 1219
用户在使用应用时会出现点击没反应、应用无响应等情况，其超过一定时间限制后即被定义为应用无响应(appfreeze)。系统提供了检测应用无响应的机制，并生成appfreeze日志供应用开发分析。
【鸿蒙HarmonyOS简介与开发环境搭建】DevEco Studio安装与配置步骤
[【鸿蒙HarmonyOS简介与开发环境搭建】DevEco Studio安装与配置步骤](https://img-blog.csdnimg.cn/img_convert/a5aa1b0184c53b49699dc75112281132.png) # 1. 鸿蒙HarmonyOS概述 鸿蒙HarmonyOS是华为推出的全场景...
最全面鸿蒙系统开发的相关资料收录
Wscats
07-31 4943
开发 本示例基于 OpenHarmony 下的 JavaScript UI 框架，进行项目目录解读，JS FA、常用和自定义组件、用户交互、JS 动画的实现，通过本示例可以基本了解和学习到 JavaScript UI 的开发模式。 本项目是基于 OpenHarmony 项目而不是 HarmonyOS 项目，请注意运行环境。 请参考 OpenHarmony 项目配置方法 进行项目配置和运行。 如果你不熟悉 OpenHarmony 的 JS 开发，请参考该项目的 开发讲解。 示例 下载 awesome-har
HarmonyOS学习(九)——窗口管理
qi85481455的博客
09-09 1262
应用窗口是指与应用显示相关的窗口。根据显示内容的不同，应用窗口分为** 应用主窗口** 和应用子窗口应用主窗口应用主窗口用于显示应用界面，会在“任务管理”界面显示应用子窗口应用子窗口用于显示应用的弹窗，悬浮窗等辅助窗口，不会在“任务管理”界面显示。
OpenHarmony实战开发-如何通过窗口管理相关接口实现屏幕常亮。
2401_82546228的博客
05-24 970
在使用开发板进行应用开发调试时，不操作屏幕一段时间后，屏幕会熄屏变黑，再操作时需要再次点亮屏幕，耗费时间不利于调试。本例将介绍如何通过窗口管理相关接口实现屏幕常亮。
HarmonyOS鸿蒙应用配置文件（FA模型）_fa mode, 鸿蒙(2)
2401_84182936的博客
04-17 1040
config.json由app、deviceConfig和module三个部分组成，缺一不可。在FA模型的应用开发过程中，需要在config.json配置文件中对应用的包结构进行声明。
OpenHarmony实战开发-管理系统窗口（仅Stage模型支持）
2401_82546228的博客
05-06 1057
在Stage模型下， 允许系统应用创建和管理系统窗口，包括音量条、壁纸、通知栏、状态栏、导航栏等。
鸿蒙FA入坑笔记
薆的天空
02-24 8756
HarmonyOS FA应用入坑指南
【OpenHarmony实战开发】如何实现窗口开发概述
HarmonyOS007的博客
07-29 1027
●如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我三个小忙：●关注小编，同时可以期待后续文章ing🚀，不定期分享原创知识。
鸿蒙NEXT版实战开发：管理应用窗口（FA模型）
qq_39652397的博客
09-30 1064
沉浸式能力只在应用主窗口作为全屏窗口时生效。
OpenHarmony开发实战：构建多种样式弹窗（ArkTS），2024年最新鸿蒙面试2024
2301_82243558的博客
04-15 817
点击兴趣爱好选项，通过customDialogController.open方法弹出自定义弹窗，根据需要选择相应的兴趣爱好，效果如图所示：在view目录下，点击鼠标右键 > New > ArkTS File，新建一个ArkTS文件，然后命名为CustomDialogWeight子组件。在CustomDialogWeight的aboutToAppear方法，通过manager.getStringArrayValue方法获取本地资源数据进行初始化。return;if (!
鸿蒙HarmonyOS开发-FA模型访问Stage模型DataShareExtensionAbility
1
03-26 861
无论FA模型还是Stage模型，数据读写功能都包含客户端和服务端两部分。FA模型中，客户端是由DataAbilityHelper提供对外接口，服务端是由DataAbility提供数据库的读写服务。Stage模型中，客户端是由DataShareHelper提供对外接口，服务端是由DataShareExtensionAbility提供数据库的读写服务。服务端由FA模型升级到Stage模型后，会导致FA模型的客户端在API 9(含)之后的版本上无法访问服务端。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值