harmony 鸿蒙Ability Subsystem Changelog

  • 2025-06-12
  • 浏览 (25)

Ability Subsystem Changelog

cl.ability.1 Auto Startup Related APIs in ApplicationContext Are Deleted

Access Level

Public API

Reason for Change

According to security and privacy requirements, APIs related to auto startup in ApplicationContext are deleted. Applications cannot proactively set the auto startup status.

Change Impact

This change is a non-compatible change. If your code uses the involved APIs, delete them.

API Level

11

Change Since

OpenHarmony SDK 4.1.6.5

Key API/Component Changes

  on(type: 'abilityAutoStartup', callback: AutoStartupCallback): void;
  off(type: 'abilityAutoStartup', callback?: AutoStartupCallback): void;
  setAutoStartup(info: AutoStartupInfo, callback: AsyncCallback<void>): void;
  setAutoStartup(info: AutoStartupInfo): Promise<void>;
  cancelAutoStartup(info: AutoStartupInfo, callback: AsyncCallback<void>): void;
  cancelAutoStartup(info: AutoStartupInfo): Promise<void>;
  isAutoStartup(info: AutoStartupInfo, callback: AsyncCallback<boolean>): void;
  isAutoStartup(info: AutoStartupInfo): Promise<boolean>;
  • Before change:
     /**
     * Register the listener that watches for current application auto startup state.
     *
     * @param { 'abilityAutoStartup' } type - Indicates the type of event.
     * @param { AutoStartupCallback } callback - Auto startup callback.
     * @throws { BusinessError } 401 - The parameter check failed.
     * @syscap SystemCapability.Ability.AbilityRuntime.Core
     * @StageModelOnly
     * @since 11
     */
    on(type: 'abilityAutoStartup', callback: AutoStartupCallback): void;
  
    /**
     * Unregister listener that watches for current application auto startup state.
     *
     * @param { 'abilityAutoStartup' } type - Indicates the type of event.
     * @param { AutoStartupCallback } [callback] - Auto startup callback.
     * @throws { BusinessError } 401 - The parameter check failed.
     * @syscap SystemCapability.Ability.AbilityRuntime.Core
     * @StageModelOnly
     * @since 11
     */
    off(type: 'abilityAutoStartup', callback?: AutoStartupCallback): void;
  
    /**
     * Set current application auto startup state.
     *
     * @param { AutoStartupInfo } info - The application info.
     * @param { AsyncCallback<void> } callback - The callback of setAutoStartup.
     * @throws { BusinessError } 401 - The parameter check failed.
     * @syscap SystemCapability.Ability.AbilityRuntime.Core
     * @StageModelOnly
     * @since 11
     */
    setAutoStartup(info: AutoStartupInfo, callback: AsyncCallback<void>): void;
  
    /**
     * Set current application auto startup state.
     *
     * @param { AutoStartupInfo } info - The application info.
     * @returns { Promise<void> } The promise returned by the function.
     * @throws { BusinessError } 401 - The parameter check failed.
     * @syscap SystemCapability.Ability.AbilityRuntime.Core
     * @StageModelOnly
     * @since 11
     */
    setAutoStartup(info: AutoStartupInfo): Promise<void>;
  
    /**
     * Cancel current application auto startup state.
     *
     * @param { AutoStartupInfo } info - The application info.
     * @param { AsyncCallback<void> } callback - The callback of cancelAutoStartup.
     * @throws { BusinessError } 401 - The parameter check failed.
     * @syscap SystemCapability.Ability.AbilityRuntime.Core
     * @StageModelOnly
     * @since 11
     */
    cancelAutoStartup(info: AutoStartupInfo, callback: AsyncCallback<void>): void;
  
    /**
     * Cancel current application auto startup state.
     *
     * @param { AutoStartupInfo } info - The application info.
     * @returns { Promise<void> } The promise returned by the function.
     * @throws { BusinessError } 401 - The parameter check failed.
     * @syscap SystemCapability.Ability.AbilityRuntime.Core
     * @StageModelOnly
     * @since 11
     */
    cancelAutoStartup(info: AutoStartupInfo): Promise<void>;
  
    /**
     * Check if the current application is auto startup state.
     *
     * @param { AutoStartupInfo } info - The application info.
     * @param { AsyncCallback<boolean> } callback - The callback of isAutoStartup.
     * @throws { BusinessError } 401 - The parameter check failed.
     * @syscap SystemCapability.Ability.AbilityRuntime.Core
     * @StageModelOnly
     * @since 11
     */
    isAutoStartup(info: AutoStartupInfo, callback: AsyncCallback<boolean>): void;
  
    /**
     * Check if the current application is auto startup state.
     *
     * @param { AutoStartupInfo } info - The application info.
     * @returns { Promise<boolean> } The promise returned by the function.
     * @throws { BusinessError } 401 - The parameter check failed.
     * @syscap SystemCapability.Ability.AbilityRuntime.Core
     * @StageModelOnly
     * @since 11
     */
    isAutoStartup(info: AutoStartupInfo): Promise<boolean>;

Adaptation Guide

Delete the involved APIs from your code.

cl.ability.2 Permission for Using AutoStartupInfo Is Changed

Access Level

Public API

Reason for Change

After the APIs related to auto startup in ApplicationContext are deleted, AutoStartupInfo is not available for third-party applications and is changed to a system API.

Change Impact

This change is a non-compatible change. If your code uses the involved APIs, delete them.

API Level

11

Change Since

OpenHarmony SDK 4.1.6.5

