如何在MAUI WebView中设置allowSingleSignOnUsingOSPrimaryAccount属性？

MAUI的WebView抽象层并未直接暴露allowSingleSignOnUsingOSPrimaryAccount属性，但Windows平台底层基于WebView2，可通过自定义Handler或直接访问底层控件来配置该选项，具体实现如下：

Windows平台实现步骤 #

方法1：全局注册自定义WebView Handler #

在MauiProgram.cs中配置全局Handler，对所有WebView生效：

using Microsoft.Maui.Handlers;
using Microsoft.UI.Xaml.Controls;
using Microsoft.Web.WebView2.Core;

namespace YourAppNamespace;

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .ConfigureFonts(fonts =>
            {
                fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
            });

#if WINDOWS
        // 注册自定义WebView Handler
        builder.ConfigureMauiHandlers(handlers =>
        {
            handlers.AddHandler<WebView, CustomWebViewHandler>();
        });
#endif

        return builder.Build();
    }
}

// 自定义WebView Handler类
public class CustomWebViewHandler : WebViewHandler
{
    protected override void ConnectHandler(WebView2 platformView)
    {
        base.ConnectHandler(platformView);

        // 配置CoreWebView2环境选项
        var envOptions = new CoreWebView2EnvironmentOptions
        {
            AllowSingleSignOnUsingOSPrimaryAccount = true
        };

        // 初始化WebView2环境
        _ = platformView.EnsureCoreWebView2Async(null, envOptions);
    }
}

方法2：针对单个WebView控件配置 #

如果仅需对特定WebView生效，可在页面的代码后台（如MainPage.xaml.cs）中处理：

using Microsoft.UI.Xaml.Controls;
using Microsoft.Web.WebView2.Core;

namespace YourAppNamespace;

public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
        Loaded += MainPage_Loaded;
    }

    private async void MainPage_Loaded(object sender, EventArgs e)
    {
#if WINDOWS
        var webView2 = MyWebView.Handler.PlatformView as WebView2;
        if (webView2 != null && webView2.CoreWebView2 == null)
        {
            var envOptions = new CoreWebView2EnvironmentOptions
            {
                AllowSingleSignOnUsingOSPrimaryAccount = true
            };
            await webView2.EnsureCoreWebView2Async(null, envOptions);
            // 之后加载目标网址
            webView2.Source = new Uri("https://your-website-url.com");
        }
#endif
    }
}

关键注意事项 #

• 该配置仅适用于Windows平台，Android/iOS的WebView底层实现不同，需分别处理对应平台的Device ID传递逻辑。
• 确保项目已安装兼容的Microsoft.Web.WebView2 NuGet包，版本需匹配MAUI的Windows目标框架版本。
• 必须在WebView加载网页前完成CoreWebView2环境初始化，否则配置不会生效。

内容的提问来源于stack exchange，提问作者Sanket