平臺(tái)橋接(@arkui-x.bridge)

簡(jiǎn)介

平臺(tái)橋接用于客戶端（ArkUI）和平臺(tái)（Android或iOS）之間傳遞消息，即用于ArkUI與平臺(tái)雙向數(shù)據(jù)傳遞、ArkUI側(cè)調(diào)用平臺(tái)的方法、平臺(tái)調(diào)用ArkUI側(cè)的方法。

以Android平臺(tái)為例，ArkTS和Java沒有相互調(diào)用的能力，為了實(shí)現(xiàn)ArkTS和Java交互，需要ArkTS與C++交互，C++再與Java交互，反之亦然。但是對(duì)于開發(fā)者，就像是ArkTS和Java直接交互。

本文介紹如何通過平臺(tái)橋接編寫自定義的Android、iOS平臺(tái)代碼。ArkUI側(cè)具體用法請(qǐng)參考[Bridge API]，Android側(cè)參考[BridgePlugin]，iOS側(cè)參考[BridgePlugin]。

使用場(chǎng)景及能力

使用場(chǎng)景

平臺(tái)橋接主要用于這樣的場(chǎng)景：應(yīng)用需要復(fù)用平臺(tái)的代碼，而在OpenHarmony中沒有對(duì)應(yīng)的跨平臺(tái)API（不包括UI相關(guān)）實(shí)現(xiàn)。

具體可用于以下場(chǎng)景：

1、ArkUI與平臺(tái)雙向傳遞數(shù)據(jù)，如傳遞JSON數(shù)據(jù)、圖片等；
2、ArkUI側(cè)調(diào)用平臺(tái)的API，如獲取Android或iOS平臺(tái)上的電池電量、復(fù)用平臺(tái)上的三方庫等；
3、平臺(tái)調(diào)用ArkUI側(cè)的方法，如復(fù)用JavaScript的三方庫等。

說明
開發(fā)前請(qǐng)熟悉鴻蒙開發(fā)指導(dǎo)文檔：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
平臺(tái)橋接支持ArkUI調(diào)用Android Java API和iOS Objective-C API。此外，一些平臺(tái)相關(guān)功能可直接通過已有的[OpenHarmony跨平臺(tái)API]實(shí)現(xiàn)。

數(shù)據(jù)類型支持

平臺(tái)橋接通過JSON格式序列化編解碼傳遞數(shù)據(jù)，支持基礎(chǔ)數(shù)據(jù)類型、數(shù)組類型和結(jié)構(gòu)化數(shù)據(jù)。具體支持類型如下表：

說明
HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿
S表示string、number、boolean類型，T表示S及其對(duì)應(yīng)的數(shù)組類型； Map類型僅支持string類型的key，且僅用于方法返回。

審核編輯 黃宇