跳到主要内容
版本：v3

Capacitor iOS API

Capacitor iOS 是驱动 Capacitor 应用在 iOS 平台上运行的原生运行时环境。

Bridge（桥接层）​

iOS bridge 是 Capacitor iOS 库的核心。桥接层提供了多个属性和方法，用于获取信息或改变行为。

当插件在 Capacitor 中注册时，会持有对 bridge 的弱引用：

self.bridge?

如果你的方法需要使用 bridge，可以使用 guard 语句进行解包并提前返回：

guard let bridge = self.bridge else { return }

viewController（视图控制器）​

var viewController: UIViewController? { get }

该属性包含 Capacitor 的主视图控制器，可用于在应用上方展示原生视图。

示例：

DispatchQueue.main.async {
  self.bridge?.viewController.present(ourCustomViewController, animated: true, completion: nil)
}

在 iPad 设备上可以展示弹出窗口：

self.setCenteredPopover(ourCustomViewController)
self.bridge.viewController.present(ourCustomViewController, animated: true, completion: nil)

config（配置）​

var config: InstanceConfiguration { get }

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

triggerJSEvent(...)（触发JS事件）​

func triggerJSEvent(eventName: String, target: String)
func triggerJSEvent(eventName: String, target: String, data: String)

在 JavaScript 的 EventTarget（如 window 或 document）上触发事件。如果可能，建议优先使用插件事件。

示例：

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

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

localURL(...)（本地URL转换）​

func localURL(fromWebURL webURL: URL?) -> URL?

将网页视图中的 URL 转换为 iOS 原生的文件 URL。

网页视图可能处理多种不同类型的 URL：

  • res://（指向 web 资产的快捷方案）
  • file://（指向本地设备上文件的完整限定 URL）

portablePath(...)（可移植路径转换）​

func portablePath(fromLocalURL localURL: URL?) -> URL?

将 iOS 原生的文件 URL 转换为可在网页视图中加载的 URL。

数据传递​

关于在不同环境间传递数据的注意事项，请参阅此处。

保存 CAPPluginCall​

关于异步或重复操作中持久化插件调用的注意事项，请参阅此处。

Contents

编辑此页