Merge pull request beeware#2109 from freakboy3742/webkit-inspector

Enable webkit inspector for iOS and Cocoa.

changes/2109.feature.rst

@@ -0,0 +1 @@
+The WebKit inspector is automatically enabled on all webviews, provided you're using macOS 13.3 (Ventura) or iOS 16.4, or later.

cocoa/src/toga_cocoa/widgets/webview.py

@@ -48,6 +48,14 @@ def create(self):
         self.native.interface = self.interface
         self.native.impl = self
 
+        # Enable the content inspector. This was added in macOS 13.3 (Ventura). It will
+        # be a no-op on newer versions of macOS; you need to package the app, then run:
+        #
+        #     defaults write com.example.appname WebKitDeveloperExtras -bool true
+        #
+        # from the command line.
+        self.native.inspectable = True
+
         self.native.navigationDelegate = self.native
         self.native.uIDelegate = self.native
 

docs/reference/api/widgets/webview.rst

@@ -46,16 +46,20 @@ Notes
 * Using WebView on Linux requires that the user has installed the system packages
   for WebKit2, plus the GObject Introspection bindings for WebKit2.
 
-* On macOS, the "inspect element" feature is not enabled by default. WebView
-  debugging is only available when your code is packaged as a full macOS app
-  (e.g., with Briefcase). To enable debugging, run:
+* On macOS 13.3 (Ventura) and later, the content inspector for your app can be opened by
+  running Safari, `enabling the developer tools
+  <https://support.apple.com/en-au/guide/safari/sfri20948/mac>`__, and selecting your
+  app's window from the "Develop" menu.
+
+  On macOS versions prior to Ventura, the content inspector is not enabled by default,
+  and is only available when your code is packaged as a full macOS app (e.g., with
+  Briefcase). To enable debugging, run:
 
     .. code-block:: console
 
         $ defaults write com.example.appname WebKitDeveloperExtras -bool true
 
-    Substituting ``com.example.appname`` with the bundle ID for your packaged
-    app.
+    Substituting ``com.example.appname`` with the bundle ID for your packaged app.
 
 Reference
 ---------

docs/spelling_wordlist

@@ -79,6 +79,7 @@ tvOS
 Ubuntu
 validator
 validators
+Ventura
 verbing
 viewport
 watchOS

iOS/src/toga_iOS/widgets/webview.py

@@ -43,6 +43,10 @@ def create(self):
         self.native.interface = self.interface
         self.native.impl = self
 
+        # Enable the content inspector. This was added in iOS 16.4.
+        # It is a no-op on earlier versions.
+        self.native.inspectable = True
+
         self.native.navigationDelegate = self.native
         self.native.uIDelegate = self.native