Xamarin.Forms iOS：如何手动为WKWebViewRenderer设置Cookie

1. 先做自定义Forms WebView控件 #

在共享项目里定义带Cookie绑定属性的WebView，方便从ViewModel传值：

using Xamarin.Forms;

namespace YourAppName
{
    public class AuthenticatedWebView : WebView
    {
        public static readonly BindableProperty CookiesProperty =
            BindableProperty.Create(nameof(Cookies), typeof(string), typeof(AuthenticatedWebView), null);

        public string Cookies
        {
            get => (string)GetValue(CookiesProperty);
            set => SetValue(CookiesProperty, value);
        }
    }
}

2. iOS端写自定义WKWebViewRenderer #

在iOS项目里实现渲染器，核心是把Cookie写入WKWebView的Cookie存储，步骤如下：

using Foundation;
using WebKit;
using Xamarin.Forms;
using Xamarin.Forms.Platform.iOS;
using YourAppName;
using YourAppName.iOS.Renderers;

[assembly: ExportRenderer(typeof(AuthenticatedWebView), typeof(AuthenticatedWebViewRenderer))]
namespace YourAppName.iOS.Renderers
{
    public class AuthenticatedWebViewRenderer : WebViewRenderer
    {
        protected override void OnElementChanged(VisualElementChangedEventArgs e)
        {
            base.OnElementChanged(e);

            if (e.NewElement is AuthenticatedWebView authWebView && Control is WKWebView wkWebView)
            {
                // 监听Cookie属性变化
                authWebView.PropertyChanged += AuthWebView_PropertyChanged;
                // 初始加载时设置Cookie
                SetCookies(authWebView.Cookies, wkWebView, authWebView.Source);
            }
        }

        private void AuthWebView_PropertyChanged(object sender, System.ComponentModel.PropertyChangedEventArgs e)
        {
            if (e.PropertyName == AuthenticatedWebView.CookiesProperty.PropertyName && 
                sender is AuthenticatedWebView authWebView && 
                Control is WKWebView wkWebView)
            {
                SetCookies(authWebView.Cookies, wkWebView, authWebView.Source);
            }
        }

        private void SetCookies(string cookiesString, WKWebView wkWebView, WebViewSource source)
        {
            if (string.IsNullOrEmpty(cookiesString) || source == null) return;

            var targetUrl = GetTargetUrl(source);
            if (targetUrl == null) return;

            // 解析Cookie字符串（格式参考："token=abc123; domain=.yourdomain.com; path=/"）
            var cookieSegments = cookiesString.Split(';');
            foreach (var segment in cookieSegments)
            {
                var keyValuePair = segment.Trim().Split('=');
                if (keyValuePair.Length != 2) continue;

                // 构造NSHttpCookie，按需调整过期时间、SameSite等参数
                var cookie = new NSHttpCookie(
                    keyValuePair[0],
                    keyValuePair[1],
                    "/",
                    targetUrl.Host,
                    null,
                    NSDate.Now,
                    NSDate.Now.AddSeconds(86400), // 24小时过期
                    false,
                    false,
                    NSHttpCookieSameSitePolicy.None);

                // 异步写入Cookie
                wkWebView.Configuration.WebsiteDataStore.HttpCookieStore.SetCookie(cookie, error =>
                {
                    if (error != null)
                    {
                        System.Diagnostics.Debug.WriteLine($"Cookie设置失败：{error.LocalizedDescription}");
                    }
                    else
                    {
                        // Cookie写入成功后重新加载页面
                        if (source is UrlWebViewSource urlSource)
                        {
                            wkWebView.LoadRequest(new NSUrlRequest(new NSUrl(urlSource.Url)));
                        }
                    }
                });
            }
        }

        private NSUrl GetTargetUrl(WebViewSource source)
        {
            if (source is UrlWebViewSource urlSource && !string.IsNullOrEmpty(urlSource.Url))
            {
                return new NSUrl(urlSource.Url);
            }
            // 如果是本地HTML，要传BaseUrl，这里按需扩展
            else if (source is HtmlWebViewSource htmlSource && !string.IsNullOrEmpty(htmlSource.BaseUrl))
            {
                return new NSUrl(htmlSource.BaseUrl);
            }
            return null;
        }
    }
}

3. 关键注意点 #

• Cookie格式要标准：ViewModel传的Cookies字符串要包含必要属性（比如domain、path），如果后端返回的Cookie已经带这些参数，直接拆分使用即可，不用手动指定。
• 异步处理Cookie写入：WKHTTPCookieStore的SetCookie是异步操作，必须在回调里触发页面加载，否则Cookie可能还没生效就加载页面了。
• ATS配置：确保iOS项目Info.plist里的NSAppTransportSecurity允许访问目标域名，不然会被拦截。
• 版本兼容：WKHTTPCookieStore只支持iOS 11及以上，要是兼容更低版本，得改用旧的NSHTTPCookieStorage方式，但现在大部分项目都不用兼容iOS 11以下了。

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