ASP.NET Core 2.0发布时自动触发Aurelia与Webpack构建方案问询

我之前也碰到过一模一样的需求，要把Aurelia的Webpack构建和ASP.NET Core的发布流程绑定起来，这样不管是本地手动发布还是VSTS CI/CD自动构建，都能自动生成需要的bundle文件。下面是具体的实现步骤：

1. 修改项目.csproj文件，添加MSBuild自定义目标 #

ASP.NET Core的发布流程基于MSBuild，我们可以在项目文件里加一个自定义Target，让它在发布过程中自动触发Webpack构建。

打开你的.csproj文件，在<Project>根标签内插入以下代码：

<Target Name="PublishWebpack" AfterTargets="ComputeFilesToPublish">
  <!-- 先检查npm是否可用，避免环境缺失导致构建失败 -->
  <Exec Command="npm --version" ContinueOnError="false" />
  
  <!-- CI环境下可能没有node_modules，自动安装依赖；本地已安装的话会跳过这个步骤 -->
  <Exec Command="npm install" Condition="!Exists('node_modules')" />
  
  <!-- 执行Webpack生产环境构建，指定你的配置文件 -->
  <Exec Command="npx webpack --config webpack.netcore.config.js --mode production" />
  
  <!-- 把Webpack生成的dist目录文件加入到发布输出列表中 -->
  <ItemGroup>
    <DistFiles Include="wwwroot\dist\**" />
    <ResolvedFileToPublish Include="@(DistFiles->'%(FullPath)')" Exclude="@(ResolvedFileToPublish)">
      <RelativePath>%(DistFiles.Identity)</RelativePath>
      <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
    </ResolvedFileToPublish>
  </ItemGroup>
</Target>

代码说明： #

• AfterTargets="ComputeFilesToPublish"：确保这个Target在MSBuild计算完要发布的文件后执行，这样Webpack刚生成的bundle会被自动包含到发布包中。
• --mode production：强制Webpack以生产模式构建，生成压缩优化后的bundle文件。
• Condition="!Exists('node_modules')"：只有当node_modules目录不存在时才执行npm install，本地开发时可以节省重复安装依赖的时间。

2. 本地验证效果 #

保存.csproj文件后，在终端运行：

dotnet publish -c Release

你会看到MSBuild先执行常规的.NET发布步骤，然后自动触发npm install（如果需要）和Webpack构建，最终wwwroot/dist下的app.bundle.js和vendor.bundle.js会被复制到发布目录中。

3. 适配VSTS（Azure DevOps）CI/CD流程 #

要让VSTS的自动构建也能正常触发Webpack，需要确保构建代理环境有Node.js：

1. 在你的VSTS管道中，添加Node.js工具安装任务：

   • 选择和本地开发环境一致的LTS版本Node.js（比如16.x）
   • 这个任务会在构建代理上自动安装指定版本的Node.js和npm

2. 添加**.NET Core CLI**任务：

   • 命令选择publish
   • 参数填写：-c Release --output $(Build.ArtifactStagingDirectory)
   • 这样MSBuild会自动执行我们之前添加的Webpack构建Target，生成的发布包会被放到指定的Artifact目录中

可选优化： #

• 添加缓存任务，缓存node_modules目录，避免每次CI构建都重新安装依赖，大幅提升构建速度。
• 如果Webpack构建失败需要终止整个CI流程，确保<Exec>标签的ContinueOnError保持默认的false，这样Webpack报错时MSBuild会直接停止，避免发布不完整的代码。

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