如何在Xamarin中使用WebViewAssetLoader？离线3D查看器开发遇阻

一、WebViewAssetLoader 红线报错的核心原因 #

你遇到的红线报错，大概率是以下两个原因：

1. 缺少AndroidX.Webkit依赖：WebViewAssetLoader是AndroidX组件，Xamarin.Forms默认未包含该库，需手动安装NuGet包。
2. 命名空间或API调用不匹配：Xamarin对Android原生API的封装有细微差异，需调整代码写法。

二、完整解决方案步骤 #

1. 安装必要依赖 #

在Xamarin Android项目中，安装Xamarin.AndroidX.Webkit NuGet包，确保版本与你的Xamarin.Forms版本兼容。

2. 自定义WebViewRenderer实现 #

替换你现有代码，使用以下完整实现，注意命名空间的引用：

using Android.Content;
using Android.Webkit;
using Xamarin.Forms;
using Xamarin.Forms.Platform.Android;

[assembly: ExportRenderer(typeof(WebView), typeof(YourAppNamespace.Droid.CustomWebViewRenderer))]
namespace YourAppNamespace.Droid
{
    public class CustomWebViewRenderer : WebViewRenderer
    {
        public CustomWebViewRenderer(Context context) : base(context)
        {
        }

        protected override void OnElementChanged(ElementChangedEventArgs<WebView> e)
        {
            base.OnElementChanged(e);

            if (Control != null)
            {
                // 配置WebView支持3D网页的必要设置
                Control.Settings.JavaScriptEnabled = true;
                Control.Settings.DomStorageEnabled = true;
                Control.Settings.AllowFileAccess = false; // 符合Android 30+安全要求
                Control.SetWebViewClient(new PreviewWebViewClient(this));
            }
        }

        protected override WebViewClient GetWebViewClient()
        {
            return new PreviewWebViewClient(this);
        }

        private class PreviewWebViewClient : FormsWebViewClient
        {
            private readonly WebViewAssetLoader _assetLoader;

            public PreviewWebViewClient(WebViewRenderer renderer) : base(renderer)
            {
                _assetLoader = new WebViewAssetLoader.Builder()
                    // 映射Assets文件夹到虚拟路径/assets/
                    .AddPathHandler("/assets/", new WebViewAssetLoader.AssetsPathHandler(renderer.Context))
                    .Build();
            }

            public override WebResourceResponse ShouldInterceptRequest(Android.Webkit.WebView view, IWebResourceRequest request)
            {
                // 优先让assetloader处理请求
                var response = _assetLoader.ShouldInterceptRequest(request.Url);
                return response ?? base.ShouldInterceptRequest(view, request);
            }
        }
    }
}

3. 离线资源放置与加载 #

• 将你的3D网页所有资源（index.html、JS库、3D模型文件、样式表等）复制到Android项目的Assets文件夹中，设置每个文件的生成操作为AndroidAsset。
• 在Xamarin.Forms的WebView中，使用WebViewAssetLoader的虚拟HTTPS URL加载页面：

  var webView = new WebView();
  // 注意使用固定的虚拟域名appassets.androidplatform.net
  webView.Source = "https://appassets.androidplatform.net/assets/index.html";
  

三、关键注意事项 #

• 虚拟域名限制：必须使用appassets.androidplatform.net作为域名，这是WebViewAssetLoader官方指定的唯一合法域名，不能自定义。
• 资源路径匹配：Assets文件夹内的文件路径要与URL中的路径严格对应，比如Assets/models/abc.glb对应https://appassets.androidplatform.net/assets/models/abc.glb。
• 跨域问题解决：通过WebViewAssetLoader加载的资源会被视为HTTPS同源请求，完全规避Android 30+对file://协议的跨域限制，3D网页中的JS可以正常加载本地模型资源。

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