跳到主要内容
版本:v4

自定义视图控制器

从 Capacitor 3.0 开始,您可以在应用程序内子类化 CAPBridgeViewController。大多数应用程序不需要此功能,但它提供了一种受支持的机制来处理一些特殊用例。

何时创建子类

需要子类化的情况包括:在运行时覆盖 Capacitor 的配置值、修改 WKWebViewConfiguration 的属性、为 Capacitor 替换自定义的 WKWebView 子类、集成建议在 viewDidLoad() 中添加代码的第三方 SDK,或在原生视图显示到屏幕前对其进行操作。

如果您确实需要创建自定义子类,可以按照以下步骤开始。

创建 MyViewController.swift

首先,通过打开 Xcode、右键单击 App 组(在 App 目标下)、从上下文菜单中选择 New File...、在窗口中选择 Cocoa Touch Class、在下一个屏幕中将 Subclass of: 设置为 UIViewController,并保存文件来创建 MyViewController.swift 文件。

在 Xcode 中创建新视图控制器 在 Xcode 中命名视图控制器

编辑 Main.storyboard

接下来,在项目导航器中选择 Main.storyboard 文件,在 Bridge View Controller Scene 中选择 Bridge View Controller,在右侧选择 Identity Inspector,并将自定义类的名称更改为 MyViewController

在 Xcode 中编辑 Storyboard

编辑 MyViewController.swift

最后,在项目导航器中选择 MyViewController.swift 文件,编辑它以导入 Capacitor 并更改父类:

import UIKit
import Capacitor

class MyViewController: CAPBridgeViewController {
// 其他代码
}

完成!

后续步骤

Xcode 在生成文件时应该已经为您创建了 viewDidLoad() 方法,但请查看 CAPBridgeViewController 中的内联文档,以找到您可能需要的 Capacitor 特定方法。任何标记为 open 的方法都明确暴露给子类进行覆盖。