鸿蒙ArkUI-X跨语言调用说明：【平台桥接(@arkui-x.bridge)】

news2024/12/29 9:44:40

平台桥接(@arkui-x.bridge)

简介

平台桥接用于客户端（ArkUI）和平台（Android或iOS）之间传递消息，即用于ArkUI与平台双向数据传递、ArkUI侧调用平台的方法、平台调用ArkUI侧的方法。

以Android平台为例，ArkTS和Java没有相互调用的能力，为了实现ArkTS和Java交互，需要ArkTS与C++交互，C++再与Java交互，反之亦然。但是对于开发者，就像是ArkTS和Java直接交互。

本文介绍如何通过平台桥接编写自定义的Android、iOS平台代码。ArkUI侧具体用法请参考[Bridge API]，Android侧参考[BridgePlugin]，iOS侧参考[BridgePlugin]。

使用场景及能力

使用场景

平台桥接主要用于这样的场景：应用需要复用平台的代码，而在OpenHarmony中没有对应的跨平台API（不包括UI相关）实现。

具体可用于以下场景：

1、ArkUI与平台双向传递数据，如传递JSON数据、图片等；
2、ArkUI侧调用平台的API，如获取Android或iOS平台上的电池电量、复用平台上的三方库等；
3、平台调用ArkUI侧的方法，如复用JavaScript的三方库等。

说明
开发前请熟悉鸿蒙开发指导文档： gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。
平台桥接支持ArkUI调用Android Java API和iOS Objective-C API。此外，一些平台相关功能可直接通过已有的[OpenHarmony跨平台API]实现。

数据类型支持

平台桥接通过JSON格式序列化编解码传递数据，支持基础数据类型、数组类型和结构化数据。具体支持类型如下表：

ArkTS	Java	Objective-C
string	java.lang.String	NSString
number(32bit integer)	java.lang.Integer	NSNumber numberWithInt
number(double)	java.lang.Double	NSNumber numberWithDouble
boolean	java.lang.Boolean	NSNumber numberWithBool
null	null	NSNull
Array<S>	java.util.ArrayList	NSArray
Map<string, T>	java.util.HashMap	NSDictionary

说明
HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿
S表示string、number、boolean类型，T表示S及其对应的数组类型； Map类型仅支持string类型的key，且仅用于方法返回。

搜狗高速浏览器截图20240326151547.png

最后呢，很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。