harmony 鸿蒙ApplicationContext

  • 2022-12-13
  • 浏览 (889)

ApplicationContext

ApplicationContext模块提供开发者应用级别的的上下文的能力，包括提供注册及取消注册应用内组件生命周期的监听接口。

说明：

本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 本模块接口仅可在Stage模型下使用。

导入模块

import common from '@ohos.app.ability.common';

使用说明

在使用ApplicationContext的功能前，需要通过context的实例获取。

ApplicationContext.on(type: ‘abilityLifecycle’, callback: AbilityLifecycleCallback)

on(type: ‘abilityLifecycle’, callback: AbilityLifecycleCallback): number;

注册监听应用内生命周期

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名 类型 必填 说明
type ‘abilityLifecycle’ 是 监听事件的类型。
callback AbilityLifecycleCallback 是 回调方法，返回注册监听事件的ID。

返回值：

类型 说明
number 返回的此次注册监听生命周期的ID（每次注册该ID会自增+1，当超过监听上限数量2^63-1时，返回-1）。

示例：

import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';

let lifecycleId: number;

export default class EntryAbility extends UIAbility {
    onCreate() {
        console.log('MyAbility onCreate');
        let AbilityLifecycleCallback: AbilityLifecycleCallback = {
            onAbilityCreate(ability) {
                console.log(`AbilityLifecycleCallback onAbilityCreate ability: ${ability}`);
            },
            onWindowStageCreate(ability, windowStage) {
                console.log(`AbilityLifecycleCallback onWindowStageCreate ability: ${ability}`);
                console.log(`AbilityLifecycleCallback onWindowStageCreate windowStage: ${windowStage}`);
            },
            onWindowStageActive(ability, windowStage) {
                console.log(`AbilityLifecycleCallback onWindowStageActive ability: ${ability}`);
                console.log(`AbilityLifecycleCallback onWindowStageActive windowStage: ${windowStage}`);
            },
            onWindowStageInactive(ability, windowStage) {
                console.log(`AbilityLifecycleCallback onWindowStageInactive ability: ${ability}`);
                console.log(`AbilityLifecycleCallback onWindowStageInactive windowStage: ${windowStage}`);
            },
            onWindowStageDestroy(ability, windowStage) {
                console.log(`AbilityLifecycleCallback onWindowStageDestroy ability: ${ability}`);
                console.log(`AbilityLifecycleCallback onWindowStageDestroy windowStage: ${windowStage}`);
            },
            onAbilityDestroy(ability) {
                console.log(`AbilityLifecycleCallback onAbilityDestroy ability: ${ability}`);
            },
            onAbilityForeground(ability) {
                console.log(`AbilityLifecycleCallback onAbilityForeground ability: ${ability}`);
            },
            onAbilityBackground(ability) {
                console.log(`AbilityLifecycleCallback onAbilityBackground ability: ${ability}`);
            },
            onAbilityContinue(ability) {
                console.log(`AbilityLifecycleCallback onAbilityContinue ability: ${ability}`);
            }
        }
        // 1.通过context属性获取applicationContext
        let applicationContext = this.context.getApplicationContext();
        // 2.通过applicationContext注册监听应用内生命周期
        lifecycleId = applicationContext.on('abilityLifecycle', AbilityLifecycleCallback);
        console.log(`registerAbilityLifecycleCallback lifecycleId: ${lifecycleId}`);
    }
}

ApplicationContext.off(type: ‘abilityLifecycle’, callbackId: number, callback: AsyncCallback<void>)

off(type: ‘abilityLifecycle’, callbackId: number, callback: AsyncCallback<void>): void;

取消监听应用内生命周期

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名 类型 必填 说明
type ‘abilityLifecycle’ 是 取消监听事件的类型。
callbackId number 是 注册监听应用内生命周期的ID。
callback AsyncCallback<void> 是 回调方法。

示例：

import UIAbility from '@ohos.app.ability.UIAbility';

let lifecycleId: number;

export default class EntryAbility extends UIAbility {
    onDestroy() {
        let applicationContext = this.context.getApplicationContext();
        console.log(`stage applicationContext: ${applicationContext}`);
        applicationContext.off('abilityLifecycle', lifecycleId, (error, data) => {
            if (error) {
                console.error(`unregisterAbilityLifecycleCallback fail, err: ${JSON.stringify(error)}`);    
            } else {
                console.log(`unregisterAbilityLifecycleCallback success, data: ${JSON.stringify(data)}`);
            }
        });
    }
}

