Feat: add WebViewBuilder::with_limit_navigations_to_app_bound_domains (#1588)

* Added `with_limit_navigations_to_app_bound_domains` to WebViewBuilder

* Update .changes/app-bound-domains.md

---------

Co-authored-by: Jason Tsai <[email protected]>

Author: zphrs

.changes/app-bound-domains.md

@@ -0,0 +1,6 @@
+---
+"wry": "patch"
+---
+
+Add `WebViewBuilder::with_limit_navigations_to_app_bound_domains` only on iOS.
+Function is a no-op if iOS version is less than iOS 14.

src/lib.rs

@@ -1360,6 +1360,8 @@ pub(crate) struct PlatformSpecificWebViewAttributes {
   allow_link_preview: bool,
   #[cfg(target_os = "ios")]
   input_accessory_view_builder: Option<Box<InputAccessoryViewBuilder>>,
+  #[cfg(target_os = "ios")]
+  limit_navigations_to_app_bound_domains: bool,
 }
 
 #[cfg(any(target_os = "macos", target_os = "ios"))]
@@ -1372,6 +1374,8 @@ impl Default for PlatformSpecificWebViewAttributes {
       allow_link_preview: true,
       #[cfg(target_os = "ios")]
       input_accessory_view_builder: None,
+      #[cfg(target_os = "ios")]
+      limit_navigations_to_app_bound_domains: false,
     }
   }
 }
@@ -1432,6 +1436,30 @@ pub trait WebViewBuilderExtIos {
     self,
     builder: F,
   ) -> Self;
+  /// Whether to limit navigations to App-Bound Domains. This is necessary
+  /// to enable Service Workers on iOS.
+  ///
+  /// Note: If you set limit_navigations to true
+  /// make sure to add the following to Info.plist in the iOS project:
+  /// ```xml
+  /// <plist>
+  /// <dict>
+  /// 	<key>WKAppBoundDomains</key>
+  /// 	<array>
+  /// 		<string>localhost</string>
+  /// 	</array>
+  /// </dict>
+  /// </plist>
+  /// ```
+  /// You should also add any additional domains which your app requests assets from.
+  /// Assets served through custom protocols like Tauri's IPC are added to the
+  /// list automatically. Available on iOS only.
+  ///
+  /// Default is false.
+  ///
+  /// See https://webkit.org/blog/10882/app-bound-domains/ and
+  /// https://developer.apple.com/documentation/webkit/wkwebviewconfiguration/limitsnavigationstoappbounddomains
+  fn with_limit_navigations_to_app_bound_domains(self, limit_navigations: bool) -> Self;
 }
 
 #[cfg(target_os = "ios")]
@@ -1448,6 +1476,12 @@ impl WebViewBuilderExtIos for WebViewBuilder<'_> {
       .replace(Box::new(builder));
     self
   }
+  fn with_limit_navigations_to_app_bound_domains(mut self, limit_navigations: bool) -> Self {
+    self
+      .platform_specific
+      .limit_navigations_to_app_bound_domains = limit_navigations;
+    self
+  }
 }
 
 #[cfg(windows)]

src/wkwebview/mod.rs

@@ -63,6 +63,9 @@ use once_cell::sync::Lazy;
 
 #[cfg(target_os = "ios")]
 use crate::wkwebview::ios::WKWebView::WKWebView;
+#[cfg(target_os = "ios")]
+use crate::wkwebview::util::operating_system_version;
+
 #[cfg(target_os = "macos")]
 use objc2_web_kit::WKWebView;
 
@@ -283,6 +286,12 @@ impl InnerWebView {
       let _preference = config.preferences();
       let _yes = NSNumber::numberWithBool(true);
 
+      #[cfg(target_os = "ios")]
+      {
+        if pl_attrs.limit_navigations_to_app_bound_domains && operating_system_version().0 >= 14 {
+          config.setLimitsNavigationsToAppBoundDomains(true);
+        }
+      }
       #[cfg(feature = "mac-proxy")]
       if let Some(proxy_config) = attributes.proxy_config {
         let proxy_config = match proxy_config {