在鸿蒙 ArkTS 中调用 Android 库（Java/Kotlin），核心依赖于 ArkUI-X 提供的平台桥接（@arkui-x.bridge）机制。

1. 核心桥接原理

ArkTS 和 Java 本身没有直接相互调用的能力。平台桥接在底层引入了 C++ 作为中间层，实现了 ArkTS ↔ C++ ↔ Java 的链路。不过，这一复杂的底层交互对开发者是透明的，在实际开发中，你可以将其视为 ArkTS 和 Java 在进行直接交互。

2. 主要应用场景

当应用需要复用现有的 Android 平台代码，而 OpenHarmony 中缺少对应的跨平台 API（非 UI 相关）时，平台桥接非常适用。具体包括：

• 双向数据传递：在 ArkUI 与 Android 平台之间传递 JSON 数据、图片等。
• 调用平台 API：在 ArkTS 侧调用 Android 的原生 API（如获取电池电量），或直接复用 Android 端的三方库。
• 平台回调 ArkTS：Android 平台调用 ArkUI 侧的方法，例如复用 JavaScript 的三方库。

3. 数据类型映射

平台桥接支持通过 JSON 或二进制格式进行序列化编解码。在传递数据时，ArkTS 与 Java 的数据类型存在严格的映射关系：

• 基础类型：string 对应 java.lang.String，boolean 对应 java.lang.Boolean。
• 数值类型：ArkTS 的 number 根据精度可映射为 java.lang.Integer（32位）、java.lang.Long（64位）或 java.lang.Double。
• 集合类型：Array 对应 java.util.ArrayList 或原生数组，Record/Map 对应 java.util.HashMap。
• 二进制流：ArrayBuffer 对应 java.nio.ByteBuffer。

4. 开发注意事项

• String 传输限制：通过平台桥接传递的 string 类型数据，最大传输大小限制为 2MB。
• Map 类型限制：Map 类型仅支持 string 类型的 key，并且仅能用于方法的返回值。
• API 参考：在 ArkUI 侧的具体用法请参考 Bridge API，Android 侧的插件实现请参考 BridgePlugin。

一、 核心架构：全局实例与子线程并发优化

在 ArkUI-X 6.0.2 及之后的版本中，平台桥接进行了底层重构，企业级应用应充分利用新特性解决性能瓶颈。

1. 全局实例解耦：Bridge 实例不再与 Ability 强绑定，支持应用内任意模块全局调用，彻底消除冗余的上下文传递代码。
2. 子线程耗时操作：对于跨平台数据交互中的耗时操作（如大文件解析、复杂加密），必须开启 Bridge 子线程运行模式，避免阻塞主线程导致 UI 卡顿。
3. 同步接口调用：针对需要即时获取返回结果的场景（如跨平台权限校验、本地缓存读取），使用新增的同步调用能力，避免回调嵌套（Callback Hell）。

二、 双向数据流闭环：ArkTS 与 Java 的无缝交互

通过 @arkui-x.bridge 构建完整的消息收发与回执机制。

// 1. ArkTS 侧：创建桥接实例并发送消息
import bridge from '@arkui-x.bridge';

const bridgeImpl = bridge.createBridge('MyBridge');

// 发送数据并接收原生侧的回执
const response = await bridgeImpl.sendMessage('Hello ArkUI-X!');
console.log('Native Response:', response);

// 2. Android (Java) 侧：注册监听并返回回执
public class MyBridgePlugin extends BridgePlugin implements IMessageListener {
    public MyBridgePlugin(Context context, String name, int id) {
        super(context, name, id);
        setMessageListener(this);
    }

    @Override
    public Object onMessage(Object object) {
        // 接收 ArkTS 传来的数据，处理并返回回执
        return "Java onMessage success";
    }
}

三、 跨平台方法调用：双向 RPC 机制

实现 ArkTS 与 Java 之间的方法级互调，支持参数传递与结果回调。

// ArkTS 侧调用 Java 方法
bridgeImpl.callMethod('getBatteryLevel').then((res) => {
    console.log('Battery Level:', res);
}).catch((err) => {
    console.error('Call native failed:', JSON.stringify(err));
});

// Java 侧暴露方法供 ArkTS 调用
public String getBatteryLevel() {
    // 调用 Android 原生 API 获取电量
    BatteryManager bm = (BatteryManager) context.getSystemService(Context.BATTERY_SERVICE);
    return String.valueOf(bm.getIntProperty(BatteryManager.BATTERY_PROPERTY_CAPACITY));
}

四、 工程化实践：第三方 SDK 的桥接封装（以支付为例）

在跨平台项目中，核心诉求之一是“一套代码，多端部署”。对于无法直接跨平台的原生 SDK（如 Google 内购、微信登录），必须通过 Bridge 进行封装。

// ArkTS 侧：统一封装支付接口
async function initiatePayment(productId: string): Promise<boolean> {
  try {
    const result = await bridgeImpl.callMethod('startInAppPurchase', [productId]);
    return result === 'SUCCESS';
  } catch (error) {
    console.error('Payment failed:', error);
    return false;
  }
}

// Android 侧：接入原生内购库并处理回调
public void startInAppPurchase(String productId) {
    // 调用 Android BillingClient 发起购买
    // 购买成功后，通过 Bridge 将结果回传给 ArkTS
}

五、 架构分层设计：隔离平台差异

在大型跨平台工程中，必须采用分层架构，避免业务逻辑与平台代码耦合。

1. 核心层：编写完全跨平台的 ArkTS 业务逻辑和通用 UI 组件。
2. 抽象接口层：定义统一的接口（如 IDataPlatform、IPaymentService），业务层仅依赖接口。
3. 平台适配层：通过 Bridge 或条件编译（#ifdef），在 Android/iOS/HarmonyOS 侧分别实现具体接口。例如，定位功能在鸿蒙调用 ohos.geoLocationManager，在 Android 通过 Bridge 调用原生 LocationManager。