解决.NET for Android项目中GUID不匹配导致的运行时崩溃问题

问题背景

在.NET for Android开发过程中，开发者可能会遇到一个棘手的运行时崩溃问题，具体表现为应用在发布模式下构建、发布并通过Google Play分发后，在设备上启动时立即崩溃。错误日志中会显示类似"GUID of dependent assembly doesn't match"的信息，指出某个依赖程序集的GUID与预期值不符。

错误现象分析

当应用在调试模式下运行时一切正常，但在发布模式下构建并分发后，启动时会抛出以下关键错误：

GUID of dependent assembly Uno.Extensions.Core.UI doesn't match (expected '732886D9-4107-41EE-B6D2-773A968BC80A', got 'FCC3028D-42D5-4106-92DC-193CFF86F24A')

这种GUID不匹配的问题通常表明在构建过程中，某些程序集版本出现了不一致的情况。在.NET生态系统中，GUID(全局唯一标识符)用于确保程序集引用的正确性，当运行时检测到实际加载的程序集GUID与编译时预期的GUID不一致时，就会抛出此类错误。

问题根源

经过深入排查，发现问题源于项目中的条件编译设置。开发者为了修复Windows平台上WebView2控件的问题，在项目文件中添加了无条件平台目标设置：

<PropertyGroup>
    <PlatformTarget Condition=" '$(PlatformTarget)' == '' AND $(Platform) == 'AnyCPU' AND '$(NETCoreSdkRuntimeIdentifier)' == 'win-x86'">x86</PlatformTarget>
    <PlatformTarget Condition=" '$(PlatformTarget)' == '' AND $(Platform) == 'AnyCPU' AND '$(NETCoreSdkRuntimeIdentifier)' == 'win-x64'">x64</PlatformTarget>
    <PlatformTarget Condition=" '$(PlatformTarget)' == '' AND $(Platform) == 'AnyCPU' AND '$(NETCoreSdkRuntimeIdentifier)' == 'win-arm64'">arm64</PlatformTarget>
</PropertyGroup>

这些无条件设置影响了所有目标平台的构建过程，包括Android平台，导致在发布构建时生成了不一致的程序集标识。

解决方案

解决此问题的关键在于为平台目标设置添加适当的条件限制，确保它们只应用于特定的目标框架。修改后的配置如下：

<PropertyGroup Condition="'$(TargetFramework)' == 'net9.0-windows10.0.26100'">
    <PlatformTarget Condition=" '$(PlatformTarget)' == '' AND $(Platform) == 'AnyCPU' AND '$(NETCoreSdkRuntimeIdentifier)' == 'win-x86'">x86</PlatformTarget>
    <PlatformTarget Condition=" '$(PlatformTarget)' == '' AND $(Platform) == 'AnyCPU' AND '$(NETCoreSdkRuntimeIdentifier)' == 'win-x64'">x64</PlatformTarget>
    <PlatformTarget Condition=" '$(PlatformTarget)' == '' AND $(Platform) == 'AnyCPU' AND '$(NETCoreSdkRuntimeIdentifier)' == 'win-arm64'">arm64</PlatformTarget>
</PropertyGroup>

通过添加Condition="'$(TargetFramework)' == 'net9.0-windows10.0.26100'"，我们确保了这些平台目标设置仅适用于Windows特定的目标框架，而不会影响Android、WebAssembly或Mac Catalyst等其他平台的构建过程。

经验总结

1. 条件编译的重要性：在多平台项目中，必须谨慎处理条件编译和平台特定设置，确保它们不会意外影响其他目标平台。

2. 发布模式与调试模式的差异：某些问题可能只在发布模式下显现，因为发布构建会进行更多的优化和代码生成操作。

3. GUID一致性的意义：程序集GUID是.NET确保类型安全的重要机制，任何不匹配都可能导致严重的运行时问题。

4. 构建日志分析：当遇到此类问题时，完整的构建日志（特别是从干净状态开始的发布构建）对于诊断问题至关重要。

5. 多平台开发的复杂性：在支持多个平台的解决方案中，任何全局性的修改都需要考虑对所有目标平台的影响。

通过这次问题的解决，我们再次认识到在复杂的多平台.NET开发环境中，精确控制构建条件的重要性。合理的条件限制可以避免许多潜在的跨平台兼容性问题，确保应用在各个目标平台上都能正确构建和运行。