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

簡介

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

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

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

使用場景及能力

使用場景

平臺橋接主要用于這樣的場景：應用需要復用平臺的代碼，而在OpenHarmony中沒有對應的跨平臺API（不包括UI相關）實現(xiàn)。

具體可用于以下場景：

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

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

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

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

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

審核編輯 黃宇