鸿蒙的启动模式分为2种
- 页面路由router配置
- module.json5的abilitys的lanuchType
页面路由router配置
路由跳转分为pushUrl和replaceUrl
- pushUrl 跳转页面
- replaceUrl。跳转页面且替换当前页面
//由于page_view_single在跳转的时候Single模式，所以还会显示之前的页面
Button("点击进入Single模式").margin({top:20}).width('80%').height(50).stateStyles({
pressed:{.backgroundColor(Color.Orange)}
}).fontSize(20).onClick(()=>{
router.pushUrl({
url: Contact.SINGLE_MODE_PAGE,
},router.RouterMode.Single
).catch((error: Error) => {
console.info('TAG', 'IndexPage push error' + JSON.stringify(error));
});
})
//由于使用了replaceUrl在跳转的时候不会创建新的实例而是替换当前页在栈中
Button("点击进入替换当前页面").margin({top:20}).width('80%').height(50).fontSize(20).onClick(()=>{
this.message="Standard模式被点击过"
router.replaceUrl({
url: Contact.REPLACE_PAGE,
},router.RouterMode.Single
).catch((error: Error) => {
console.info('TAG', 'IndexPage push error' + JSON.stringify(error));
});
})
通过路由跳转的时候配置 RouterMode
Button("点击进入SINGLE模式页面")
.margin({ top: 20 })
.width('80%')
.height(50)
.fontSize(20)
.onClick(() => {
router.pushUrl({
url: Contact.SINGLE_MODE_PAGE,
}, router.RouterMode.Single
).catch((error: Error) => {
console.info('TAG', 'IndexPage push error' + JSON.stringify(error));
});
})
RouterMode有2种模式 (默认standard)
- Single模式 (如果栈里有不会创建新实例，重复打开之前的并推到栈顶)
Standard模式(每次跳转都是开启一个新的实例(页面))
WX20240210-104527@2x.png
当我点击按钮 改变文字“single模式”变为“single模式被点击过”
WX20240210-133012@2x.png
WX20240210-140748@2x.png
WX20240210-141030@2x.png
WX20240210-140748@2x.png
WX20240210-133035@2x.png
可以理解为 Standard启动一个就是一个，Single模式如果打开过这个模式的页面再点击进去该页面还是之前的
Ability跳转启动模式
如果你是有多个Ability
WX20240210-145026@2x.png
在module.json5文件下
配置 "launchType"有4中模式 默认singletion
-singleton 当前栈里有这个模式的ability不会创建新的而是再次调起之前的，并推到栈顶
-multiton 文档上说是多实例(我测了下还是singleton模式)
-standard 每次点击都会创建新的实例对象
-specified 当栈中已有相同key的ability不会创建新的实例 否则创建新的
WX20240210-145405@2x.png
"abilities": [
{
"name": "EntryAbility",
"srcEntry": "./ets/entryability/EntryAbility.ts",
"description": "$string:EntryAbility_desc",
"icon": "$media:icon",
"label": "$string:EntryAbility_label",
"startWindowIcon": "$media:icon",
"startWindowBackground": "$color:start_window_background",
"removeMissionAfterTerminate": true,
"exported": true,
"skills": [
{
"entities": [
"entity.system.home"
],
"actions": [
"action.system.home"
]
}
]
},
{
"name": "SingletonAbility",
"srcEntry": "./ets/singletonability/SingletonAbility.ts",
"description": "$string:SingleAbility1_desc",
"icon": "$media:icon",
"label": "$string:SingleAbility1_label",
"removeMissionAfterTerminate": true,
"launchType": "singleton",
"startWindowIcon": "$media:icon",
"startWindowBackground": "$color:start_window_background",
"skills": [
{
"entities": [
"entity.system.home"
],
"actions": [
"action.system.home"
]
}
]
},
{
"name": "StandardAbility",
"srcEntry": "./ets/standardability1/StandardAbility.ts",
"description": "$string:StandardAbility1_desc",
"icon": "$media:icon",
"label": "$string:StandardAbility1_label",
"removeMissionAfterTerminate": true,
"launchType": "standard",
"startWindowIcon": "$media:icon",
"startWindowBackground": "$color:start_window_background",
"skills": [
{
"entities": [
"entity.system.home"
],
"actions": [
"action.system.home"
]
}
]
},
{
"name": "SpecifiedAbility",
"srcEntry": "./ets/specifiedability/SpecifiedAbility.ts",
"description": "$string:SpecifiedAbility_desc",
"icon": "$media:icon",
"label": "$string:SpecifiedAbility_label",
"startWindowIcon": "$media:icon",
"startWindowBackground": "$color:start_window_background",
"launchType": "specified",
"skills": [
{
"entities": [
"entity.system.home"
],
"actions": [
"action.system.home"
]
}
]
},
{
"name": "MultitonAbility",
"srcEntry": "./ets/multitonability/MultitonAbility.ts",
"description": "$string:MultitonAbility_desc",
"icon": "$media:icon",
"launchType": "multiton",//不起作用 还是singleton模式
"label": "$string:MultitonAbility_label",
"startWindowIcon": "$media:icon",
"startWindowBackground": "$color:start_window_background"
}
]
启动一个ability代码
在你的page页面结构体里添加如下，在触发地方调用
@Entry
@Component
struct Index {
private context = getContext(this) as common.UIAbilityContext
//Standard 每次都会创建新的实例
startStandardAbility() {
console.info(TAG, `StandardAbility`);
let want = {
deviceId: '', // deviceId为空表示本设备
bundleName: 'com.demo.myapplication',
abilityName: 'StandardAbility',
}
try {
this.context.startAbility(want)
.then(() => {
console.info(TAG, `startAbility Success`);
})
.catch((err) => {
console.info(TAG, `Failed： ${JSON.stringify(err)}}`);
})
} catch (error) {
console.log("startAbility error: " + error)
}
}
启动一个specified模式的ability代码与之前不同 需要配置parameters
里面的参数可自行定义
//Specified 创建实例后如果有相同的key不会创建新实例
startSpecifiedAbility() {
console.info(TAG, `SpecifiedAbility`);
let want: Want = {
deviceId: '', // deviceId为空表示本设备
bundleName: 'com.demo.myapplication',
abilityName: 'SpecifiedAbility',
parameters: {
key: "value", // 自定义信息 key和value自定义即可
},
}
try {
this.context.startAbility(want)
.then(() => {
console.info(TAG, `startAbility Success`);
})
.catch((err) => {
console.info(TAG, `Failed： ${JSON.stringify(err)}}`);
})
} catch (error) {
console.log("startAbility error: " + error)
}
}
如果是Specified需要定义AbilityStage 如果是相同key他会走onacceptWant，只限Specified模式
export default class MyAbilityStag extends AbilityStage {
onAcceptWant(want:Want): string {
// 在被调用方的AbilityStage中，针对启动模式为specified的UIAbility返回一个UIAbility实例对应的一个Key值
if (want.abilityName === 'SpecifiedAbility') {
// 返回的字符串Key标识为自定义拼接的字符串内容
if (want.parameters["key"]=="value") {
return `SpecifiedAbilityInstance_${want.parameters.key}`;
}
}
return 'MyAbilityStag';
}
}
且需要在module.json5下配置srcEntry
WX20240210-150915@2x.png
如果需要在桌面显示ability的图标和label需要在ability下配置skill
WX20240210-151110@2x.png
WX20240210-151213@2x.png
WX20240210-151342@2x.png
WX20240210-151423@2x.png
WX20240210-151512@2x.png
WX20240210-151543@2x.png
WX20240210-151700@2x.png
