More docs

Author: Legend-Master

crates/tauri-runtime/src/webview.rs

@@ -203,8 +203,13 @@ pub struct WebviewAttributes {
   ///
   /// ## Platform-specific
   ///
-  /// - **Android on Wry:** The Android WebView does not provide an API for initialization scripts,
-  ///   so we prepend them to each HTML head. They are only implemented on custom protocol URLs.
+  /// - **Windows:** scripts are always added to subframes.
+  /// - **Android:** When [addDocumentStartJavaScript] is not supported,
+  ///   we prepend initialization scripts to each HTML head (implementation only supported on custom protocol URLs).
+  ///   For remote URLs, we use [onPageStarted] which is not guaranteed to run before other scripts.
+  ///
+  /// [addDocumentStartJavaScript]: https://developer.android.com/reference/androidx/webkit/WebViewCompat#addDocumentStartJavaScript(android.webkit.WebView,java.lang.String,java.util.Set%3Cjava.lang.String%3E)
+  /// [onPageStarted]: https://developer.android.com/reference/android/webkit/WebViewClient#onPageStarted(android.webkit.WebView,%20java.lang.String,%20android.graphics.Bitmap)
   pub initialization_scripts: Vec<InitializationScript>,
   pub data_directory: Option<PathBuf>,
   pub drag_drop_handler_enabled: bool,
@@ -559,12 +564,3 @@ pub struct InitializationScript {
   /// Whether the script should be injected to main frame only
   pub for_main_frame_only: bool,
 }
-
-impl InitializationScript {
-  pub fn new(script: &str, for_main_frame_only: bool) -> Self {
-    Self {
-      script: script.to_owned(),
-      for_main_frame_only,
-    }
-  }
-}