ASP.NET Core 6 MVC静态文件NuGet包创建求助

一、清理项目结构，保留核心文件 #

• 删除冗余的.nuspec、无效的props/targets文件，仅保留以下核心内容：
  • 静态资源：wwwroot/css/、wwwroot/js/下的所有文件
  • 视图文件：Views/Shared/_Layout.cshtml（按需保留_ViewStart.cshtml、_ViewImports.cshtml等依赖文件）
  • 项目配置：.csproj文件

二、配置.csproj文件 #

直接在项目文件中定义NuGet包的打包规则，无需额外.nuspec：

<Project Sdk="Microsoft.NET.Sdk.Razor">
  <PropertyGroup>
    <TargetFramework>net6.0</TargetFramework>
    <PackageId>Your.Package.Id</PackageId>
    <Version>1.0.0</Version>
    <Authors>Your Name</Authors>
    <Description>Shared CSS, JS and Layout for ASP.NET Core 6 MVC</Description>
    <PackageTags>aspnetcore;mvc;layout;staticfiles</PackageTags>
    <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
    <!-- 禁用Razor编译，避免视图被打包进程序集 -->
    <RazorCompileOnBuild>false</RazorCompileOnBuild>
    <RazorCompileOnPublish>false</RazorCompileOnPublish>
  </PropertyGroup>

  <ItemGroup>
    <!-- 打包静态文件，保留wwwroot目录结构 -->
    <Content Include="wwwroot\**\*">
      <PackagePath>contentFiles\any\any\wwwroot\</PackagePath>
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </Content>
    <!-- 打包视图文件，保留Views目录结构 -->
    <Content Include="Views\**\*.cshtml">
      <PackagePath>contentFiles\any\any\Views\</PackagePath>
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </Content>
  </ItemGroup>

  <!-- 引入自定义目标文件，控制安装时的文件复制逻辑 -->
  <ItemGroup>
    <None Include="build\Your.Package.Id.targets">
      <PackagePath>build\</PackagePath>
    </None>
  </ItemGroup>
</Project>

三、创建build/Your.Package.Id.targets文件 #

在项目根目录新建build文件夹，添加目标文件定义安装时的文件复制规则：

<Project>
  <Target Name="CopySharedAssets" BeforeTargets="Build">
    <!-- 复制静态文件到目标项目的wwwroot目录，覆盖同名文件 -->
    <Copy SourceFiles="@(Content)"
          DestinationFiles="$(MSBuildProjectDirectory)\wwwroot\%(RecursiveDir)%(Filename)%(Extension)"
          SkipUnchangedFiles="false"
          OverwriteReadOnlyFiles="true" />
    <!-- 复制视图文件到目标项目的Views目录，覆盖同名文件 -->
    <Copy SourceFiles="@(Content)"
          DestinationFiles="$(MSBuildProjectDirectory)\Views\%(RecursiveDir)%(Filename)%(Extension)"
          SkipUnchangedFiles="false"
          OverwriteReadOnlyFiles="true" />
  </Target>
</Project>

注意：将Your.Package.Id替换为实际的包ID，需与.csproj中的PackageId完全一致。

四、生成并发布到GitHub Packages #

1. 清理项目：执行dotnet clean
2. 生成NuGet包：执行dotnet pack -c Release
3. 配置GitHub Packages源：

   dotnet nuget add source --username 你的GitHub用户名 --password 你的GitHub个人访问令牌 --store-password-in-clear-text --name github "https://nuget.pkg.github.com/你的GitHub用户名/index.json"
   

4. 推送包：

   dotnet nuget push "bin\Release\Your.Package.Id.1.0.0.nupkg" --source github
   

五、安装包到目标MVC项目 #

1. 将GitHub Packages源添加到目标项目的NuGet.Config中
2. 执行安装命令：

   dotnet add package Your.Package.Id --version 1.0.0
   

3. 构建目标项目，包内的静态文件与视图会自动复制到对应目录，同名文件将被覆盖

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