跳到主要内容
版本:v5

Capacitor Android API

Capacitor Android 是为 Android 平台上的 Capacitor 应用提供支持的本地运行时环境。

Bridge 桥接层

Android bridge 是 Capacitor Android 库的核心组件。bridge 提供多个方法用于获取信息或改变行为。

当插件在 Capacitor 中注册后,即可访问 bridge:

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(如 windowdocument)上触发事件。如果可能,建议优先使用插件事件

使用示例:

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

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


数据传输

关于如何在环境间传递数据的注意事项,请参阅此处


保存 CAPPluginCall

关于如何持久化插件调用以支持异步或重复操作的说明,请查看此文档