ApplicationContext.off(type: ‘abilityLifecycle’, callbackId: number)

off(type: ‘abilityLifecycle’, callbackId: number): Promise<void>;

取消监听应用内生命周期

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名 类型 必填 说明
type ‘abilityLifecycle’ 是 取消监听事件的类型。
callbackId number 是 注册监听应用内生命周期的ID。

示例：

import Ability from '@ohos.app.ability.UIAbility';

let lifecycleId: number;

export default class MyAbility extends Ability {
    onDestroy() {
        let applicationContext = this.context.getApplicationContext();
        console.log(`stage applicationContext: ${applicationContext}`);
        applicationContext.off('abilityLifecycle', lifecycleId);
    }
}

ApplicationContext.on(type: ‘environment’, callback: EnvironmentCallback)

on(type: ‘environment’, callback: EnvironmentCallback): number;

注册对系统环境变化的监听。使用callback异步回调。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名 类型 必填 说明
type ‘environment’ 是 监听事件的类型。
callback EnvironmentCallback 是 回调方法，返回注册监听事件的ID。

返回值：

类型 说明
number 返回的此次注册监听系统环境变化的ID（每次注册该ID会自增+1，当超过监听上限数量2^63-1时，返回-1）。

示例：

import UIAbility from '@ohos.app.ability.UIAbility';
import EnvironmentCallback from '@ohos.app.ability.EnvironmentCallback';

let callbackId: number;

export default class EntryAbility extends UIAbility {
    onCreate() {
        console.log('MyAbility onCreate')
        let environmentCallback: EnvironmentCallback = {
            onConfigurationUpdated(config){
                console.log(`onConfigurationUpdated config: ${JSON.stringify(config)}`);
            },
            onMemoryLevel(level){
                console.log('onMemoryLevel level: ${level}');
            }
        };
        // 1.获取applicationContext
        let applicationContext = this.context.getApplicationContext();
        // 2.通过applicationContext注册监听系统环境变化
        callbackId = applicationContext.on('environment', environmentCallback);
        console.log(`registerEnvironmentCallback callbackId: ${callbackId}`);
    }
}

ApplicationContext.off(type: ‘environment’, callbackId: number, callback: AsyncCallback<void>)

off(type: ‘environment’, callbackId: number, callback: AsyncCallback<void>): void;

取消对系统环境变化的监听。使用callback异步回调。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名 类型 必填 说明
type ‘environment’ 是 取消监听事件的类型。
callbackId number 是 注册监听系统环境变化的ID。
callback AsyncCallback<void> 是 回调方法。

示例：

import UIAbility from '@ohos.app.ability.UIAbility';

let callbackId: number;

export default class EntryAbility extends UIAbility {
    onDestroy() {
        let applicationContext = this.context.getApplicationContext();
        applicationContext.off('environment', callbackId, (error, data) => {
            if (error) {
                console.error(`unregisterEnvironmentCallback fail, err: ${JSON.stringify(error)}`);
            } else {
                console.log(`unregisterEnvironmentCallback success, data: ${JSON.stringify(data)}`);
            }
        });
    }
}

ApplicationContext.off(type: ‘environment’, callbackId: number)

off(type: ‘environment’, callbackId: number, callback: AsyncCallback<void>): void;

取消对系统环境变化的监听。使用callback异步回调。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名 类型 必填 说明
type ‘environment’ 是 取消监听事件的类型。
callbackId number 是 注册监听系统环境变化的ID。

示例：

import Ability from '@ohos.app.ability.UIAbility';

let callbackId: number;

export default class MyAbility extends Ability {
    onDestroy() {
        let applicationContext = this.context.getApplicationContext();
        applicationContext.off('environment', callbackId);
    }
}

ApplicationContext.on(type: ‘applicationStateChange’, callback: ApplicationStateChangeCallback)10+

on(type: ‘applicationStateChange’, callback: ApplicationStateChangeCallback): void;

注册对当前应用前后台变化的监听。使用callback异步回调。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名 类型 必填 说明
type string 是 监听事件类型，必须为’applicationStateChange’。
callback ApplicationStateChangeCallback 是 对于该事件监听的回调方法，可以对应用从后台切换到前台，以及前台切换到后台分别定义回调。

示例：

