Xamarin Android升级至13.0后Release模式下R8构建报错

问题详情 #

将Xamarin Android项目从SDK 12.0升级至13.0后，Release模式构建时出现以下错误：

• 重复出现50次：R8 : Validation error : A type variable is not in scope.
• 构建进程最终失败：The process '/Library/Frameworks/Mono.framework/Versions/6_12_24/bin/msbuild' exited with code 1.

移除R8后项目可正常构建，但希望保留R8优化，寻求解决办法。

项目相关配置 #

Manifest文件配置 #

<AndroidDexTool>d8</AndroidDexTool>
<AndroidLinkTool>r8</AndroidLinkTool>
<AndroidLinkMode>Full</AndroidLinkMode>

Release模式配置 #

<PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
<DebugSymbols>false</DebugSymbols>
<DebugType>portable</DebugType>
<Optimize>true</Optimize>
<OutputPath>bin\Release</OutputPath>
<ErrorReport>prompt</ErrorReport>
<WarningLevel>4</WarningLevel>
<AndroidManagedSymbols>true</AndroidManagedSymbols>
<AndroidUseSharedRuntime>false</AndroidUseSharedRuntime>
<EmbedAssembliesIntoApk>true</EmbedAssembliesIntoApk>
<AotAssemblies>true</AotAssemblies>
<EnableLLVM>true</EnableLLVM>
<AndroidEnableSGenConcurrent>true</AndroidEnableSGenConcurrent>
<JavaMaximumHeapSize>2G</JavaMaximumHeapSize>
<AndroidDexTool>d8</AndroidDexTool>
<AndroidPackageFormat>apk</AndroidPackageFormat>
<AndroidCreatePackagePerAbi>false</AndroidCreatePackagePerAbi>
<AndroidEnableProfiledAot>false</AndroidEnableProfiledAot>
<AndroidLinkMode>Full</AndroidLinkMode>
</PropertyGroup>

解决建议 #

• 升级Mono和Xamarin Android版本：当前使用的Mono版本6_12_24较旧，可能与Android 13.0的R8工具存在兼容性问题，升级至最新稳定版本。
• 调整R8链接规则：
  • 暂时将<AndroidLinkMode>从Full改为SdkOnly，排查是否是全量链接导致的类型变量丢失问题；
  • 添加ProGuard/R8保留规则，针对报错相关的类或类型变量，在项目的proguard.cfg中添加类似规则：-keep class [你的包名].** { *; }（替换为实际出现问题的类路径）。
• 禁用AOT/LLVM优化：当前配置中开启了<AotAssemblies>true</AotAssemblies>和<EnableLLVM>true</EnableLLVM>，这两项优化可能与R8冲突，先关闭这两个选项尝试构建，若成功再逐步开启排查具体冲突点。
• 清理构建缓存：删除项目的bin、obj文件夹，清理NuGet本地缓存后重新构建，避免旧缓存文件干扰。
• 升级第三方依赖：检查项目中所有第三方NuGet包，确保其支持Android 13.0版本，老旧依赖可能存在未兼容的语法或结构导致R8校验失败。

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