Capacitor Android API
Capacitor Android 是为 Android 平台上的 Capacitor 应用提供支持的本地运行时环境。
Bridge(桥接)
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
(如 window
或 document
)上触发事件。如有可能,建议优先使用插件事件。
示例:
bridge.triggerJSEvent("myCustomEvent", "window");
bridge.triggerJSEvent("myCustomEvent", "document", "{ 'dataKey': 'dataValue' }");
注意:data
必须是序列化的 JSON 字符串值。
数据传递
关于如何在不同环境间处理传递数据的注意事项,请参阅此处。
保存 CAPPluginCall
关于如何持久化插件调用以实现异步或重复操作的注意事项,请参阅此处。