Key API/Component Changes

  AutoStartupInfo {
    bundleName: string;
    moduleName?: string;
    abilityName: string;
    abilityTypeName?: string;
  }
  • Before change:
    /**
     * Bundle name
     *
     * @type { string }
     * @syscap SystemCapability.Ability.AbilityRuntime.Core
     * @StageModelOnly
     * @since 11
     */
    bundleName: string;
  
    /**
     * Module name
     *
     * @type { ?string }
     * @syscap SystemCapability.Ability.AbilityRuntime.Core
     * @StageModelOnly
     * @since 11
     */
    moduleName?: string;
  
    /**
     * Ability Name
     *
     * @type { string }
     * @syscap SystemCapability.Ability.AbilityRuntime.Core
     * @StageModelOnly
     * @since 11
     */
    abilityName: string;
  
    /**
     * Ability Type Name
     *
     * @type { ?string }
     * @syscap SystemCapability.Ability.AbilityRuntime.Core
     * @StageModelOnly
     * @since 11
     */
    abilityTypeName?: string;
  • After change:
    /**
     * Bundle name
     *
     * @type { string }
     * @syscap SystemCapability.Ability.AbilityRuntime.Core
     * @systemapi
     * @StageModelOnly
     * @since 11
     */
    bundleName: string;
  
    /**
     * Module name
     *
     * @type { ?string }
     * @syscap SystemCapability.Ability.AbilityRuntime.Core
     * @systemapi
     * @StageModelOnly
     * @since 11
     */
    moduleName?: string;
  
    /**
     * Ability Name
     *
     * @type { string }
     * @syscap SystemCapability.Ability.AbilityRuntime.Core
     * @systemapi
     * @StageModelOnly
     * @since 11
     */
    abilityName: string;
  
    /**
     * Ability Type Name
     *
     * @type { ?string }
     * @syscap SystemCapability.Ability.AbilityRuntime.Core
     * @systemapi
     * @StageModelOnly
     * @since 11
     */
    abilityTypeName?: string;

Adaptation Guide

Make sure the APIs are only invoked by system applications.

The code snippet is as follows:

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

try {
  AutoStartupManager.setApplicationAutoStartup({
    bundleName: 'com.example.autostartupapp',
    abilityName: 'EntryAbility'
  }).then((data: void) => {
    console.info('====> setApplicationAutoStartup data: ' + JSON.stringify(data));
  }).catch((err: BusinessError) => {
    console.info('====> setApplicationAutoStartup err: ' + JSON.stringify(err));
  });
} catch (err) {
  console.info('====> setApplicationAutoStartup throw err: ' + JSON.stringify(err));
}

cl.ability.3 Permission for Using AutoStartupCallback Is Changed

Access Level

Public API

Reason for Change

After the APIs related to auto startup in ApplicationContext are deleted, AutoStartupCallback is not available for third-party applications and is changed to a system API.

Change Impact

This change is a non-compatible change. If your code uses the involved APIs, delete them.

API Level

11

Change Since

OpenHarmony SDK 4.1.6.5

Key API/Component Changes

  • Involved API:
    onAutoStartupOn(info: AutoStartupInfo): void;
    onAutoStartupOff(info: AutoStartupInfo): void;
  • Before change:
    /**
     * When the application's auto startup state is set to on, this function is called.
     *
     * @param { AutoStartupInfo } info - Auto startup info.
     * @syscap SystemCapability.Ability.AbilityRuntime.Core
     * @StageModelOnly
     * @since 11
     */
    onAutoStartupOn(info: AutoStartupInfo): void;
  
    /**
     * When the application's auto startup state is set to off, this function is called.
     *
     * @param { AutoStartupInfo } info - Auto startup info.
     * @syscap SystemCapability.Ability.AbilityRuntime.Core
     * @StageModelOnly
     * @since 11
     */
    onAutoStartupOff(info: AutoStartupInfo): void;
  • After change:
    /**
     * When the application's auto startup state is set to on, this function is called.
     *
     * @param { AutoStartupInfo } info - Auto startup info.
     * @syscap SystemCapability.Ability.AbilityRuntime.Core
     * @systemapi
     * @StageModelOnly
     * @since 11
     */
    onAutoStartupOn(info: AutoStartupInfo): void;
  
    /**
     * When the application's auto startup state is set to off, this function is called.
     *
     * @param { AutoStartupInfo } info - Auto startup info.
     * @syscap SystemCapability.Ability.AbilityRuntime.Core
     * @systemapi
     * @StageModelOnly
     * @since 11
     */
    onAutoStartupOff(info: AutoStartupInfo): void;

Adaptation Guide

Make sure the APIs are only invoked by system applications.

The code snippet is as follows:

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

try {
  AutoStartupManager.on('systemAutoStartup', {
    onAutoStartupOn(data: common.AutoStartupInfo) {
      console.info('===> autostartupmanager onAutoStartupOn data: ' + JSON.stringify(data));
    },
    onAutoStartupOff(data: common.AutoStartupInfo) {
      console.info('===> autostartupmanager onAutoStartupOff data: ' + JSON.stringify(data));
    }
  });
} catch (err) {
  console.info('===> autostartupmanager on throw err: ' + JSON.stringify(err));
}

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkCompiler Subsystem Changelog

harmony 鸿蒙ArkUI Subsystem Changelog

harmony 鸿蒙ArkWeb Subsystem Changelog

harmony 鸿蒙Distributed Data Management Subsystem Changelog

harmony 鸿蒙Multimedia Subsystem Changelog

harmony 鸿蒙Window Subsystem Changelog

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