使用specified启动模式定制入口

specified启动模式为指定实例模式,有一些特殊场景,例如文档应用中每次新建文档希望都能新建一个文档实例,而重复打开的一个已保存的文档都是同一文档实例。

HarmonyOS
2024-05-26 17:19:03
3262浏览
收藏 1
回答 1
回答 1
按赞同
/
按时间
lovingkane

使用的核心API

specified启动模式

UIAbility.onNewWant

启动uiability的指定页面

核心代码

1、新建的SpecifiedAbility,将module.json5配置文件的launchType字段配置为specified。

2、在启动UIAbility之前,为该UIAbility实例指定一个唯一的字符串instanceKey,这样在调用startAbility()方法时,应用就可以根据指定的instanceKey来识别响应请求的UIAbility实例。在EntryAbility中,调用startAbility()方法时,可以在want参数中增加一个自定义参数,例如instanceKey,以此来区分不同的UIAbility实例。

import common from '@ohos.app.ability.common' 
import Want from '@ohos.app.ability.Want'; 
import { BusinessError } from '@ohos.base'; 
  
@Entry 
@Component 
struct Index { 
   
  getInstance(instance: String){ 
    return 'testKey' + instance; 
  } 
  
  redirectAbility(key: String){ 
    let context = getContext(this) as common.UIAbilityContext 
  
    let want: Want = { 
      deviceId: '', 
      bundleName: 'com.example.customizedpagedemo', 
      abilityName: 'SpecifiedAbility', 
      parameters: { 
        target: 'pages/specifiedAbility/SpecifiedDetail', 
        instanceKey: key, 
      }, 
    } 
  
    context.startAbility(want).then(() => { 
      console.info('startAbility succeeded') 
    }).catch((err: BusinessError) => { 
      console.error(`Failed to start ability. Code is ${err.code}, message is ${err.message}`); 
    }) 
  } 
  
  build() { 
    Row() { 
      Column() { 
        Text('EntryAbility') 
          .fontSize(50) 
          .fontWeight(FontWeight.Bold) 
        Button('新建一个文档') 
          .backgroundColor(Color.Green) 
          .width(180) 
          .margin({top: 20}) 
          .onClick(() => { 
            this.redirectAbility(this.getInstance('new')); 
          }) 
        Button('打开已保存的文档') 
          .backgroundColor(Color.Green) 
          .width(180) 
          .margin({top: 20}) 
          .onClick(() => { 
            this.redirectAbility(this.getInstance('old')); 
          }) 
      } 
      .width('100%') 
    } 
    .height('100%') 
  } 
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 35.
  • 36.
  • 37.
  • 38.
  • 39.
  • 40.
  • 41.
  • 42.
  • 43.
  • 44.
  • 45.
  • 46.
  • 47.
  • 48.
  • 49.
  • 50.
  • 51.
  • 52.
  • 53.
  • 54.
  • 55.
  • 56.
  • 57.
  • 58.

3、调用startAbilit启动SpecifiedAbility之前,会先进入对应的MyAbilityStage的onAcceptWant()生命周期回调中,以获取该UIAbility实例的Key值。然后系统会自动匹配,如果存在与该UIAbility实例匹配的Key,则会启动与之绑定的UIAbility实例;否则会创建一个新的UIAbility实例。

import AbilityStage from '@ohos.app.ability.AbilityStage'; 
import Want from '@ohos.app.ability.Want'; 
import hilog from '@ohos.hilog'; 
  
export default class MyAbilityStage extends AbilityStage{ 
  
  onAcceptWant(want: Want): string { 
    hilog.info(0x0000, 'testTag', '%{public}s', 'MyAbilityStage onAcceptWant', JSON.stringify(want) ?? ''); 
    if(want && want.abilityName === 'SpecifiedAbility'){ 
      if(want.parameters.instanceKey){ 
        return `SpecifiedAbilityInstance${want.parameters.instanceKey}`; 
      } 
    } 
    return ''; 
  } 
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.

适配版本信息

IDE:DevEco Studio 4.1.1.300

SDK:HarmoneyOS 4.1.2.1

分享
微博
QQ
微信
回复
2024-05-27 21:56:25


相关问题
HarmonyOS 修改工程启动入口报错
1236浏览 • 1回复 待解决
UIAbility组件的启动模式
1392浏览 • 1回复 待解决
如何NavPathStack也支持页面的启动模式
1115浏览 • 1回复 待解决
HarmonyOS AVCastPicker组件定制问题
658浏览 • 1回复 待解决
如何定制构建多目标产物?
1750浏览 • 2回复 待解决
HarmonyOS 桌面快捷入口支持
776浏览 • 1回复 待解决
#鸿蒙通关秘籍#怎样定制编译HAP?
925浏览 • 1回复 待解决
HarmonyOS 如何更改主入口页面
686浏览 • 1回复 待解决
HarmonyOS 如何创建桌面快捷入口
1201浏览 • 1回复 待解决
HarmonyOS HMRouter使用 Dialog模式
786浏览 • 0回复 待解决
HarmonyOS web使用隐私模式
1287浏览 • 1回复 待解决
关于定制不同的product
1027浏览 • 1回复 待解决