.NET MAUI发布版APK部署崩溃，调试版正常问题求助

可能的原因及修复方案 #

1. 调整发布版链接器配置 #

发布版默认启用的链接器优化可能误删了必要的程序集：

• 打开项目属性 → Android选项 → 发布 → 链接器行为
• 先将链接器行为改为不链接测试，若能正常运行，再逐步调整为SDK程序集仅，同时添加程序集保留规则：
  在项目的Properties/AssemblyInfo.cs中添加：

  [assembly: Android.Runtime.Preserve(typeof(MyApp), AllMembers = true)]
  

  或者在AndroidManifest.xml里配置豁免：

  <application ...>
    <meta-data android:name="android.runtime.mono.assembly" android:value="MyApp.dll" />
  </application>
  

2. 验证APK是否包含目标DLL #

• 将发布的APK后缀改为.zip，解压后检查assemblies文件夹下是否存在MyApp.dll
• 若不存在，检查项目文件（.csproj）是否有错误的排除配置，比如：
  确保相关引用的PrivateAssets设置为None：

  <ItemGroup>
    <ProjectReference Include="..\MyApp\MyApp.csproj">
      <PrivateAssets>None</PrivateAssets>
    </ProjectReference>
  </ItemGroup>
  

3. 检查签名与打包完整性 #

• 重新生成签名密钥测试，或临时用调试签名打包发布版排查是否是签名过程损坏了APK
• 确保发布时勾选对齐APK选项，避免打包时文件损坏

4. 清理缓存重新构建 #

• 执行生成→清理解决方案，删除项目的bin和obj文件夹
• 重新生成发布版APK，避免缓存导致的打包异常

5. 排查.NET 7与API 33兼容性 #

• 安装Visual Studio中最新的.NET 7 Android SDK更新（通过工具→获取工具和功能检查）
• 尝试将Android目标框架降级到API 32测试，确认是否是API 33的特定问题

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