唐茗 发表于 2025-6-20 11:28:38

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的三方库等。
说明
平台桥接支持ArkUI调用Android Java API和iOS Objective-C API。此外,一些平台相关功能可直接通过已有的OpenHarmony跨平台API实现。
数据类型支持

平台桥接通过JSON格式或二进制格式序列化编解码传递数据,支持基础数据类型、数组类型和结构化数据。具体支持类型如下表
JSON格式数据支持类型表:
ArkTSJavaObjective-Cstringjava.lang.StringNSStringnumber(32bit integer)java.lang.IntegerNSNumber numberWithIntnumber(64bit integer)java.lang.LongNSNumber numberWithLongnumber(double)java.lang.DoubleNSNumber numberWithDoublebooleanjava.lang.BooleanNSNumber numberWithBoolnullnullNSNullArraystring[]NSArrayArrayint[], long[], double[]NSArrayArrayboolean[]NSArrayRecordjava.util.HashMapNSDictionary二进制格式数据支持类型表:
ArkTSjava类型OC类型nullnullNSNullbooleanjava.lang.BooleanNSNumber numberWithBoolnumber(32bit integer)java.lang.IntegerNSNumber numberWithIntnumber(64bit integer)java.lang.LongNSNumber numberWithLongnumber(double)java.lang.DoubleNSNumber numberWithDoublestringjava.lang.StringNSStringArrayBufferjava.nio.ByteBufferNSDataArraystring[]NSArrayArrayint[], long[], double[]NSArrayArrayboolean[]NSArrayRecordjava.util.HashMapNSDictionary说明
1、S表示string、number、boolean类型;

2、Record表示类型,key仅为string类型,value为S类型;

3、string类型数据最大传输大小限制为2MB;


来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!

归悦可 发表于 2025-10-23 21:18:37

懂技术并乐意极积无私分享的人越来越少。珍惜

谲脾 发表于 2025-10-25 03:17:41

新版吗?好像是停更了吧。

供挂 发表于 2025-12-1 08:53:57

分享、互助 让互联网精神温暖你我

卜笑 发表于 2025-12-19 18:10:19

喜欢鼓捣这些软件,现在用得少,谢谢分享!

垢峒 发表于 2025-12-21 00:50:19

懂技术并乐意极积无私分享的人越来越少。珍惜

存叭 发表于 2025-12-22 16:11:35

这个有用。

韦逸思 发表于 2026-1-6 05:30:15

感谢,下载保存了

捐催制 发表于 2026-1-7 02:17:25

新版吗?好像是停更了吧。

水苯 发表于 2026-1-18 03:10:25

前排留名,哈哈哈

归筠溪 发表于 2026-1-18 06:16:46

分享、互助 让互联网精神温暖你我

宛蛲 发表于 2026-1-18 07:16:53

感谢分享

移国拱 发表于 2026-1-20 08:18:57

谢谢楼主提供!

薯羞 发表于 2026-1-20 20:00:54

东西不错很实用谢谢分享

司空娅玲 发表于 2026-1-23 19:50:35

感谢分享

柄利 发表于 2026-1-24 05:42:44

热心回复!

育局糊 发表于 2026-1-24 07:29:27

鼓励转贴优秀软件安全工具和文档!

笃扇 发表于 2026-1-25 08:35:33

过来提前占个楼

计海龄 发表于 2026-1-27 08:20:13

前排留名,哈哈哈

讲怔 发表于 2026-1-29 02:06:01

感谢分享,学习下。
页: [1] 2 3
查看完整版本: ArkUI-X平台桥接Bridge说明