发布MAUI Android应用时遭遇AOT预编译错误求助

问题背景 #

首次发布MAUI Android应用，按官方流程执行发布命令后，AOT编译阶段失败。开发模式下应用运行正常，多次清理bin/obj目录、重新构建无效。

执行的发布命令 #

dotnet publish -f net6.0-android -c Release -p:AndroidKeyStore=true -p:AndroidSigningKeyStore=myapp.keystore -p:AndroidSigningKeyAlias=myapp -p:AndroidSigningKeyPass=mypassword -p:AndroidSigningStorePass=mypassword

错误日志关键片段 #

C:\Program Files\dotnet\packs\Microsoft.Android.Sdk.Windows\32.0.485\targets\Microsoft.Android.Sdk.Aot.targets(91,5): 错误: 预编译C:\Users\User\Desktop\ODWE Mob\ODWEMob\ODWEMob\obj\Release\net6.0-android\android-arm\linked\Microsoft.AspNetCore.Connections.Abstractions.dll失败。
C:\Program Files\dotnet\packs\Microsoft.Android.Sdk.Windows\32.0.485\targets\Microsoft.Android.Sdk.Aot.targets(91,5): 错误: 使用配置数据文件'C:\Users\User\Desktop\ODWE Mob\ODWEMob\ODWEMob\Resources\Splash\splash.svg'
C:\Program Files\dotnet\packs\Microsoft.Android.Sdk.Windows\32.0.485\targets\Microsoft.Android.Sdk.Aot.targets(91,5): 错误: 配置文件头错误: '<?xml vers'。

涉及的SVG文件内容 #

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
<svg width="456" height="456" viewBox="0 0 456 456" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;">
    <path d="m 105.50037,281.60863 c -2.70293,0 -5.00091,-0.90042 -6.893127,-2.70209 -1.892214,-1.84778 -2.837901,-4.04181 -2.837901,-6.58209 0,-2.58722 0.945687,-4.80389 2.837901,-6.65167 1.892217,-1.84778 4.190197,-2.77167 6.893127,-2.77167 2.74819,0 5.06798,0.92389 6.96019,2.77167 1.93749,1.84778 2.90581,4.06445 2.90581,6.65167 0,2.54028 -0.96832,4.73431 -2.90581,6.58209 -1.89221,1.80167 -4.212,2.70209 -6.96019,2.70209 z" style="fill:#ffffff;fill-rule:nonzero;stroke-width:0.838376" />
    <path d="M 213.56111,280.08446 H 195.99044 L 149.69953,207.0544 c -1.17121,-1.84778 -2.14037,-3.76515 -2.90581,-5.75126 h -0.40578 c 0.36051,2.12528 0.54076,6.67515 0.54076,13.6496 v 65.13172 h -15.54349 v -99.36009 h 18.71925 l 44.7374,71.29798 c 1.89222,2.95695 3.1087,4.98917 3.64945,6.09751 h 0.26996 c -0.45021,-2.6325 -0.67573,-7.09015 -0.67573,-13.37293 v -64.02256 h 15.47557 z" style="fill:#ffffff;fill-rule:nonzero;stroke-width:0.838376" />
    <path d="m 289.25134,280.08446 h -54.40052 v -99.36009 h 52.23835 v 13.99669 h -36.15411 v 28.13085 h 33.31621 v 13.9271 h -33.31621 v 29.37835 h 38.31628 z" style="fill:#ffffff;fill-rule:nonzero;stroke-width:0.838376" />
    <path d="M 366.56466,194.72106 H 338.7222 v 85.3634 h -16.08423 v -85.3634 h -27.77455 v -13.99669 h 71.70124 z" style="fill:#ffffff;fill-rule:nonzero;stroke-width:0.838376" />
</svg>

解决方案 #

1. 修复项目中AOT配置的错误引用 #

打开项目的.csproj文件，查找是否存在错误将SVG路径添加到AndroidAotProfile属性的配置。MAUI的AOT配置仅支持.aotprofile格式文件，需移除错误的SVG引用：

• 错误配置示例：

  <PropertyGroup>
    <AndroidAotProfile>Resources/Splash/splash.svg</AndroidAotProfile>
  </PropertyGroup>
  

• 修正后：保留官方默认的.aotprofile引用，或直接移除该属性（若未自定义AOT配置）。

2. 确认SVG文件的构建操作 #

在Visual Studio中右键点击splash.svg → 属性：

• 确保生成操作设置为MauiSplashScreen
• 确保复制到输出目录设置为不复制或如果较新则复制

3. 临时禁用AOT编译（应急方案） #

若暂时无法定位配置问题，可通过发布参数禁用AOT，先完成发布测试：

dotnet publish -f net6.0-android -c Release -p:AndroidKeyStore=true -p:AndroidSigningKeyStore=myapp.keystore -p:AndroidSigningKeyAlias=myapp -p:AndroidSigningKeyPass=mypassword -p:AndroidSigningStorePass=mypassword -p:AndroidEnableProfiledAot=false

注意：禁用AOT会降低应用启动速度，正式发布前建议修复根本问题。

4. 彻底清理并重新构建 #

执行以下命令清理项目缓存后重新发布：

dotnet clean
dotnet restore
dotnet publish -f net6.0-android -c Release -p:AndroidKeyStore=true -p:AndroidSigningKeyStore=myapp.keystore -p:AndroidSigningKeyAlias=myapp -p:AndroidSigningKeyPass=mypassword -p:AndroidSigningStorePass=mypassword

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