import UIAbility from '@ohos.app.ability.UIAbility';
import ApplicationStateChangeCallback from '@ohos.app.ability.ApplicationStateChangeCallback';

export default class MyAbility extends UIAbility {
    onCreate() {
        console.log('MyAbility onCreate');
        let applicationStateChangeCallback: ApplicationStateChangeCallback = {
            onApplicationForeground() {
                console.info('applicationStateChangeCallback onApplicationForeground');
            },
            onApplicationBackground() {
                console.info('applicationStateChangeCallback onApplicationBackground');
            }
        }

        // 1.获取applicationContext
        let applicationContext = this.context.getApplicationContext();
        // 2.通过applicationContext注册应用前后台状态监听
        applicationContext.on('applicationStateChange', applicationStateChangeCallback);
        console.log('Resgiter applicationStateChangeCallback');
    }
}

ApplicationContext.off(type: ‘applicationStateChange’)10+

off(type: ‘applicationStateChange’, callback?: ApplicationStateChangeCallback): void;

取消当前应用注册的前后台变化的全部监听。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名 类型 必填 说明
type string 是 取消监听事件的类型,必须为’applicationStateChange’。
callback ApplicationStateChangeCallback 否 对于该事件监听的回调方法，可以对应用从后台切换到前台，以及前台切换到后台分别定义回调。

示例：

import UIAbility from '@ohos.app.ability.UIAbility';

export default class MyAbility extends UIAbility {
    onDestroy() {
        let applicationContext = this.context.getApplicationContext();
        applicationContext.off('applicationStateChange');
    }
}

ApplicationContext.getRunningProcessInformation9+

getRunningProcessInformation(): Promise<Array<ProcessInformation>>;

获取有关运行进程的信息。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

返回值：

类型 说明
Promise<Array<ProcessInformation>> 以Promise方式返回接口运行结果及有关运行进程的信息，可进行错误处理或其他自定义处理。

错误码：

错误码ID 错误信息
16000011 The context does not exist.
16000050 Internal error.

以上错误码详细介绍请参考errcode-ability。

示例：

import UIAbility from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';

export default class MyAbility extends UIAbility {
    onForeground() {
        let applicationContext = this.context.getApplicationContext();
        applicationContext.getRunningProcessInformation().then((data) => {
            console.log(`The process running information is: ${JSON.stringify(data)}`);
        }).catch((error: BusinessError) => {
            console.error(`error: ${JSON.stringify(error)}`);
        });
    }
}

ApplicationContext.getRunningProcessInformation9+

getRunningProcessInformation(callback: AsyncCallback<Array<ProcessInformation>>): void;

获取有关运行进程的信息。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

返回值：

类型 说明
AsyncCallback<Array<ProcessInformation>> 以回调方式返回接口运行结果及有关运行进程的信息，可进行错误处理或其他自定义处理。

错误码：

错误码ID 错误信息
16000011 The context does not exist.
16000050 Internal error.

以上错误码详细介绍请参考errcode-ability。

示例：

import UIAbility from '@ohos.app.ability.UIAbility';

export default class MyAbility extends UIAbility {
    onForeground() {
        let applicationContext = this.context.getApplicationContext();
        applicationContext.getRunningProcessInformation((err, data) => {
            if (err) {
                console.error(`getRunningProcessInformation faile, err: ${JSON.stringify(err)}`);
            } else {
                console.log(`The process running information is: ${JSON.stringify(data)}`);
            }
        })
    }
}

ApplicationContext.killAllProcesses9+

killAllProcesses(): Promise<void>;

杀死应用所在的进程。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

返回值：

类型 说明
Promise<void> 以Promise方式返回杀死应用所在的进程结果。

错误码：

错误码ID 错误信息
16000011 The context does not exist.

以上错误码详细介绍请参考errcode-ability。

示例：

import UIAbility from '@ohos.app.ability.UIAbility';

export default class MyAbility extends UIAbility {
    onBackground() {
        let applicationContext = this.context.getApplicationContext();
        applicationContext.killAllProcesses();
    }
}

ApplicationContext.killAllProcesses9+

killAllProcesses(callback: AsyncCallback<void>);

杀死应用所在的进程。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

返回值：

类型 说明
AsyncCallback<void> 以callback方式返回杀死应用所在的进程结果。

错误码：

错误码ID 错误信息
16000011 The context does not exist.

