.NET MAUI安卓APK安装后启动崩溃，已按官方文档配置签名

核心问题定位 #

从你提供的信息来看，已签名APK能安装但启动就崩溃，再结合assemblies文件夹里只有rc.BIN文件（正常情况下该目录应该包含完整的.NET程序集），大概率是程序集被错误裁剪或者打包过程中程序集未正确嵌入APK导致的。

针对性排查修复步骤 #

1. 检查裁剪配置 #

打开项目的.csproj文件，排查过度裁剪相关配置：

• 如果开启了代码裁剪，要添加关键程序集的保留规则，避免核心组件被误删：

<PropertyGroup>
  <PublishTrimmed>true</PublishTrimmed>
  <TrimmerRootAssembly>Microsoft.Maui.Controls</TrimmerRootAssembly>
  <TrimmerRootAssembly>Microsoft.Maui.Essentials</TrimmerRootAssembly>
</PropertyGroup>

• 要是不需要裁剪功能，直接设置<PublishTrimmed>false</PublishTrimmed>，彻底避免裁剪引发的问题。

2. 验证Keystore配置正确性 #

确认.csproj里的签名配置没有语法错误，路径和密码要和实际生成的keystore完全匹配：

<PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|Android' ">
  <AndroidKeyStore>True</AndroidKeyStore>
  <AndroidSigningKeyStore>your-keystore-file.keystore</AndroidSigningKeyStore>
  <AndroidSigningStorePassword>your-store-password</AndroidSigningStorePassword>
  <AndroidSigningKeyAlias>your-key-alias</AndroidSigningKeyAlias>
  <AndroidSigningKeyPassword>your-key-password</AndroidSigningKeyPassword>
</PropertyGroup>

3. 调整打包命令参数 #

使用dotnet publish时，明确指定架构和配置，避免自动裁剪异常：

dotnet publish -f net7.0-android -c Release /p:AndroidSdkDirectory="你的安卓SDK路径" /p:AndroidSigningKeyStore="keystore路径" /p:AndroidSigningStorePassword="密码" /p:AndroidSigningKeyAlias="别名" /p:AndroidSigningKeyPassword="密码"

测试阶段也可以尝试生成单架构APK（比如加参数/p:AndroidSupportedAbis=armeabi-v7a），排除多架构打包的兼容性问题。

4. 抓取详细崩溃日志 #

通过ADB获取设备端的崩溃详情，精准定位报错点：

adb logcat *:E

从你提供的日志截图来看，崩溃根源是程序集加载失败，结合assemblies文件夹的异常情况，重点排查打包过程中程序集是否被正确嵌入APK。

5. 修复assemblies文件夹异常 #

先清理项目的bin/obj目录，再重新构建：

dotnet clean
dotnet restore
dotnet publish -c Release -f net7.0-android

如果清理后assemblies文件夹还是只有rc.BIN，检查.NET MAUI workload版本是否和项目目标框架匹配：

dotnet workload list

要是版本不一致，重新安装对应版本的workload：

dotnet workload install maui-android --version 7.0.0（替换为你的项目目标版本）

额外注意事项 #

• 确保测试设备的系统版本符合.NET MAUI最低要求（安卓7.0及以上），避免老旧设备的兼容性问题。
• 可以先尝试Debug模式打包（需要开启设备调试权限），看Debug版是否能正常启动，缩小问题排查范围。

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