输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心
全部文档版本说明工具设计指南与API参考开发与测试上架分发与运营问题处理与运维最佳实践行业解决方案
问题处理与运维

PC端点击Dock栏关闭窗口时，如何弹窗确认

更新时间: 2026-06-26 07:47
复制页面
本文导读

问题现象

HarmonyOS PC端应用最小化Dock栏后，如何在应用右键点击关闭窗口时，增加一个二次确认弹窗给到用户操作。

背景知识

  • onPrepareToTerminate：在UIAbility即将关闭前（例如用户通过点击应用窗口右上角的关闭按钮、或者通过Dock栏/托盘右键退出应用时），系统会触发该回调，用于在UIAbility正式关闭前执行其他操作。
  • 开发者可以在onPrepareToTerminate回调中返回true阻拦此次关闭，然后在合适时机主动调用terminateSelf接口关闭。
  • showDialog：创建并显示对话框，对话框响应结果使用callback异步回调返回。

解决方案

HarmonyOS PC端应用最小化Dock栏后，可以通过监听onPrepareToTerminate回调，在触发右键点击关闭窗口时，恢复主窗口并弹窗通知用户二次确认后再关闭窗口。

  • 在module.json5配置文件中声明ohos.permission.PREPARE_APP_TERMINATE权限。
    收起
    自动换行
    深色代码主题
    复制
    1. "requestPermissions":[
    2.   {
    3.     "name" : "ohos.permission.PREPARE_APP_TERMINATE"
    4.   }
    5. ],
  • 在EntryAbility.ets文件中添加onPrepareToTerminate回调事件，在Dock栏关闭窗口时，进行弹窗提示。
    收起
    自动换行
    深色代码主题
    复制
    1. import { ConfigurationConstant, UIAbility } from '@kit.AbilityKit';
    2. import { hilog } from '@kit.PerformanceAnalysisKit';
    3. import { window } from '@kit.ArkUI';
    4. import { BusinessError } from '@kit.BasicServicesKit';
    5. 

    6. 

    7. const DOMAIN = 0x0000;
    8. 

    9. 

    10. export default class EntryAbility extends UIAbility {
    11.   //当前window对象
    12.   private currentWindowStage: window.WindowStage | null = null;
    13. 

    14.   onCreate(): void {
    15.     this.context.getApplicationContext().setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_NOT_SET);
    16. 

    17.     hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onCreate');
    18.   }
    19. 

    20.   onDestroy(): void {
    21.     hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onDestroy');
    22.   }
    23. 

    24.   onWindowStageCreate(windowStage: window.WindowStage): void {
    25.     // Main window is created, set main page for this ability
    26.     hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onWindowStageCreate');
    27. 

    28.     if (this.currentWindowStage === null) {
    29.       this.currentWindowStage = windowStage;
    30.     }
    31.     // 存储windowStage
    32.     AppStorage.setOrCreate('windowStage', windowStage);
    33.     windowStage.loadContent('pages/Index', (err) => {
    34.       // 存储windowStatus
    35.       AppStorage.setOrCreate('windowStatus', window.WindowStatusType.FULL_SCREEN);
    36.       windowStage.getMainWindow((err: BusinessError, data) => {
    37.         if (err) {
    38.           // To do sth.
    39.         }
    40.         let windowClass = data;
    41.         windowClass.on('windowStatusChange', (windowStatusType) => {
    42.           AppStorage.setOrCreate('windowStatus', windowStatusType);
    43.         });
    44.       });
    45.       if (err.code) {
    46.         hilog.error(DOMAIN, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err));
    47.         return;
    48.       }
    49.       hilog.info(DOMAIN, 'testTag', 'Succeeded in loading the content.');
    50.     });
    51. 

    52.   }
    53. 

    54.   onWindowStageDestroy(): void {
    55.     // Main window is destroyed, release UI related resources
    56.     hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onWindowStageDestroy');
    57.   }
    58. 

    59.   onForeground(): void {
    60.     // Ability has brought to foreground
    61.     hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onForeground');
    62.   }
    63. 

    64.   onBackground(): void {
    65.     // Ability has back to background
    66.     hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onBackground');
    67.   }
    68. 

    69.   onPrepareToTerminate(): boolean {
    70.     // 开发者定义预关闭动作
    71.     hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onPrepareToTerminate');
    72.     // 例如关闭应用之前弹窗提示是否关闭app
    73.     let windowStatus = AppStorage.get('windowStatus') as window.WindowStatusType;
    74.     if (windowStatus == window.WindowStatusType.MINIMIZE) {
    75.       let mainWindowClass = this.currentWindowStage?.getMainWindowSync() as window.Window;
    76.       let promise = mainWindowClass.restore();
    77.       promise.then(() => {
    78.         console.info('Succeeded in restoring the window.');
    79.         if (this.currentWindowStage !== null) {
    80.           this.currentWindowStage?.getMainWindowSync().getUIContext().getPromptAction().showDialog({
    81.             title: '提示',
    82.             message: '确认是否关闭APP？',
    83.             buttons: [
    84.               {
    85.                 text: '取消',
    86.                 color: '#0091FF'
    87.               },
    88.               {
    89.                 text: '确定',
    90.                 color: '#ff0000'
    91.               }
    92.             ]
    93.           }).then(data => {
    94.             if (data.index === 0) {
    95.               this.currentWindowStage?.getMainWindowSync().getUIContext().getPromptAction().showToast({
    96.                 message: '已取消',
    97.                 duration: 2000
    98.               });
    99.             } else {
    100.               // 确认关闭
    101.               this.context.terminateSelf();
    102.             }
    103.           });
    104.         }
    105.       }).catch((err: BusinessError) => {
    106.         console.error(`Failed to restore the window. Cause code: ${err.code},
    107.                   message: ${err.message}`);
    108.       });
    109.       return true;
    110.     } else {
    111.       if (this.currentWindowStage !== null) {
    112.         this.currentWindowStage?.getMainWindowSync().getUIContext().getPromptAction().showDialog({
    113.           title: '提示',
    114.           message: '确认是否关闭APP？',
    115.           buttons: [
    116.             {
    117.               text: '取消',
    118.               color: '#0091FF'
    119.             },
    120.             {
    121.               text: '确定',
    122.               color: '#ff0000'
    123.             }
    124.           ]
    125.         }).then(data => {
    126.           if (data.index === 0) {
    127.             this.currentWindowStage?.getMainWindowSync().getUIContext().getPromptAction().showToast({
    128.               message: '已取消',
    129.               duration: 2000
    130.             });
    131.           } else {
    132.             // 确认关闭
    133.             this.context.terminateSelf();
    134.           }
    135.         });
    136.       }
    137.     }
    138.     return true;
    139.   }
    140. };
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明