以上错误码详细介绍请参考errcode-ability。

示例：

import UIAbility from '@ohos.app.ability.UIAbility';

export default class MyAbility extends UIAbility {
    onBackground() {
        let applicationContext = this.context.getApplicationContext();
        applicationContext.killAllProcesses(error => {
            if (error) {
                console.error(`killAllProcesses fail, error: ${JSON.stringify(error)}`);
            }
        });
    }
});

ApplicationContext.setColorMode11+

setColorMode(colorMode: ConfigurationConstant.ColorMode): void;

设置应用的颜色模式。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名 类型 必填 说明
colorMode ConfigurationConstant.ColorMode 是 设置颜色模式，包括：深色模式、浅色模式、不设置（跟随系统）

错误码：

错误码ID 错误信息
16000011 The context does not exist.
401 If the input parameter is not valid parameter.

以上错误码详细介绍请参考errcode-ability。

示例：

import UIAbility from '@ohos.app.ability.UIAbility';
import ConfigurationConstant from '@ohos.app.ability.ConfigurationConstant';

export default class MyAbility extends UIAbility {
  onCreate() {
    let applicationContext = this.context.getApplicationContext();
    applicationContext.setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_DARK);
  }
}

ApplicationContext.setLanguage11+

setLanguage(language: string): void;

设置应用的语言。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名 类型 必填 说明
language string 是 设置语言，当前支持的语言列表可以通过@ohos.i18n.d.ts中的static getSystemLanguage(): Array;获取

错误码：

错误码ID 错误信息
16000011 The context does not exist.
401 If the input parameter is not valid parameter.

以上错误码详细介绍请参考errcode-ability。

示例：

import UIAbility from '@ohos.app.ability.UIAbility';

export default class MyAbility extends UIAbility {
  onCreate() {
    let applicationContext = this.context.getApplicationContext();
    applicationContext.setLanguage('zh-cn');
  }
}

ApplicationContext.clearUpApplicationData11

clearUpApplicationData(): Promise<void>;

清理应用本身的数据。使用Promise异步回调。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

返回值：

类型 说明
Promise<void> 无返回结果的Promise对象。

错误码：

错误码ID 错误信息
16000011 The context does not exist.
16000050 Internal error.

以上错误码详细介绍请参考errcode-ability。

示例：

import UIAbility from '@ohos.app.ability.UIAbility';

export default class MyAbility extends UIAbility {
    onBackground() {
        let applicationContext = this.context.getApplicationContext();
        applicationContext.clearUpApplicationData();
    }
}

ApplicationContext.clearUpApplicationData11

clearUpApplicationData(callback: AsyncCallback): void;

清理应用本身的数据。使用callback异步回调。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数： |参数名 |类型 |必填|说明 | |————-|——–|—-|————————–| |callback|AsyncCallback<void>|是 |回调方法。清理应用本身的数据成功时，err为undefined，否则返回错误对象。|

错误码：

错误码ID 错误信息
16000011 The context does not exist.
16000050 Internal error.

以上错误码详细介绍请参考errcode-ability。

示例：

import UIAbility from '@ohos.app.ability.UIAbility';
export default class MyAbility extends UIAbility {
    onBackground() {
        let applicationContext = this.context.getApplicationContext();
        applicationContext.clearUpApplicationData(error => {
            if (error) {
                console.error(`clearUpApplicationData fail, error: ${JSON.stringify(error)}`);
            }
        });
    }
}

ApplicationContext.on11+

on(type: ‘abilityAutoStartup’, callback: AutoStartupCallback): void;

应用注册对自身开机自启动状态变化的监听。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名 类型 必填 说明
type string 是 注册监听事件的类型,必须为”abilityAutoStartup”。
callback AutoStartupCallback 是 注册监听应用开机自启动状态变化的回调对象。

示例：

import UIAbility from '@ohos.app.ability.UIAbility';

export default class MyAbility extends UIAbility {
  onBackground() {
    let applicationContext = this.context.getApplicationContext();
    let autoStartupCallback = {
      onAutoStartupOn(data) {
        console.info('===> autostartupmanager onAutoStartupOn data: ' + JSON.stringify(data));
      },
      onAutoStartupOff(data) {
        console.info('===> autostartupmanager onAutoStartupOff data: ' + JSON.stringify(data));
      }
    };
    try {
      applicationContext.on('abilityAutoStartup', autoStartupCallback);
    } catch (err) {
      console.info('===> autostartupmanager on throw err: ' + JSON.stringify(err));
    }
  }
}

