2023年8月4日，華為在“2023華為開(kāi)發(fā)者大會(huì)”上發(fā)布了HarmonyOS NEXT。HarmonyOS NEXT是華為公司自研操作系統(tǒng)，鴻蒙系統(tǒng)將拋棄Linux內(nèi)核及安卓開(kāi)源AOSP源碼，僅支持鴻蒙自研內(nèi)核和鴻蒙平臺(tái)的應(yīng)用，不再兼容安卓應(yīng)用。為全面支持國(guó)產(chǎn)自研鴻蒙平臺(tái)，極光消息推送服務(wù)快速的也接入了鴻蒙生態(tài)，并在鴻蒙平臺(tái)重新實(shí)現(xiàn)極光消息推送服務(wù)。
極光消息推送服務(wù)，主要由極光SDK、極光消息后臺(tái)服務(wù)、極光portal頁(yè)面幾個(gè)模塊組成。
在接入鴻蒙平臺(tái)的過(guò)程中，極光消息推送服務(wù)主要做了以下幾塊適配工作：
1. 基于鴻蒙next開(kāi)發(fā)語(yǔ)言ArkTS開(kāi)發(fā)全新的應(yīng)用SDK
2. 基于消息推送服務(wù)端API新增鴻蒙平臺(tái)增加全鏈路平臺(tái)支持，包括API鴻蒙新平臺(tái)參數(shù)支持，DB存儲(chǔ)鴻蒙相關(guān)必要業(yè)務(wù)字段，鴻蒙用戶(hù)目標(biāo)篩選，鴻蒙平臺(tái)消息統(tǒng)計(jì)等
3. 基于華為鴻蒙的推送消息廠(chǎng)商API，適配全新鴻蒙消息通道
4. 基于極光消息web portal頁(yè)面控制臺(tái)的鴻蒙新平臺(tái)支持
其中，極光消息后臺(tái)服務(wù)端支持鴻蒙平臺(tái)是整體的關(guān)鍵點(diǎn)所在。在極光原有平臺(tái)框架基礎(chǔ)上，增加了鴻蒙完整的消息鏈路：
web portal是極光消息服務(wù)的控制臺(tái)，改造后，也對(duì)鴻蒙平臺(tái)做了全面的支持。
以下是極光web portal頁(yè)面控制，針對(duì)鴻蒙平臺(tái)新增部分相關(guān)示例：
● 鴻蒙平臺(tái)推送設(shè)置
● 鴻蒙平臺(tái)消息推送管理
● 鴻蒙平臺(tái)消息推送統(tǒng)計(jì)
● 鴻蒙SDK概述
眾所周知，鴻蒙平臺(tái)的應(yīng)用基于全新的ArkTS語(yǔ)言開(kāi)發(fā)。因此，極光也基于該語(yǔ)言開(kāi)發(fā)了鴻蒙平臺(tái)SDK，當(dāng)前極光鴻蒙SDK支持HarmonyOS API 11及以上版本。
● 鴻蒙SDK主要功能
類(lèi)似極光Android、IOS等平臺(tái)SDK，極光鴻蒙SDK同樣主要提供了以下功能：
1. 保持與服務(wù)器的長(zhǎng)連接，以便消息能夠即時(shí)推送到達(dá)客戶(hù)端
2. 接收通知，并向開(kāi)發(fā)者 App 傳送指定消息
● 鴻蒙SDK接入適配
鴻蒙SDK接入API主要涉及以下幾類(lèi)：
|
SDK API |
說(shuō)明 |
|
設(shè)置調(diào)試模式API |
setDebug ● 可選接口 ● 初始化前，AbilityStage(#onCreate) 里調(diào)用 |
|
配置極光Appkey |
setAppKey ● 初始化前，AbilityStage(#onCreate) 里調(diào)用 |
|
開(kāi)啟推送業(yè)務(wù)功能API |
init ● 啟動(dòng)時(shí)調(diào)用，AbilityStage(#onCreate) 里調(diào)用 |
|
獲取 RegistrationID |
getRegistrationId ● 反回注冊(cè)的rid |
|
設(shè)置回調(diào)接口 |
setCallBackMsg ● 監(jiān)聽(tīng)回調(diào)事件和數(shù)據(jù) ● 初始化前，AbilityStage(#onCreate) 里調(diào)用 ● 詳細(xì)回調(diào)接口，可參考極光官網(wǎng)SDK API |
|
通知跳轉(zhuǎn) |
setClickWant ● 請(qǐng)先setAppKey，否則調(diào)用無(wú)效 |
|
標(biāo)簽與別名API |
addTags/deleteTags/setTags等 ● 詳細(xì)接口使用，可參考極光官網(wǎng)SDK API |
鴻蒙SDK可在極光官網(wǎng)進(jìn)行下載，并參考API使用說(shuō)明，鴻蒙廠(chǎng)商參數(shù)配置等接入指南。
另，對(duì)于ArkTS和HarmonyOS的編程特性和使用，請(qǐng)參考華為官網(wǎng)。
對(duì)接鴻蒙平臺(tái)消息推送業(yè)務(wù)，后臺(tái)服務(wù)端基本繼承極光原有rest api體系。極光遵循以客戶(hù)開(kāi)發(fā)者為本，對(duì)與新平臺(tái)支持的目標(biāo)是，以期在客戶(hù)改動(dòng)最少的情況下，最大程度兼容原有服務(wù)。
● 推送API
在推送API參數(shù)中，涉及鴻蒙相關(guān)的字段主要為platform推送平臺(tái)和notification通知
platform：
notification:
通知字段主要描述推送實(shí)體內(nèi)容對(duì)象，會(huì)作為“通知”推送到客戶(hù)端。以下是鴻蒙平臺(tái)API推送消息涉及的相關(guān)字段：
|
關(guān)鍵字 |
類(lèi)型 |
選項(xiàng) |
含義 |
說(shuō)明 |
|
alert |
string |
必填 |
通知內(nèi)容 |
● 這里指定后會(huì)覆蓋上級(jí)統(tǒng)一指定的 alert 信息。 ● 內(nèi)容可以為空字符串，表示不展示到通知欄。 |
|
title |
string |
可選 |
通知標(biāo)題 |
● 如果指定了，則通知里原來(lái)展示 App 名稱(chēng)的地方，將展示 title。否則使用WebPortal配置的默認(rèn)title。 |
|
category |
string |
必填 |
通知欄消息分類(lèi)條目 |
● 此字段由于廠(chǎng)商為必填字段，效果也完全依賴(lài) rom 廠(chǎng)商對(duì) category 的處理策略，請(qǐng)開(kāi)發(fā)者務(wù)必填寫(xiě)。極光內(nèi)部對(duì)此字段實(shí)際未進(jìn)行必填校驗(yàn)，請(qǐng)開(kāi)發(fā)者按照必填處理。 ● 此字段值對(duì)應(yīng)官方「本地通知」category取值，開(kāi)發(fā)者通過(guò)極光服務(wù)發(fā)起推送時(shí)如果傳遞了此字段值，請(qǐng)務(wù)必按照官方要求傳遞，官方category分類(lèi)取值規(guī)則也可參考 |
|
large_icon |
string |
可選 |
通知欄大圖標(biāo) |
● 要求傳遞網(wǎng)絡(luò)地址，使用HTTPS協(xié)議，取值樣例：https://example.com/image.png ● 圖標(biāo)大小不超過(guò) 30 k，圖片長(zhǎng)*寬<12800像素 |
|
intent |
JSON Object |
可選 |
指定跳轉(zhuǎn)頁(yè)面 |
支持跳轉(zhuǎn)到 deeplink 地址和應(yīng)用首頁(yè)兩種類(lèi)型： 1. 跳轉(zhuǎn)應(yīng)用首頁(yè)：固定 action.system.home 2. 跳轉(zhuǎn)到 deeplink 地址: scheme://test?key1=val1&key2=val2 |
|
badge_add_num |
int |
可選 |
設(shè)置角標(biāo)數(shù)字累加值 |
● 此字段如果不填，表示不改變角標(biāo)數(shù)字 ●
取值范圍為：1-99，若設(shè)置了取值范圍內(nèi)的數(shù)字，下一條通知欄消息配置的 badge_add_num 數(shù)據(jù)會(huì)和原角標(biāo)數(shù)量進(jìn)行相加，建議取值為 1 |
|
test_message |
boolean |
可選 |
測(cè)試消息標(biāo)識(shí) |
測(cè)試消息標(biāo)識(shí)： ● false：正常消息（默認(rèn)值） ● true：測(cè)試消息 |
|
receipt_id |
string |
可選 |
華為回執(zhí) ID |
輸入一個(gè)唯一的回執(zhí) ID 指定本次下行消息的回執(zhí)地址及配置，該回執(zhí) ID 可以在極光鴻蒙回執(zhí)參數(shù)配置中查看 |
|
extras |
JSON Object |
可選 |
擴(kuò)展字段 |
● 這里自定義 JSON 格式的 Key / Value 信息，以供業(yè)務(wù)使用 |
● 統(tǒng)計(jì)API/標(biāo)簽別名API，基本兼容極光原有API，詳細(xì)使用可參考極光官網(wǎng)。
限于篇幅原因，本文簡(jiǎn)單介紹了極光消息推送服務(wù)接入鴻蒙平臺(tái)的相關(guān)事項(xiàng)，當(dāng)然也無(wú)法覆蓋極光消息服務(wù)鴻蒙平臺(tái)使用的方方面面。同時(shí)，也因HarmonyOS正式版本暫未發(fā)布。極光消息服務(wù)會(huì)對(duì)HarmonyOS的發(fā)布、更新、迭代保持密切關(guān)注，在正式版本及新特性公布的第一時(shí)間進(jìn)行迭代，以期盡力服務(wù)好極光的每一個(gè)客戶(hù)。
謝謝大家對(duì)極光消息服務(wù)的關(guān)注。
極光鴻蒙SDK集成指南：push/client/HarmonyOS/hmos_guide">https://docs.jiguang.cn/jpush/client/HarmonyOS/hmos_guide
極光鴻蒙服務(wù)端API使用：https://docs.jiguang.cn/jpush/server/push/server_overview
鴻蒙開(kāi)發(fā)者官網(wǎng)指南：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V2/1_1_u5feb_u901f_u5165_u95e8-0000001478340845-V2
熱門(mén)文章
《GPTBots Multi-Agent架構(gòu)解析：如何通過(guò)多Agent協(xié)同實(shí)現(xiàn)業(yè)務(wù)智能化升級(jí)》
2025-10-13
GPTBots × ZohoSalesIQ 集成實(shí)戰(zhàn)：智能代理與?效轉(zhuǎn)??的最佳實(shí)踐解析
2025-09-05
EngageLab 發(fā)布 Chrome 插件推送能力：解鎖 WebPush 免授權(quán)、系統(tǒng)級(jí)通知新體驗(yàn)
2025-09-01
GPTBots 技術(shù)揭秘：我們?nèi)绾螐?到1打造支撐AI高效運(yùn)行的會(huì)話(huà)級(jí)代碼解釋器
2025-08-18
開(kāi)發(fā)者必看：2025最高效的推送圖標(biāo)配置指南
2025-07-16
相關(guān)文章
極光官方微信公眾號(hào)
關(guān)注我們，即時(shí)獲取最新極光資訊
現(xiàn)在注冊(cè)，領(lǐng)取新人大禮包
