本文將介紹如何在 OpenHarmony 中使用靜態(tài)訂閱公共事件。

靜態(tài)訂閱者在未接收訂閱的目標(biāo)事件時(shí)，處于未拉起狀態(tài)，當(dāng)系統(tǒng)或應(yīng)用發(fā)布了指定的公共事件后，靜態(tài)訂閱者將被拉起，并執(zhí)行 onReceiveEvent 回調(diào)。

開(kāi)發(fā)者可通過(guò)在 onReceiveEvent 回調(diào)中執(zhí)行業(yè)務(wù)邏輯，實(shí)現(xiàn)當(dāng)應(yīng)用接收到特定公共事件時(shí)執(zhí)行業(yè)務(wù)邏輯的目的。

例如，某應(yīng)用希望在設(shè)備開(kāi)機(jī)的時(shí)候執(zhí)行一些初始化任務(wù)，那么該應(yīng)用可以靜態(tài)訂閱開(kāi)機(jī)事件，在收到開(kāi)機(jī)事件后會(huì)拉起該應(yīng)用，然后執(zhí)行初始化任務(wù)。

設(shè)備與環(huán)境：

• 設(shè)備：九聯(lián) s905l3a 機(jī)頂盒

• 系統(tǒng)：OpenHarmony 3.2 beta2

• SDK：API 9（Full SDK）

實(shí)現(xiàn)過(guò)程

①聲明靜態(tài)訂閱者

打開(kāi) DevEco Studio 創(chuàng)建一個(gè)新的 Stage 工程，在工程中新建一個(gè)目錄 StaticSubscriber。

importStaticSubscriberExtensionAbilityfrom'@ohos.application.StaticSubscriberExtensionAbility'
importLoggerfrom'../model/Logger'

exportdefaultclassStaticSubscriberextendsStaticSubscriberExtensionAbility{
num:number=0
onReceiveEvent(event){
Logger.info(`rgytl ----監(jiān)聽(tīng)到公共的事件為：${event.event}`)
setInterval(()=>{
this.num=this.num+1
Logger.info("rgytl----num="+this.num)
},1000)
}
}

②靜態(tài)訂閱者工程配置

在完成靜態(tài)訂閱者的代碼實(shí)現(xiàn)后，需要將該訂閱者配置到系統(tǒng)的 module.json5 中，配置形式如下：

{
"module":{
......
"extensionAbilities":[
{
"name":"StaticSubscriber",
"srcEntrance":"./ets/StaticSubscriber/StaticSubscriber.ts",
"description":"$string:StaticSubscriber_desc",
"icon":"$media:icon",
"label":"$string:StaticSubscriber_label",
"type":"staticSubscriber",
"visible":true,
"metadata":[
{
"name":"ohos.extension.staticSubscriber",
"resource":"$profile:subscribe"
}
]
}
],
......
}
}

metadata 指向的二級(jí)配置文件的通常形式如下：

{
"commonEvents":[
{
"name":"xxx",
"permission":"xxx",
"events":[
"xxx"
]
}
]
}

在這里我監(jiān)聽(tīng)的是開(kāi)機(jī)事件和系統(tǒng)事件流逝時(shí)間：

{
"commonEvents":[
{
"name":"StaticSubscriber",
"permission":"",
"events":[
"usual.event.TIME_TICK",
"usual.event.BOOT_COMPLETED"
]
}
]
}

③應(yīng)用安裝

首先，修改 OpenHarmony SDK toolchains lib 目錄下面的 UnsgnedReleasedProfileTemplate.json 文件的 apl 字段，將 apl 字段改成 system_basic 或 system_core。

"bundle-info":{
"developer-id":"OpenHarmony",
"distribution-certificate":"xxxxxxx",
"app-feature":"hos_system_app",
"bundle-name":"com.example.xxxx",
"apl":"system_core"
},

然后修改 static_subscriber_config.json 文件，在該文件中加入我們這個(gè)應(yīng)用的包名：

{
"xxx",
"ohos.extension.staticSubscriber",
"xxx"
}

最后把修改好的配置文件重新加入到設(shè)備系統(tǒng)中：

hdcshell"mount-oremount,rw/"
hdcfilesendD:static_subscriber_config.json/etc/static_subscriber_config.json

然后重新啟動(dòng)，應(yīng)用監(jiān)聽(tīng)到開(kāi)機(jī)事件，此時(shí)就可以在日志中看到打印：