ApplicationContext.off11+

off(type: ‘abilityAutoStartup’, callback: AutoStartupCallback): void;

应用注销对自身开机自启动状态变化的监听。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名 类型 必填 说明
type string 是 注册监听事件的类型,必须为”abilityAutoStartup”。
callback AutoStartupCallback 是 注销监听应用开机自启动状态变化的回调对象。

示例：

import UIAbility from '@ohos.app.ability.UIAbility';

export default class MyAbility extends UIAbility {
  onBackground() {
    let applicationContext = this.context.getApplicationContext();
    let autoStartupCallback = {
      onAutoStartupOn(data) {
        console.info('===> autostartupmanager onAutoStartupOn data: ' + JSON.stringify(data));
      },
      onAutoStartupOff(data) {
        console.info('===> autostartupmanager onAutoStartupOff data: ' + JSON.stringify(data));
      }
    };
    try {
      applicationContext.off('abilityAutoStartup', autoStartupCallback);
    } catch (err) {
      console.info('===> autostartupmanager off throw err: ' + JSON.stringify(err));
    }
  }
}

ApplicationContext.setAutoStartup11+

setAutoStartup(info: AutoStartupInfo, callback: AsyncCallback<void>): void;

应用设置为开机自启动。使用callback异步回调。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名 类型 必填 说明
info AutoStartupInfo 是 设置开机自启动的应用组件信息。
callback AsyncCallback<void> 是 回调函数。当设置为开机自启动成功，err为undefined，否则为错误对象。

示例：

import UIAbility from '@ohos.app.ability.UIAbility';

export default class MyAbility extends UIAbility {
  onBackground() {
    let applicationContext = this.context.getApplicationContext();
    try {
      applicationContext.setAutoStartup({
        bundleName: 'com.example.autostartupapp',
        abilityName: 'EntryAbility'
      }, (err, data) => {
        console.info('====> err: ' + JSON.stringify(err) + ' data: ' + JSON.stringify(data));
      });
    } catch (err) {
      console.info('===> autostartupmanager setAutoStartup throw err: ' + JSON.stringify(err));
    }
  }
}

ApplicationContext.setAutoStartup11+

setAutoStartup(info: AutoStartupInfo): Promise<void>;

应用设置为开机自启动。使用Promise异步回调。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名 类型 必填 说明
info AutoStartupInfo 是 设置开机自启动的应用组件信息。

返回值：

类型 说明
Promise<void> Promise对象。无返回结果的Promise对象。

示例：

import UIAbility from '@ohos.app.ability.UIAbility';

export default class MyAbility extends UIAbility {
  onBackground() {
    let applicationContext = this.context.getApplicationContext();
    try {
      applicationContext.setAutoStartup({
        bundleName: 'com.example.autostartupapp',
        abilityName: 'EntryAbility'
      }).then((data) => {
        console.info('====> setAutoStartup data: ' + JSON.stringify(data));
      }).catch((err) => {
        console.info('====> setAutoStartup err: ' + JSON.stringify(err));
      });
    } catch (err) {
      console.info('===> autostartupmanager setAutoStartup throw err: ' + JSON.stringify(err));
    }
  }
}

ApplicationContext.cancelAutoStartup11+

cancelAutoStartup(info: AutoStartupInfo, callback: AsyncCallback<void>): void;

应用取消开机自启动。使用callback异步回调。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名 类型 必填 说明
info AutoStartupInfo 是 取消开机自启动的应用组件信息。
callback AsyncCallback<void> 是 回调函数。当取消开机自启动成功，err为undefined，否则为错误对象。

示例：

import UIAbility from '@ohos.app.ability.UIAbility';

export default class MyAbility extends UIAbility {
  onBackground() {
    let applicationContext = this.context.getApplicationContext();
    try {
      applicationContext.cancelAutoStartup({
        bundleName: 'com.example.autostartupapp',
        abilityName: 'EntryAbility'
      }, (err, data) => {
        console.info('====> err: ' + JSON.stringify(err) + ' data: ' + JSON.stringify(data));
      });
    } catch (err) {
      console.info('===> autostartupmanager cancelAutoStartup throw err: ' + JSON.stringify(err));
    }
  }
}

ApplicationContext.cancelAutoStartup11+

