鸿蒙5.0开发进阶：Stage模型-@ohos.app.ability.AbilityConstant (AbilityConstant)

往期鸿蒙全套实战文章必看：（文中附带全栈鸿蒙学习资料）

• 鸿蒙开发核心知识点，看这篇文章就够了

• 最新版！鸿蒙HarmonyOS Next应用开发实战学习路线

• 鸿蒙HarmonyOS NEXT开发技术最全学习路线指南

• 鸿蒙应用开发实战项目，看这一篇文章就够了（部分项目附源码）

---

@ohos.app.ability.AbilityConstant (AbilityConstant)

AbilityConstant提供UIAbility相关的枚举，包括设置初次启动原因、上次退出原因、迁移结果、窗口类型等。

说明

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

• 本模块接口仅可在Stage模型下使用。

导入模块

import { AbilityConstant } from '@kit.AbilityKit';

LaunchParam

启动参数。Ability启动时由系统自动传入，开发者无需修改。

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

名称	类型	只读	可选	说明
launchReason	LaunchReason	否	否	枚举类型，表示启动原因。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
lastExitReason	LastExitReason	否	否	枚举类型，表示最后退出原因。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
lastExitMessage12+	string	否	否	表示最后退出详细原因。 元服务API： 从API version 12开始，该接口支持在元服务中使用。

LaunchReason

Ability初次启动原因，该类型为枚举，可配合UIAbility的onCreate(want, launchParam)方法根据launchParam.launchReason的不同类型执行相应操作。

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

名称	值	说明
UNKNOWN	0	未知原因。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
START_ABILITY	1	通过startAbility接口启动ability。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
CALL	2	通过startAbilityByCall接口启动ability。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
CONTINUATION	3	跨端设备迁移启动ability。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
APP_RECOVERY	4	设置应用恢复后，应用故障时自动恢复启动ability。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
SHARE10+	5	通过元服务分享启动ability。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
AUTO_STARTUP11+	8	通过设置开机自启动来启动Ability。
INSIGHT_INTENT11+	9	通过洞察意图来启动Ability。 元服务API： 从API version 11开始，该接口支持在元服务中使用。

示例：

import { UIAbility, Want, AbilityConstant } from '@kit.AbilityKit';

class MyAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
    if (launchParam.launchReason === AbilityConstant.LaunchReason.START_ABILITY) {
      console.log('The ability has been started by the way of startAbility.');
    }
  }
}

LastExitReason

Ability上次退出原因，该类型为枚举，可配合UIAbility的onCreate(want, launchParam)方法根据launchParam.lastExitReason的不同类型执行相应操作。

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

名称	值	说明
UNKNOWN	0	未知原因。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
ABILITY_NOT_RESPONDING(deprecated)	1	ability未响应。 说明: 从API version 9开始支持，从API version 10开始废弃，请使用APP_FREEZE替代。
NORMAL	2	用户主动关闭，应用程序正常退出。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
CPP_CRASH10+	3	本机异常信号，导致应用程序退出。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
JS_ERROR10+	4	当应用存在JS语法错误并未被开发者捕获时，触发JS_ERROR故障，导致应用程序退出。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
APP_FREEZE10+	5	由于watchdog检测出应用Freeze故障，导致应用程序退出。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
PERFORMANCE_CONTROL10+	6	由于系统性能问题（如设备内存不足），导致应用程序退出。 元服务API： 从API version 11开始，该接口支持在元服务中使用。 说明：该接口即将废弃，建议使用RESOURCE_CONTROL替代。
RESOURCE_CONTROL10+	7	系统资源使用不当，导致应用程序退出。具体错误原因可以通过LaunchParam.lastExitMessage获取，可能原因如下: - CPU Highload，CPU高负载。 - CPU_EXT Highload，快速CPU负载检测。 - IO Manage Control，I/O管控。 - App Memory Deterioration，应用内存超限劣化。 - Temperature Control，温度管控。 - Memory Pressure，整机低内存触发按优先级由低到高查杀。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
UPGRADE10+	8	应用程序因升级而退出。 元服务API： 从API version 11开始，该接口支持在元服务中使用。

示例：

import { UIAbility, Want, AbilityConstant } from '@kit.AbilityKit';

class MyAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
    if (launchParam.lastExitReason === AbilityConstant.LastExitReason.APP_FREEZE) {
      console.log('The ability has exit last because the ability was not responding.');
    }
    if (launchParam.lastExitReason === AbilityConstant.LastExitReason.RESOURCE_CONTROL) {
      console.log('The ability has exit last because the rss control，the lastExitReason is '+  launchParam.lastExitReason + ', the lastExitMessage is ' + launchParam.lastExitMessage);
    }
  }
}

OnContinueResult

Ability迁移结果，该类型为枚举，可配合UIAbility的onContinue(wantParam)方法进完成相应的返回。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

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

