跳到主要内容
版本:v7

Capacitor Android API

Capacitor Android 是支撑 Capacitor 应用在 Android 平台上运行的本地运行时环境。

桥接机制

Android 桥接层是 Capacitor Android 库的核心组件。桥接对象提供了多种方法用于获取信息或改变行为。

当插件在 Capacitor 中注册后,即可访问桥接对象:

this.bridge

getConfig()

public CapConfig getConfig()

此属性包含 Capacitor 运行时已知的配置对象。


triggerJSEvent(...)

public void triggerJSEvent(final String eventName, final String target)
public void triggerJSEvent(final String eventName, final String target, final String data)

在 JavaScript 的 [EventTarget](https://developer.mozilla.org/en-US/docs/Web/API EventTarget)(如 windowdocument)上触发事件。建议优先使用插件事件

使用示例:

bridge.triggerJSEvent("myCustomEvent", "window");
bridge.triggerJSEvent("myCustomEvent", "document", "{ 'dataKey': 'dataValue' }");

注意:data 参数必须是序列化的 JSON 字符串值。


数据传递

关于处理跨环境数据传递的注意事项,请参阅此文档


保存 CAPPluginCall

关于为异步或重复操作持久化插件调用的说明,可查阅此指南