MAUI项目引用.NET共享类库时部分文件编译失败问题咨询

可能的原因 #

• 共享类库目标框架与MAUI项目不兼容：若共享类库仅针对net8.0，但MAUI项目的部分目标平台未正确关联该引用
• MAUI项目文件中Helpers文件夹的编译配置异常：该文件夹可能被条件编译规则排除，或未被纳入所有目标框架的编译范围
• 项目引用存在平台限制：虽已添加共享类库引用，但可能仅针对特定平台生效（如仅Android）

排查与解决步骤 #

1. 检查共享类库的目标框架配置 #

打开共享类库的.csproj文件，确认目标框架设置兼容MAUI项目：

<PropertyGroup>
  <!-- 推荐设置为net8.0，适配MAUI多目标项目 -->
  <TargetFramework>net8.0</TargetFramework>
  <!-- 若需针对特定平台优化，可设置多目标：
  <TargetFrameworks>net8.0;net8.0-android;net8.0-ios</TargetFrameworks>
  -->
</PropertyGroup>

2. 修正MAUI项目对Helpers文件夹的编译规则 #

打开MAUI项目的.csproj文件，确保Helpers文件夹未被排除编译：

• 删除可能存在的排除规则：

<!-- 若有以下代码，直接删除 -->
<ItemGroup>
  <Compile Remove="Helpers\**" />
</ItemGroup>

• 添加明确的包含规则（若默认未包含）：

<ItemGroup>
  <Compile Include="Helpers\**" />
</ItemGroup>

3. 验证项目引用的全局有效性 #

检查MAUI项目中对共享类库的引用是否无平台限制：

<ItemGroup>
  <!-- 确保引用无Condition属性，所有平台均生效 -->
  <ProjectReference Include="..\TestApp.Shared\TestApp.Shared.csproj" />
</ItemGroup>

4. 清理重建项目 #

• 执行Visual Studio的「生成」→「清理解决方案」
• 手动删除所有项目的bin和obj文件夹，或执行命令：dotnet clean
• 重新生成解决方案：「生成」→「重新生成解决方案」

优化方案 #

• 统一目标框架：将共享类库设为net8.0，与MAUI项目基础目标框架保持一致，减少多目标兼容性问题
• 规范跨平台代码结构：将Helpers这类跨平台代码放在MAUI项目根目录的共享区域，避免平台特定配置干扰编译
• 全局命名空间引用：在MAUI项目的_Imports.cs中添加共享类库命名空间，简化代码书写：

global using TestApp.Shared.Dtos.Search;

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