名称	值	说明
AGREE	0	表示同意。
REJECT	1	表示拒绝：如应用在onContinue中异常会导致迁移以后数据恢复时显示异常，则可以建议REJECT。
MISMATCH	2	表示版本不匹配：迁移发起端应用可以在onContinue中获取到迁移目标端应用的版本号，进行协商后，如果版本不匹配导致无法迁移，可以返回该错误。

示例：

import { UIAbility, AbilityConstant } from '@kit.AbilityKit';

class MyAbility extends UIAbility {
  onContinue(wantParam: Record<string, Object>) {
    return AbilityConstant.OnContinueResult.AGREE;
  }
}

MemoryLevel

内存级别，该类型为枚举，可配合UIAbility的onMemoryLevel(level)方法根据level执行不同内存级别的相应操作。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core

名称	值	说明
MEMORY_LEVEL_MODERATE	0	内存占用适中。
MEMORY_LEVEL_LOW	1	内存占用低。
MEMORY_LEVEL_CRITICAL	2	内存占用高。

示例：

import { UIAbility, AbilityConstant } from '@kit.AbilityKit';

class MyAbility extends UIAbility {
  onMemoryLevel(level: AbilityConstant.MemoryLevel) {
    if (level === AbilityConstant.MemoryLevel.MEMORY_LEVEL_CRITICAL) {
      console.log('The memory of device is critical, please release some memory.');
    }
  }
}

WindowMode12+

启动Ability时的窗口模式，类型为枚举。可配合startAbility使用，指定启动Ability的窗口模式。

系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core

名称	值	说明
WINDOW_MODE_FULLSCREEN	1	全屏模式。仅在2in1和tablet设备上生效。
WINDOW_MODE_SPLIT_PRIMARY	100	支持应用内拉起Ability时设置为分屏，左侧分屏。
WINDOW_MODE_SPLIT_SECONDARY	101	支持应用内拉起Ability时设置为分屏，右侧分屏。

示例：

import { UIAbility, StartOptions, Want, AbilityConstant } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

let want: Want = {
  bundleName: 'com.example.myapplication',
  abilityName: 'EntryAbility'
};
let option: StartOptions = {
  windowMode: AbilityConstant.WindowMode.WINDOW_MODE_SPLIT_PRIMARY
};

// 确保从上下文获取到context
class MyAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
    this.context.startAbility(want, option).then(() => {
      console.log('Succeed to start ability.');
    }).catch((error: BusinessError) => {
      console.error(`Failed to start ability with error: ${JSON.stringify(error)}`);
    });
  }
}

OnSaveResult

保存应用数据的结果，该类型为枚举，可配合UIAbility的onSaveState(reason, wantParam)方法完成相应的返回。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core

名称	值	说明
ALL_AGREE	0	总是同意保存状态。
CONTINUATION_REJECT	1	拒绝迁移保存状态。
CONTINUATION_MISMATCH	2	迁移不匹配。
RECOVERY_AGREE	3	同意恢复保存状态。
RECOVERY_REJECT	4	拒绝恢复保存状态。
ALL_REJECT	5	总是拒绝保存状态。

示例：

import { UIAbility, AbilityConstant } from '@kit.AbilityKit';

class MyAbility extends UIAbility {
  onSaveState(reason: AbilityConstant.StateType, wantParam: Record<string, Object>) {
    return AbilityConstant.OnSaveResult.ALL_AGREE;
  }
}

StateType

保存应用数据场景原因，该类型为枚举，可配合UIAbility的onSaveState(reason, wantParam)方法根据reason的不同类型执行相应操作。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core

名称	值	说明
CONTINUATION	0	迁移保存状态。
APP_RECOVERY	1	应用恢复保存状态。

示例：

import { UIAbility, AbilityConstant } from '@kit.AbilityKit';

class MyAbility extends UIAbility {
  onSaveState(reason: AbilityConstant.StateType, wantParam: Record<string, Object>) {
    if (reason === AbilityConstant.StateType.CONTINUATION) {
      console.log('Save the ability data when the ability continuation.');
    }
    return AbilityConstant.OnSaveResult.ALL_AGREE;
  }
}

ContinueState10+

流转状态枚举值。用于表示当前应用任务流转的状态。可配合UIAbilityContext的setMissionContinueState方法进行设置。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

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

名称	值	说明
ACTIVE	0	指示当前应用任务流转处于激活状态。
INACTIVE	1	指示当前应用任务流转处于未激活状态。

示例：

import { UIAbility, Want, AbilityConstant } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

class MyAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
    this.context.setMissionContinueState(AbilityConstant.ContinueState.INACTIVE, (result: BusinessError) => {
      console.info(`setMissionContinueState: ${JSON.stringify(result)}`);
    });
  }
}