如何将非MAUI核心库文件便捷纳入MAUI项目？

针对你的需求——无需修改核心类库，将其文件纳入MAUI项目且对核心项目用户无额外操作要求，推荐以下两种高效方案：

方案一：直接标记核心项目文件为MauiAsset（无需复制文件，推荐） #

通过MSBuild目标在MAUI项目中动态识别核心项目的文件，直接将它们标记为MAUI所需的MauiAsset类型，跳过文件复制步骤，避免时机冲突问题。

在MAUI项目的.csproj文件中添加以下配置：

<Target Name="IncludeCoreProjectFilesAsMauiAssets" AfterTargets="ResolveReferences">
  <!-- 定位核心项目的路径（替换成你的核心项目名称） -->
  <PropertyGroup>
    <CoreProjectPath>$([MSBuild]::GetPathOfFileAbove('CoreProject.csproj', '$(SolutionDir)'))</CoreProjectPath>
  </PropertyGroup>

  <!-- 收集核心项目中需要纳入的文件（按需调整通配符，排除代码/项目文件） -->
  <ItemGroup>
    <CoreFiles Include="$(CoreProjectPath)\**\*.json;$(CoreProjectPath)\**\*.txt;$(CoreProjectPath)\**\*.png"
               Exclude="$(CoreProjectPath)\**\*.cs;$(CoreProjectPath)\**\*.csproj;$(CoreProjectPath)\bin\**;$(CoreProjectPath)\obj\**" />
    
    <!-- 标记为MauiAsset，文件会被MAUI按跨平台规则处理，链接到Raw目录保持结构 -->
    <MauiAsset Include="@(CoreFiles)">
      <Link>Raw/%(RecursiveDir)%(Filename)%(Extension)</Link>
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </MauiAsset>
  </ItemGroup>
</Target>

优势： #

• 无需复制文件，减少构建耗时，避免文件重复
• 核心项目用户完全无需修改任何配置，保持原有工作流程
• 自动保持核心项目的文件目录结构，便于在MAUI中按路径访问

方案二：提前复制文件到Resources\Raw（适合必须物理存在于Raw目录的场景） #

如果需要文件实际出现在MAUI项目的Resources\Raw目录中，可调整MSBuild目标的执行时机，确保在MAUI处理资源前完成复制。

在MAUI项目的.csproj文件中添加以下配置：

<Target Name="CopyCoreFilesToRawResources" BeforeTargets="MauiPrepareResources">
  <!-- 定位核心项目路径与Raw资源目录 -->
  <PropertyGroup>
    <CoreProjectPath>$([MSBuild]::GetPathOfFileAbove('CoreProject.csproj', '$(SolutionDir)'))</CoreProjectPath>
    <RawResourcesDir>$(ProjectDir)Resources\Raw</RawResourcesDir>
  </PropertyGroup>

  <!-- 收集需要复制的核心项目文件 -->
  <ItemGroup>
    <CoreFiles Include="$(CoreProjectPath)\**\*.json;$(CoreProjectPath)\**\*.txt;$(CoreProjectPath)\**\*.png"
               Exclude="$(CoreProjectPath)\**\*.cs;$(CoreProjectPath)\**\*.csproj;$(CoreProjectPath)\bin\**;$(CoreProjectPath)\obj\**" />
  </ItemGroup>

  <!-- 复制文件到Raw目录，跳过未修改的文件提升构建速度 -->
  <Copy
    SourceFiles="@(CoreFiles)"
    DestinationFiles="$(RawResourcesDir)\%(RecursiveDir)%(Filename)%(Extension)"
    SkipUnchangedFiles="true"
    OverwriteReadOnlyFiles="true"
  />
</Target>

关键说明： #

• BeforeTargets="MauiPrepareResources"确保复制操作在MAUI处理资源之前完成，解决时机滞后问题
• SkipUnchangedFiles="true"避免重复复制未修改的文件，减少构建耗时

通用注意事项 #

• 调整CoreFiles中的通配符，匹配你实际需要纳入的文件类型（如.xml、.csv等）
• 排除核心项目的bin、obj目录，避免复制编译产物
• 两种方案均无需修改核心类库的任何配置，完全不影响核心项目用户的日常工作

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