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

靜態訂閱者在未接收訂閱的目標事件時，處于未拉起狀態，當系統或應用發布了指定的公共事件后，靜態訂閱者將被拉起，并執行 onReceiveEvent 回調。

開發者可通過在 onReceiveEvent 回調中執行業務邏輯，實現當應用接收到特定公共事件時執行業務邏輯的目的。

例如，某應用希望在設備開機的時候執行一些初始化任務，那么該應用可以靜態訂閱開機事件，在收到開機事件后會拉起該應用，然后執行初始化任務。

設備與環境：

• 設備：九聯 s905l3a 機頂盒

• 系統：OpenHarmony 3.2 beta2

• SDK：API 9（Full SDK）

實現過程

①聲明靜態訂閱者

打開 DevEco Studio 創建一個新的 Stage 工程，在工程中新建一個目錄 StaticSubscriber。

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

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

②靜態訂閱者工程配置

在完成靜態訂閱者的代碼實現后，需要將該訂閱者配置到系統的 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 指向的二級配置文件的通常形式如下：

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

在這里我監聽的是開機事件和系統事件流逝時間：

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

③應用安裝

首先，修改 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 文件，在該文件中加入我們這個應用的包名：

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

最后把修改好的配置文件重新加入到設備系統中：

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

然后重新啟動，應用監聽到開機事件，此時就可以在日志中看到打印：