鸿蒙ArkUI-X跨语言调用说明：【平台桥接开发指南（Android）BridgePlugin】

news2025/1/6 19:05:14

BridgePlugin (平台桥接)

本模块提供ArkUI端和Android平台端消息通信的功能，包括数据传输、方法调用和事件调用。需配套ArkUI端API使用，ArkUI侧具体用法请参考[Bridge API]。

说明：
开发前请熟悉鸿蒙开发指导文档： gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。
本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

import ohos.ace.adapter.capability.bridge.BridgePlugin;

BridgePlugin

BridgePlugin(Context context, String bridgeName, int instanceId);

创建BridgePlugin类。

参数：

参数名	类型	必填	说明
context	Context	是	应用程序的上下文。
bridgeName	string	是	定义桥接名称。
instanceId	int	是	实例ID。

返回值：

类型	说明
BridgePlugin	桥接结果接口。

示例：

public class BridgeImpl extends BridgePlugin {
  ...
}

BridgeImpl bridgeImpl = new BridgeImpl(this, "Bridge", getInstanceId());

callMethod

public void callMethod(MethodData methodData);

调用ArkUI端的方法。

参数：

参数名	类型	必填	说明
methodData	MethodData	是	方法数据结构。

MethodData结构

名称	类型	说明
methodName	String	方法名。
Parameters	Object[]	方法参数。

返回值：

无

示例：

Object[] paramObject = { "param1", "param2" };
MethodData methodData = new MethodData("jsMethod", paramObject);
bridgeImpl.callMethod(methodData);

sendMessage

public void sendMessage(Object data);

向ArkUI端发送数据。

参数：

参数名	类型	必填	说明
data	Object	是	数据。

返回值： 无

示例：

String[] data = { "message1", "message2" };
bridgeImpl.sendMessage(data);

setMessageListener

public void setMessageListener(IMessageListener messageListener);

注册消息监听。

参数：

参数名	类型	必填	说明
messageListener	IMessageListener	是	信息监听接口类。

IMessageListener

IMessageListener	参数	参数描述	返回值	说明
onMessage	data: Object	数据信息。	Object	等待ArkUI端发送信息。
onMessageResponse	data: Object	数据信息。	无	等待ArkUI端发送信息应答。

示例：

public BridgeImpl(Context context, String name, int id) {
    super(context, name, id);
    this.name = name;
    setMessageListener(this);
}

@Override
public Object onMessage(Object data) {
    ALog.i("onMessage data: ", data.toString());
    return jsonObject;
}

@Override
public void onMessageResponse(Object data) {
    ALog.i("onMessageResponse data: ", data.toString());
}

setMethodResultListener

public void setMethodResultListener(IMethodResult methodResultListener);

注册方法返回监听

参数：

参数名	类型	必填	说明
methodResultListener	IMethodResult	是	方法返回监听接口类。

IMethodResult

IMethodResult	参数	参数描述	返回值	说明
onSuccess	resultValue：Object	返回值信息。	无	调用方法返回成功。
onError	methodName : String errorCode : int errorMessage : string	方法名。错误类型。错误信息。	无	调用方法返回失败。
onMethodCancel	methodName : string	方法名。	无 `HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿`	监听取消方法注册。

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

public BridgeImpl(Context context, String name, int id) {
    super(context, name, id);
    this.name = name;
    setMethodResultListener(this);
}

@Override
public void onSuccess(Object res) {
    ALog.i("onJsSendMethodResult result: ", res.toString());
}

@Override
public void onError(String name, int code, String message) {
    ALog.i("onError: ", message);
}

@Override
public void onMethodCancel(String name) {
    ALog.i("onCancel: ", name);
}

鸿蒙开发岗位需要掌握那些核心要领？

目前还有很多小伙伴不知道要学习哪些鸿蒙技术？不知道重点掌握哪些？为了避免学习时频繁踩坑，最终浪费大量时间的。

自己学习时必须要有一份实用的鸿蒙（Harmony NEXT）资料非常有必要。这里我推荐，根据鸿蒙开发官网梳理与华为内部人员的分享总结出的开发文档。内容包含了：【ArkTS、ArkUI、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战】等技术知识点。

废话就不多说了，接下来好好看下这份资料。

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