Xamarin Android WebView横竖屏不重载发布版黑屏问题求助

1. 解决Release模式白屏问题（核心：混淆规则排除） #

Release模式下的白屏，基本是ProGuard/R8混淆工具把WebView相关核心类混淆了，导致Activity横竖屏不重建时WebView无法正常恢复状态。

操作步骤：

• 在Android项目根目录新建proguard.cfg文件，设置其生成操作为ProGuardConfiguration
• 写入以下混淆排除规则：

  # 保留WebView所有相关类与方法
  -keep class android.webkit.** { *; }
  -keepclassmembers class * extends android.webkit.WebChromeClient {
      public void openFileChooser(...);
  }
  -keepclassmembers class * extends android.webkit.WebViewClient {
      public void onPageFinished(android.webkit.WebView, java.lang.String);
      public void onReceivedError(...);
  }
  # 保留WebView状态存储相关类
  -keep class android.webkit.WebViewDatabase { *; }
  -keep class android.webkit.WebBackForwardList { *; }
  

• 打开项目属性→Android Options，在Release模式下勾选Enable ProGuard（R8兼容该规则，无需额外修改）

2. 手动处理WebView状态保存与恢复 #

仅靠ConfigurationChanges配置不足以完全保留页面状态，需手动实现状态的保存与恢复逻辑：

protected override void OnCreate(Bundle savedInstanceState)
{
    base.OnCreate(savedInstanceState);
    SetContentView(Resource.Layout.Main);

    webView = FindViewById<WebView>(Resource.Id.webView);
    // 开启必要设置，确保页面状态可被保存
    webView.Settings.JavaScriptEnabled = true;
    webView.Settings.DomStorageEnabled = true;
    webView.Settings.DatabaseEnabled = true;

    // 恢复之前保存的WebView状态
    if (savedInstanceState != null)
    {
        webView.RestoreState(savedInstanceState);
    }
    else
    {
        // 首次启动加载初始URL
        webView.LoadUrl("你的首页URL");
    }
}

protected override void OnSaveInstanceState(Bundle outState)
{
    base.OnSaveInstanceState(outState);
    // 保存WebView当前页面状态
    webView.SaveState(outState);
}

3. 完善Activity的ConfigurationChanges配置 #

针对Android 11+设备（Galaxy Note20搭载Android 11/12），补充额外配置参数，避免系统触发Activity重建：

[Activity(Label = "@string/app_name", 
          Theme = "@style/AppTheme", 
          ConfigurationChanges = Android.Content.PM.ConfigChanges.Orientation | 
                                Android.Content.PM.ConfigChanges.ScreenSize | 
                                Android.Content.PM.ConfigChanges.ScreenLayout | 
                                Android.Content.PM.ConfigChanges.SmallestScreenSize)]

4. 验证Release打包配置 #

确保Release模式下的WebView设置与调试模式完全一致，尤其不要禁用DomStorageEnabled——这是WebView保存页面会话状态的关键，禁用后即使恢复状态也会回到首页。

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