从Xamarin迁移的MAUI Android应用Play商店更新后启动崩溃

针对你遇到的覆盖旧版Xamarin应用后MAUI启动崩溃的问题，结合日志报错，核心原因是Xamarin与MAUI的APK拆分结构、AOT编译产物残留冲突，以下是具体解决步骤：

1. 调整APK拆分与打包配置，避免资源文件冲突 #

日志中的split_config.xxhdpi.dm找不到，是因为Xamarin和MAUI的APK资源拆分规则或文件路径不一致，覆盖安装时旧文件未被正确替换。可通过以下配置解决：

• 在MAUI项目的Platforms/Android/YourProject.csproj中添加：

  <!-- 禁用APK资源密度拆分，生成单APK（适合测试阶段快速验证） -->
  <AndroidEnableSplitApk>false</AndroidEnableSplitApk>
  <!-- 确保签名与旧版Xamarin应用完全一致，否则无法覆盖安装 -->
  <AndroidKeyStore>True</AndroidKeyStore>
  <AndroidSigningKeyStore>your-keystore.keystore</AndroidSigningKeyStore>
  <AndroidSigningKeyAlias>your-alias</AndroidSigningKeyAlias>
  <AndroidSigningKeyPass>your-pass</AndroidSigningKeyPass>
  <AndroidSigningStorePass>your-store-pass</AndroidSigningStorePass>
  

• 如果需要保留拆分APK，可添加参数强制覆盖拆分文件：

  <AndroidApkSigningAdditionalArguments>--v2-signing-enabled true --v3-signing-enabled true</AndroidApkSigningAdditionalArguments>
  

2. 强制AOT编译包含关键初始化方法 #

日志中的AOT: NOT FOUND: MyCompany.MyApp.MyAppModule:Initialize ()，是因为MAUI的AOT编译未包含该方法，或旧版Xamarin的AOT缓存残留干扰加载。解决方法：

• 在Platforms/Android/YourProject.csproj中添加AOT强制包含规则：

  <AndroidAotAdditionalArguments>--include MyCompany.MyApp.MyAppModule:Initialize()</AndroidAotAdditionalArguments>
  

• 同时禁用AOT缓存（测试阶段）：

  <AndroidUseAotCache>False</AndroidUseAotCache>
  

3. 添加启动前的旧文件清理逻辑 #

在MAUI的Android主活动中，添加代码清理旧版Xamarin可能残留的拆分文件与缓存：

using Android.App;
using Android.Content;
using Android.OS;
using Java.IO;

namespace YourProject.Platforms.Android
{
    [Activity(Theme = "@style/Maui.SplashTheme", MainLauncher = true, ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation | ConfigChanges.UiMode | ConfigChanges.ScreenLayout | ConfigChanges.SmallestScreenSize | ConfigChanges.Density)]
    public class MainActivity : MauiAppCompatActivity
    {
        protected override void OnCreate(Bundle savedInstanceState)
        {
            // 清理旧版Xamarin残留的拆分配置文件
            CleanOldSplitFiles();
            
            base.OnCreate(savedInstanceState);
        }

        private void CleanOldSplitFiles()
        {
            try
            {
                var appContext = Application.Context;
                // 获取应用私有目录下的拆分文件路径
                var splitDir = new File(appContext.FilesDir.Parent, "split_libs");
                if (splitDir.Exists())
                {
                    var oldSplitFiles = splitDir.ListFiles(f => f.Name.Contains("split_config") && f.Name.EndsWith(".dm"));
                    foreach (var file in oldSplitFiles)
                    {
                        file.Delete();
                    }
                }
            }
            catch (Exception ex)
            {
                // 记录日志，避免清理失败导致启动崩溃
                Android.Util.Log.Error("MAUI_CLEANUP", $"Failed to clean old split files: {ex.Message}");
            }
        }
    }
}

4. 正确复现覆盖安装场景 #

因为Visual Studio会自动替换旧应用，可手动用ADB命令测试：

1. 先安装旧版Xamarin应用的APK：adb install path/to/xamarin-app.apk
2. 再覆盖安装MAUI应用：adb install -r path/to/maui-app.apk
   这样就能复现用户遇到的崩溃场景，方便调试验证修复效果。

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