feat(iOS): Open CAPBridgeViewController for subclassing

[ikeith]

This branch refactors CAPBridgeViewController to make it available for subclassing. This is necessary for many embedded uses and allows it address several outstanding issues.

• Subclasses can override webView(with:configuration:) to return a custom subclass of WKWebView if desired. This addresses feat(ios): Add ios capacitor config to use a custom wkwebview #3095

• Subclasses can override instanceDescriptor to modify the capacitor configuration at runtime after the config file is loaded, or to completely customize the environment. This addresses feat: Support loading from alternate path #3912 & feat: Ability to modify config during bridge initialization #3913 as well as allow for embedded uses where the web app will not exist in the expected locations in the application bundle.

• Subclasses can override webViewConfiguration to make any changes to the configuration before it is used to instantiate the web view. This addresses How to set additional wkWebView settings #1097

• Subclasses can override capacitorDidLoad or viewDidLoad to make any desired changes to the webview or related views. This provides a stable point for operations like Added disable drag and drop in a WKWebView. #3546 without requiring that the code be merged in upstream or added via a plugin.

In addition, this branch unifies much of the path handling to ensure that the config is the one true source for where the web app is located. It also eliminates some of the side effects of the previous implementation like isNewBinary() modifying UserDefaults such that it would return different results on subsequent invocations.

[jcesarmobile]

Can we instead of having the webViewClass thing have an open method where the WebView is created so they can override that instead?
That way if their custom WKWebView subclass has a custom init they can use it, with current implementation it's not possible.

[tossaro]

hello everyone, first of all thanks for opening CAPBridgeViewController so we can create subclasses, but I am facing blockers when adding hooks to web view lifecycle like didFinish, didFail etc, due to existing loadView is final function that have:
let delegateHandler = WebViewDelegationHandler()
I have created a subclass of WebViewDelegationHandler then use at capacitorDidLoad(), but it makes the bridge not work.
So could you please make loadView not final function? or maybe any additional open function that refer to delegation like instanceDescriptor function. thank you

existing capacitor 6.1.0 file CAPBridgeViewController:
override public final func loadView() { // load the configuration and set the logging flag let configDescriptor = instanceDescriptor() let configuration = InstanceConfiguration(with: configDescriptor, isDebug: CapacitorBridge.isDevEnvironment) CAPLog.enableLogging = configuration.loggingEnabled logWarnings(for: configDescriptor) setStatusBarDefaults() setScreenOrientationDefaults() // get the web view let assetHandler = WebViewAssetHandler(router: router()) assetHandler.setAssetPath(configuration.appLocation.path) assetHandler.setServerUrl(configuration.serverURL) let delegationHandler = WebViewDelegationHandler() prepareWebView(with: configuration, assetHandler: assetHandler, delegationHandler: delegationHandler) view = webView // create the bridge capacitorBridge = CapacitorBridge(with: configuration, delegate: self, cordovaConfiguration: configDescriptor.cordovaConfiguration, assetHandler: assetHandler, delegationHandler: delegationHandler) capacitorDidLoad() if configDescriptor.instanceType == .fixed { updateBinaryVersion() } }