如何通过编程方式打开Microsoft.Maui.Controls.WebView开发者工具且避免不支持平台报错

核心方案 #

借助MAUI的平台特定代码编译指令，针对不同平台实现对应开发者工具的打开逻辑，通过条件判断完全规避不支持平台的代码执行，避免异常。

1. Windows平台（基于CoreWebView2） #

Windows平台的MAUI WebView封装了Microsoft.UI.Xaml.Controls.WebView2，直接调用其CoreWebView2的OpenDevToolsWindowAsync方法即可，注意需确保CoreWebView2完成初始化：

private async void OpenDevTools()
{
#if WINDOWS
    if (MyWebView.Handler?.PlatformView is Microsoft.UI.Xaml.Controls.WebView2 webView2)
    {
        // 确保CoreWebView2初始化完成
        if (webView2.CoreWebView2 == null)
        {
            await webView2.EnsureCoreWebView2Async();
        }
        await webView2.CoreWebView2.OpenDevToolsWindowAsync();
    }
#endif
}

注：MyWebView为你在XAML中定义的MAUI WebView实例

2. Android平台 #

Android WebView需开启调试模式，用户需在Chrome浏览器的chrome://inspect页面中进行调试，代码中仅需开启调试权限：

#if ANDROID
    if (MyWebView.Handler?.PlatformView is Android.Webkit.WebView androidWebView)
    {
        Android.Webkit.WebView.SetWebContentsDebuggingEnabled(true);
        // 可弹窗提示用户操作路径
        await Application.Current.MainPage.DisplayAlert("提示", "请在Chrome浏览器中打开chrome://inspect调试WebView", "确定");
    }
#endif

3. iOS/MacCatalyst平台 #

iOS和MacCatalyst基于WKWebView，需开启开发者额外功能，用户需在Safari的「开发」菜单中选择对应应用调试：

#if IOS || MACCATALYST
    if (MyWebView.Handler?.PlatformView is WebKit.WKWebView wkWebView)
    {
        wkWebView.Configuration.Preferences.SetValueForKey(NSObject.FromObject(true), new NSString("developerExtrasEnabled"));
        // 弹窗提示用户操作路径
        await Application.Current.MainPage.DisplayAlert("提示", "请在Safari的「开发」菜单中选择对应应用调试WebView", "确定");
    }
#endif

4. 跨平台整合代码 #

将各平台逻辑整合，通过编译指令自动适配目标平台，不支持的平台直接提示：

private async void OpenDeveloperTools()
{
#if WINDOWS
    if (MyWebView.Handler?.PlatformView is Microsoft.UI.Xaml.Controls.WebView2 webView2)
    {
        if (webView2.CoreWebView2 == null)
        {
            await webView2.EnsureCoreWebView2Async();
        }
        await webView2.CoreWebView2.OpenDevToolsWindowAsync();
    }
#elif ANDROID
    if (MyWebView.Handler?.PlatformView is Android.Webkit.WebView androidWebView)
    {
        Android.Webkit.WebView.SetWebContentsDebuggingEnabled(true);
        await Application.Current.MainPage.DisplayAlert("提示", "请在Chrome浏览器中打开chrome://inspect调试WebView", "确定");
    }
#elif IOS || MACCATALYST
    if (MyWebView.Handler?.PlatformView is WebKit.WKWebView wkWebView)
    {
        wkWebView.Configuration.Preferences.SetValueForKey(NSObject.FromObject(true), new NSString("developerExtrasEnabled"));
        await Application.Current.MainPage.DisplayAlert("提示", "请在Safari的「开发」菜单中选择对应应用调试WebView", "确定");
    }
#else
    await Application.Current.MainPage.DisplayAlert("提示", "当前平台不支持直接打开开发者工具", "确定");
#endif
}

关键注意事项 #

• 编译指令的作用：#if WINDOWS这类MAUI内置编译条件，确保非目标平台不会编译对应代码，彻底避免类型不存在等异常。
• CoreWebView2初始化检查：Windows平台必须等待CoreWebView2初始化完成后再调用开发者工具方法，否则会引发空引用异常。
• 系统权限要求：Android和iOS需要先开启设备的开发者选项，否则调试工具无法正常使用。

内容的提问来源于stack exchange，提问作者N-ate