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

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

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

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

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

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

---

@ohos.app.ability.StartOptions (StartOptions)

StartOptions可以作为startAbility()的入参，用于指定目标Ability的窗口模式。

说明

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

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

导入模块

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

属性

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

名称	类型	只读	可选	说明
windowMode12+	number	否	是	启动Ability时的窗口模式。
displayId	number	否	是	屏幕ID模式。默认是0，表示当前屏幕。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
withAnimation11+	boolean	否	是	Ability是否具有动画效果。
windowLeft11+	number	否	是	窗口左边的位置。
windowTop11+	number	否	是	窗口顶部的位置。
windowWidth11+	number	否	是	窗口的宽度。
windowHeight11+	number	否	是	窗口的高度。
processMode12+	contextConstant.ProcessMode	否	是	进程模式。 约束： 1.仅在平板类设备上生效。 2.仅在UIAbilityContext.startAbility中生效。 3.processMode和startupVisibility必须同时设置。
startupVisibility12+	contextConstant.StartupVisibility	是	否	Ability启动后的可见性。 约束： 1.仅在平板类设备上生效。 2.仅在UIAbilityContext.startAbility中生效。 3.processMode和startupVisibility必须同时设置。

示例：

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

export default class EntryAbility extends UIAbility {

  onForeground() {
    let want: Want = {
      deviceId: '',
      bundleName: 'com.example.myapplication',
      abilityName: 'EntryAbility'
    };
    let options: StartOptions = {
      displayId: 0
    };

    try {
      this.context.startAbility(want, options, (err: BusinessError) => {
        if (err.code) {
          // 处理业务逻辑错误
          console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
          return;
        }
        // 执行正常业务
        console.info('startAbility succeed');
      });
    } catch (err) {
      // 处理入参错误异常
      let code = (err as BusinessError).code;
      let message = (err as BusinessError).message;
      console.error(`startAbility failed, code is ${code}, message is ${message}`);
    }
  }
}