.NET 8 MAUI Blazor Hybrid（Android/Windows）单元测试框架选型咨询

针对你遇到的nUnit/xUnit无法直接适配多目标项目的问题，分享几个实际项目中验证有效的方案：

1. 让测试项目匹配主项目的多目标配置 #

纯.NET 8测试项目引用多目标主项目时，会因为找不到对应平台的编译输出报错，最直接的解决方式是修改测试项目的.csproj，让它和主项目保持一致的目标框架：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <!-- 替换成你主项目的目标框架，比如Android和Windows版本 -->
    <TargetFrameworks>net8.0-android;net8.0-windows10.0.19041.0</TargetFrameworks>
    <UseMaui>false</UseMaui> <!-- 不需要完整MAUI SDK，减少冗余 -->
    <IsTestProject>true</IsTestProject>
  </PropertyGroup>

  <ItemGroup>
    <!-- 选择你用的测试框架包，版本匹配.NET 8 -->
    <PackageReference Include="xunit" Version="2.6.6" />
    <PackageReference Include="xunit.runner.visualstudio" Version="2.5.5" PrivateAssets="all" />
    <!-- 如果用nUnit，替换成对应的包 -->
    <!-- <PackageReference Include="nunit" Version="3.13.3" /> -->
    <!-- <PackageReference Include="NUnit3TestAdapter" Version="4.5.0" /> -->
  </ItemGroup>

  <!-- 引用你的MAUI Blazor主项目 -->
  <ItemGroup>
    <ProjectReference Include="..\YourMauiApp\YourMauiApp.csproj" />
  </ItemGroup>
</Project>

修改后，测试项目会针对每个目标框架生成对应的测试程序集，运行测试时在Visual Studio的测试资源管理器里选择对应的平台即可（比如选择net8.0-android运行Android相关测试）。

2. 用条件编译隔离平台专属测试 #

如果主项目里有Android/Windows专属代码，你可以在测试项目里用平台编译指令编写针对性测试，避免跨平台冲突：

#if ANDROID
public class AndroidFeatureTests
{
    [Fact]
    public void Android_Specific_Function_Works()
    {
        // 直接测试Android专属类或方法
        var androidHelper = new YourMauiApp.Droid.AndroidHelper();
        Assert.True(androidHelper.DoAndroidSpecificTask());
    }
}
#endif

#if WINDOWS
public class WindowsFeatureTests
{
    [Fact]
    public void Windows_Specific_Function_Works()
    {
        var windowsHelper = new YourMauiApp.Windows.WindowsHelper();
        Assert.Equal("Windows Result", windowsHelper.GetWindowsData());
    }
}
#endif

3. 抽象平台逻辑，解耦核心代码测试 #

这是更优的长期方案：把平台专属逻辑抽象成接口，核心业务只依赖接口，这样核心代码可以用纯.NET 8测试项目单独测试，不用关心平台实现。

步骤示例： #

1. 在主项目里定义平台接口：

namespace YourMauiApp.Services
{
    public interface IPlatformProvider
    {
        string GetCurrentPlatform();
        bool IsPlatformFeatureAvailable();
    }
}

2. 针对不同平台实现接口：

// Android平台实现
#if ANDROID
namespace YourMauiApp.Droid.Services
{
    public class AndroidPlatformProvider : IPlatformProvider
    {
        public string GetCurrentPlatform() => "Android";
        public bool IsPlatformFeatureAvailable() => true;
    }
}
#endif

// Windows平台实现
#if WINDOWS
namespace YourMauiApp.Windows.Services
{
    public class WindowsPlatformProvider : IPlatformProvider
    {
        public string GetCurrentPlatform() => "Windows";
        public bool IsPlatformFeatureAvailable() => true;
    }
}
#endif

3. 在MauiProgram中注册对应平台的实现：

builder.Services.AddSingleton<IPlatformProvider>(sp =>
{
#if ANDROID
    return new AndroidPlatformProvider();
#elif WINDOWS
    return new WindowsPlatformProvider();
#else
    throw new NotImplementedException("Unsupported platform");
#endif
});

4. 核心业务类依赖接口：

namespace YourMauiApp.Business
{
    public class CoreService
    {
        private readonly IPlatformProvider _platformProvider;

        public CoreService(IPlatformProvider platformProvider)
        {
            _platformProvider = platformProvider;
        }

        public string GetWelcomeMessage()
        {
            return $"Welcome to {_platformProvider.GetCurrentPlatform()}!";
        }
    }
}

5. 用纯.NET 8测试项目测试核心业务（用Mock框架如Moq）：

public class CoreServiceTests
{
    [Fact]
    public void GetWelcomeMessage_Returns_Correct_Text()
    {
        // Mock平台接口
        var mockPlatform = new Mock<IPlatformProvider>();
        mockPlatform.Setup(p => p.GetCurrentPlatform()).Returns("TestPlatform");

        var coreService = new CoreService(mockPlatform.Object);
        var message = coreService.GetWelcomeMessage();

        Assert.Equal("Welcome to TestPlatform!", message);
    }
}

这种方式既能保证核心代码的测试覆盖率，又能避免多目标项目的测试冲突，是大型项目的推荐做法。

4. 注意事项 #

• 避免在测试项目中直接引用平台专属NuGet包（比如AndroidX、Windows SDK相关），除非确实需要测试平台原生功能。
• 运行测试时，确保选择正确的目标框架，比如在Visual Studio测试资源管理器的"架构"下拉菜单中选择对应平台。
• 如果使用Visual Studio的"运行所有测试"功能，会自动遍历所有目标框架执行测试，注意排查单平台的测试失败。

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