feat: initial work for iOS plugins (#6205)

.changes/android-apis-runtime.md

@@ -0,0 +1,6 @@
+---
+"tauri-runtime": minor
+"tauri-runtime-wry": minor
+---
+
+Add `find_class`, `run_on_android_context` on `RuntimeHandle`.

.changes/cli-mobile-plugin.md

@@ -0,0 +1,6 @@
+---
+"cli.rs": minor
+"cli.js": minor
+---
+
+Add commands to add native Android and iOS functionality to plugins.

.changes/invoke-return-bool.md

@@ -0,0 +1,7 @@
+---
+"tauri-macros": major
+"tauri-codegen": major
+"tauri": major
+---
+
+Return `bool` in the invoke handler.

.changes/mobile-plugins.md

@@ -0,0 +1,5 @@
+---
+"tauri": minor
+---
+
+Run Android and iOS native plugins on the invoke handler if a Rust plugin command is not found.

.changes/plugin-init-fns.md

@@ -0,0 +1,5 @@
+---
+"tauri": minor
+---
+
+Added `initialize_android_plugin` and `initialize_ios_plugin` APIs on `AppHandle`.

.changes/tauri-build-mobile.md

@@ -0,0 +1,5 @@
+---
+"tauri-build": minor
+---
+
+Add `mobile::PluginBuilder` for running build tasks related to Tauri plugins.

.changes/with-webview.md

@@ -0,0 +1,7 @@
+---
+"tauri": minor
+"tauri-runtime": minor
+"tauri-runtime-wry": minor
+---
+
+Implemented `with_webview` on Android and iOS.

.gitignore

@@ -87,3 +87,7 @@ test_video.mp4
 # old cli directories
 /tooling/cli.js
 /tooling/cli.rs
+
+# Swift
+Package.resolved
+.build

Package.swift

@@ -0,0 +1,28 @@
+// swift-tools-version:5.7
+// The swift-tools-version declares the minimum version of Swift required to build this package.
+
+import PackageDescription
+
+let package = Package(
+    name: "TauriWorkspace",
+    products: [
+        .library(name: "Tauri", targets: ["Tauri"]),
+    ],
+    dependencies: [
+        .package(url: "https://github.com/Brendonovich/swift-rs", revision: "eb6de914ad57501da5019154d476d45660559999"),
+    ],
+    targets: [
+        .target(
+            name: "Tauri",
+            dependencies: [
+                .product(name: "SwiftRs", package: "swift-rs"),
+            ],
+            path: "core/tauri/ios/Sources/Tauri"
+        ),
+        .testTarget(
+            name: "TauriTests",
+            dependencies: ["Tauri"],
+            path: "core/tauri/ios/Tests/TauriTests"
+        ),
+    ]
+)

core/tauri-build/Cargo.toml

@@ -27,6 +27,9 @@ heck = "0.4"
 json-patch = "0.2"
 walkdir = "2"
 
+[target."cfg(target_os = \"macos\")".dependencies]
+swift-rs = { git = "https://github.com/Brendonovich/swift-rs", rev = "eb6de914ad57501da5019154d476d45660559999", features = ["build"] }
+
 [target."cfg(windows)".dependencies]
 winres = "0.1"
 semver = "1"

core/tauri-build/src/mobile.rs

@@ -9,6 +9,7 @@ use anyhow::Result;
 #[derive(Default)]
 pub struct PluginBuilder {
   android_path: Option<PathBuf>,
+  ios_path: Option<PathBuf>,
 }
 
 impl PluginBuilder {
@@ -23,53 +24,79 @@ impl PluginBuilder {
     self
   }
 
+  /// Sets the iOS project path.
+  pub fn ios_path<P: Into<PathBuf>>(mut self, ios_path: P) -> Self {
+    self.ios_path.replace(ios_path.into());
+    self
+  }
+
   /// Injects the mobile templates in the given path relative to the manifest root.
   pub fn run(self) -> Result<()> {
     let target_os = std::env::var("CARGO_CFG_TARGET_OS").unwrap();
-    if target_os == "android" {
-      if let Some(path) = self.android_path {
-        let manifest_dir = var("CARGO_MANIFEST_DIR").map(PathBuf::from).unwrap();
-        if let Ok(project_dir) = var("TAURI_ANDROID_PROJECT_PATH") {
-          let source = manifest_dir.join(path);
-          let pkg_name = var("CARGO_PKG_NAME").unwrap();
+    match target_os.as_str() {
+      "android" => {
+        if let Some(path) = self.android_path {
+          let manifest_dir = var("CARGO_MANIFEST_DIR").map(PathBuf::from).unwrap();
+          if let Ok(project_dir) = var("TAURI_ANDROID_PROJECT_PATH") {
+            let source = manifest_dir.join(path);
+            let pkg_name = var("CARGO_PKG_NAME").unwrap();
 
-          println!("cargo:rerun-if-env-changed=TAURI_ANDROID_PROJECT_PATH");
+            println!("cargo:rerun-if-env-changed=TAURI_ANDROID_PROJECT_PATH");
 
-          let project_dir = PathBuf::from(project_dir);
+            let project_dir = PathBuf::from(project_dir);
 
-          inject_android_project(source, project_dir.join("tauri-plugins").join(&pkg_name))?;
+            inject_android_project(source, project_dir.join("tauri-plugins").join(&pkg_name))?;
 
-          let gradle_settings_path = project_dir.join("tauri.settings.gradle");
-          let gradle_settings = fs::read_to_string(&gradle_settings_path)?;
-          let include = format!(
-            "include ':{pkg_name}'
+            let gradle_settings_path = project_dir.join("tauri.settings.gradle");
+            let gradle_settings = fs::read_to_string(&gradle_settings_path)?;
+            let include = format!(
+              "include ':{pkg_name}'
 project(':{pkg_name}').projectDir = new File('./tauri-plugins/{pkg_name}')"
-          );
-          if !gradle_settings.contains(&include) {
-            fs::write(
-              &gradle_settings_path,
-              format!("{gradle_settings}\n{include}"),
-            )?;
-          }
-
-          let app_build_gradle_path = project_dir.join("app").join("tauri.build.gradle.kts");
-          let app_build_gradle = fs::read_to_string(&app_build_gradle_path)?;
-          let implementation = format!(r#"implementation(project(":{pkg_name}"))"#);
-          let target = "dependencies {";
-          if !app_build_gradle.contains(&implementation) {
-            fs::write(
-              &app_build_gradle_path,
-              app_build_gradle.replace(target, &format!("{target}\n  {implementation}")),
-            )?
+            );
+            if !gradle_settings.contains(&include) {
+              fs::write(
+                &gradle_settings_path,
+                format!("{gradle_settings}\n{include}"),
+              )?;
+            }
+
+            let app_build_gradle_path = project_dir.join("app").join("tauri.build.gradle.kts");
+            let app_build_gradle = fs::read_to_string(&app_build_gradle_path)?;
+            let implementation = format!(r#"implementation(project(":{pkg_name}"))"#);
+            let target = "dependencies {";
+            if !app_build_gradle.contains(&implementation) {
+              fs::write(
+                &app_build_gradle_path,
+                app_build_gradle.replace(target, &format!("{target}\n  {implementation}")),
+              )?
+            }
           }
         }
       }
+      #[cfg(target_os = "macos")]
+      "ios" => {
+        if let Some(path) = self.ios_path {
+          link_swift_library(&std::env::var("CARGO_PKG_NAME").unwrap(), path);
+        }
+      }
+      _ => (),
     }
 
     Ok(())
   }
 }
 
+#[cfg(target_os = "macos")]
+#[doc(hidden)]
+pub fn link_swift_library(name: &str, source: impl AsRef<Path>) {
+  let source = source.as_ref();
+  println!("cargo:rerun-if-changed={}", source.display());
+  swift_rs::build::SwiftLinker::new("10.13")
+    .with_ios("11")
+    .with_package(name, source)
+    .link();
+}
+
 #[doc(hidden)]
 pub fn inject_android_project(source: impl AsRef<Path>, target: impl AsRef<Path>) -> Result<()> {
   let source = source.as_ref();

core/tauri-runtime-wry/src/lib.rs

@@ -105,9 +105,7 @@ type FileDropHandler = dyn Fn(&Window, WryFileDropEvent) -> bool + 'static;
 #[cfg(all(desktop, feature = "system-tray"))]
 pub use tauri_runtime::TrayId;
 
-#[cfg(any(desktop, target_os = "android"))]
 mod webview;
-#[cfg(any(desktop, target_os = "android"))]
 pub use webview::Webview;
 
 #[cfg(all(desktop, feature = "system-tray"))]
@@ -1028,7 +1026,6 @@ pub enum ApplicationMessage {
 }
 
 pub enum WindowMessage {
-  #[cfg(any(desktop, target_os = "android"))]
   WithWebview(Box<dyn FnOnce(Webview) + Send>),
   AddEventListener(Uuid, Box<dyn Fn(&WindowEvent) + Send>),
   AddMenuEventListener(Uuid, Box<dyn Fn(&MenuEvent) + Send>),
@@ -1205,7 +1202,6 @@ impl<T: UserEvent> Dispatch<T> for WryDispatcher<T> {
     id
   }
 
-  #[cfg(any(desktop, target_os = "android"))]
   fn with_webview<F: FnOnce(Box<dyn std::any::Any>) + Send + 'static>(&self, f: F) -> Result<()> {
     send_user_message(
       &self.context,
@@ -2305,7 +2301,6 @@ fn handle_user_message<T: UserEvent>(
         });
         if let Some((Some(window), window_event_listeners, menu_event_listeners)) = w {
           match window_message {
-            #[cfg(any(target_os = "android", desktop))]
             WindowMessage::WithWebview(f) => {
               if let WindowHandle::Webview { inner: w, .. } = &window {
                 #[cfg(any(
@@ -2328,6 +2323,14 @@ fn handle_user_message<T: UserEvent>(
                     ns_window: w.ns_window(),
                   });
                 }
+                #[cfg(target_os = "ios")]
+                {
+                  use wry::webview::WebviewExtIOS;
+                  f(Webview {
+                    webview: w.webview(),
+                    manager: w.manager(),
+                  });
+                }
                 #[cfg(windows)]
                 {
                   f(Webview {

core/tauri-runtime-wry/src/webview.rs

@@ -26,6 +26,16 @@ mod imp {
   }
 }
 
+#[cfg(target_os = "ios")]
+mod imp {
+  use cocoa::base::id;
+
+  pub struct Webview {
+    pub webview: id,
+    pub manager: id,
+  }
+}
+
 #[cfg(windows)]
 mod imp {
   use webview2_com::Microsoft::Web::WebView2::Win32::ICoreWebView2Controller;

core/tauri-runtime/src/lib.rs

@@ -505,7 +505,7 @@ pub trait Dispatch<T: UserEvent>: Debug + Clone + Send + Sync + Sized + 'static
   /// Registers a window event handler.
   fn on_menu_event<F: Fn(&window::MenuEvent) + Send + 'static>(&self, f: F) -> Uuid;
 
-  #[cfg(any(desktop, target_os = "android"))]
+  /// Runs a closure with the platform webview object as argument.
   fn with_webview<F: FnOnce(Box<dyn std::any::Any>) + Send + 'static>(&self, f: F) -> Result<()>;
 
   /// Open the web inspector which is usually called devtools.

core/tauri/Cargo.toml

@@ -115,6 +115,9 @@ jni = "0.20"
 [target."cfg(target_os = \"ios\")".dependencies]
 log = "0.4"
 libc = "0.2"
+objc = "0.2"
+cocoa = "0.24"
+swift-rs = { git = "https://github.com/Brendonovich/swift-rs", rev = "eb6de914ad57501da5019154d476d45660559999" }
 
 [build-dependencies]
 heck = "0.4"

core/tauri/build.rs

@@ -154,6 +154,13 @@ fn main() {
       .expect("failed to copy tauri-api Android project");
     }
   }
+
+  #[cfg(target_os = "macos")]
+  {
+    if target_os == "ios" {
+      tauri_build::mobile::link_swift_library("Tauri", "./mobile/ios-api");
+    }
+  }
 }
 
 // create aliases for the given module with its apis.

core/tauri/mobile/ios-api/.gitignore

@@ -0,0 +1,9 @@
+.DS_Store
+/.build
+/Packages
+/*.xcodeproj
+xcuserdata/
+DerivedData/
+.swiftpm/config/registries.json
+.swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata
+.netrc

core/tauri/mobile/ios-api/Package.swift

@@ -0,0 +1,34 @@
+// swift-tools-version: 5.7
+// The swift-tools-version declares the minimum version of Swift required to build this package.
+
+import PackageDescription
+
+let package = Package(
+	name: "Tauri",
+	products: [
+		// Products define the executables and libraries a package produces, and make them visible to other packages.
+		.library(
+			name: "Tauri",
+			type: .static,
+			targets: ["Tauri"]),
+	],
+	dependencies: [
+		// Dependencies declare other packages that this package depends on.
+		.package(url: "https://github.com/Brendonovich/swift-rs", revision: "eb6de914ad57501da5019154d476d45660559999"),
+	],
+	targets: [
+		// Targets are the basic building blocks of a package. A target can define a module or a test suite.
+		// Targets can depend on other targets in this package, and on products in packages this package depends on.
+		.target(
+			name: "Tauri",
+			dependencies: [
+					.product(name: "SwiftRs", package: "swift-rs"),
+			],
+			path: "Sources"
+		),
+		.testTarget(
+			name: "TauriTests",
+			dependencies: ["Tauri"]
+		),
+	]
+)

core/tauri/mobile/ios-api/README.md

@@ -0,0 +1,3 @@
+# Tauri
+
+Tauri iOS API.