cancelAutoStartup(info: AutoStartupInfo): Promise<void>;

应用取消开机自启动。使用Promise异步回调。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名 类型 必填 说明
info AutoStartupInfo 是 取消开机自启动的应用组件信息。

返回值：

类型 说明
Promise<void> Promise对象。无返回结果的Promise对象。

示例：

import UIAbility from '@ohos.app.ability.UIAbility';

export default class MyAbility extends UIAbility {
  onBackground() {
    let applicationContext = this.context.getApplicationContext();
    try {
      applicationContext.cancelAutoStartup({
        bundleName: 'com.example.autostartupapp',
        abilityName: 'EntryAbility'
      }).then((data) => {
          console.info('====> cancelAutoStartup data: ' + JSON.stringify(data));
      }).catch((err) => {
          console.info('====> cancelAutoStartup err: ' + JSON.stringify(err));
      });
    } catch (err) {
      console.info('===> autostartupmanager cancelAutoStartup throw err: ' + JSON.stringify(err));
    }
  }
}

ApplicationContext.isAutoStartup11+

isAutoStartup(info: AutoStartupInfo, callback: AsyncCallback<boolean>): void;

应用查询自身组件是否开机自启动。使用callback异步回调。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名 类型 必填 说明
info AutoStartupInfo 是 查询是否开机启动的应用自身组件的信息。
callback AsyncCallback<boolean> 是 回调函数。返回true表示查询的应用组件是开机自启动；返回false表示查询的应用组件不是开机自启动。

示例：

import UIAbility from '@ohos.app.ability.UIAbility';

export default class MyAbility extends UIAbility {
  onBackground() {
    let applicationContext = this.context.getApplicationContext();
    try {
      applicationContext.isAutoStartup({
        bundleName: 'com.example.autostartupapp',
        abilityName: 'EntryAbility'
      }, (err, data) => {
        console.info('====> err: ' + JSON.stringify(err) + ' data: ' + JSON.stringify(data));
      });
    } catch (err) {
      console.info('===> autostartupmanager isAutoStartup throw err: ' + JSON.stringify(err));
    }
  }
}

ApplicationContext.isAutoStartup11+

isAutoStartup(info: AutoStartupInfo): Promise<boolean>;

应用查询自身组件是否开机自启动。使用Promise异步回调。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

参数名 类型 必填 说明
info AutoStartupInfo 是 查询是否开机启动的应用自身组件的信息。

返回值：

类型 说明
Promise<boolean> Promise对象。返回true表示查询的应用组件是开机自启动；返回false表示查询的应用组件不是开机自启动。

示例：

import UIAbility from '@ohos.app.ability.UIAbility';

export default class MyAbility extends UIAbility {
  onBackground() {
    let applicationContext = this.context.getApplicationContext();
    try {
      applicationContext.isAutoStartup({
        bundleName: 'com.example.autostartupapp',
        abilityName: 'EntryAbility'
      }).then((data) => {
        console.info('====> isAutoStartup data: ' + JSON.stringify(data));
      }).catch((err) => {
        console.info('====> isAutoStartup err: ' + JSON.stringify(err));
      });
    } catch (err) {
      console.info('===> autostartupmanager isAutoStartup throw err: ' + JSON.stringify(err));
    }
  }
}

你可能感兴趣的鸿蒙文章

harmony 鸿蒙接口

harmony 鸿蒙系统公共事件定义(待停用)

harmony 鸿蒙系统公共事件定义

harmony 鸿蒙开发说明

harmony 鸿蒙企业设备管理概述（仅对系统应用开放）

harmony 鸿蒙BundleStatusCallback

harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager模块)

harmony 鸿蒙@ohos.distributedBundle (分布式包管理)

harmony 鸿蒙@ohos.bundle (Bundle模块)

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)

0  赞
  • 所属分类： 后端技术
  • 本文标签：
  • 版权声明： 原创文章如转载，请注明本文链接: https://www.seaxiang.com/blog/0df1ec509ff54fc1b3e50b26351e679c
热门推荐
标签云
Linux Java Spring Spring Boot docker 大数据 前端 生活 maven golang 软件 spring cloud fintech mac vscode 其他 区块链 以太坊 V神 开发者 技术 股票 git greenplum 分布式事务 chrome mysql flink kafka 设计模式 原理 鸿蒙 seo
最新文章
本文目录