WindowsAppSDK项目中WebView2Loader.dll架构不匹配问题解析

问题背景

在WindowsAppSDK项目开发过程中，当开发者在x64架构机器上创建包含x64和ARM64架构的商店上传包时，发现ARM64版本的msix包中错误地包含了x64架构的WebView2Loader.dll和Microsoft.Web.WebView2.Core.dll文件，而非预期的aarch64版本。这一问题直接影响了应用在ARM64设备上的正常运行。

技术分析

该问题源于WindowsAppSDK打包过程中的架构识别机制缺陷。在跨架构打包场景下，系统未能正确识别并选择对应架构的WebView2相关组件。具体表现为：

1. WebView2Loader.dll被错误地打包为x64版本而非ARM64版本
2. Microsoft.Web.WebView2.Core.dll同样存在架构不匹配问题

影响范围

此问题主要影响以下场景：

• 使用WindowsAppSDK进行多架构打包的开发项目
• 特别针对需要同时支持x64和ARM64架构的应用
• 依赖WebView2组件或间接引用WebView2的项目

解决方案

微软已在WebView2 SDK 1.0.2903.40版本中修复了此问题。开发者可通过以下方式解决：

方案一：升级WebView2 SDK

1. 在Visual Studio中打开NuGet包管理器
2. 将Microsoft.Web.WebView2包升级至最新版本
3. 确保项目文件中正确引用了新版本的WebView2组件

方案二：手动修复（临时方案）

对于暂时无法升级的项目，可添加以下构建目标到项目文件中：

<Target Name="FixWebView2Path" BeforeTargets="PrepareForBuild" Condition="'$(PlatformTarget)'=='arm64'">
  <ItemGroup>
    <Content Remove="@(Content)" Condition="'%(Content.Link)'=='runtimes\win-x64\native\WebView2Loader.dll'"/>
    <Content Include="$(NugetRoot)runtimes\win-arm64\native\WebView2Loader.dll">
      <Link>runtimes\win-arm64\native\WebView2Loader.dll</Link>
      <PublishState>Included</PublishState>
      <Visible>False</Visible>
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
      <IncludeInVsix>true</IncludeInVsix>
      <Pack>false</Pack>
    </Content>
    <ReferenceCopyLocalPaths Remove="@(ReferenceCopyLocalPaths)" Condition="'%(FileName)%(Extension)'=='Microsoft.Web.WebView2.Core.dll'"/>
    <ReferenceCopyLocalPaths Include="$(NugetRoot)runtimes\win-arm64\native_uap\Microsoft.Web.WebView2.Core.dll"/>
  </ItemGroup>
</Target>

最佳实践建议

1. 定期检查项目依赖项的架构匹配情况
2. 在多架构项目中，为每个目标平台单独验证组件版本
3. 考虑将WebView2作为显式依赖项管理，而非仅通过WindowsAppSDK间接引用
4. 建立自动化构建验证流程，确保各架构包中组件的正确性

总结

WindowsAppSDK中的这一架构匹配问题提醒开发者在跨平台开发时需要特别注意组件版本和架构的兼容性。通过及时更新依赖项或应用适当的修复方案，可以确保应用在各种架构设备上的稳定运行。随着WindowsAppSDK 1.6版本后WebView2包的解耦，开发者现在可以更灵活地管理WebView2依赖关系，建议充分利用这一特性来优化项目结构。