【译】使用 dotnet watch 开发 ASP.NET Core 应用

介绍

dotnet watch 是一个开发阶段在源文件发生变动的情况下使用 dotnet 命令的工具。 当代码发生变动的时候可以用来执行编译，运行测试，或者发布操作。

在本教程中，我们将使用一个现有的计算两个数字之和以及乘积的 WebApi 应用程序来演示如何使用 dotnet watch 。示例应用程序故意包含一个错误，作为本教程的一部分我们会修复它。

开始入门

开始下载 示例程序。示例程序包含两个项目， WebApp （Web 应用程序）以及 WebAppTests （Web 应用程序配套的单元测试项目）

在命令行控制台中，进入下载示例程序的目录并且运行下述命令：

1、dotnet restore 2、cd WebApp 3、dotnet run

控制台输出将显示如下信息，表明该应用程序正在运行并等待请求：

$ dotnet run
Hosting environment: Development
Content root path: C:/Docs/aspnetcore/tutorials/dotnet-watch/sample/WebApp
Now listening on: http://localhost:5000
Application started. Press Ctrl+C to shut down.

在 Web 浏览器中，导航到 http://localhost:5000/api/math/sum?a=4&b=5 页面你会看到结果 9 。

如果你导航到 http://localhost:5000/api/math/product?a=4&b=5 页面，你期望得到结果 20。但是实际上还是返回了 9 。

我们会修复这个问题的。

项目中添加 dotnet watch

1、按照下面例子的方式在 WebApp/project.json 文件的 tools 配置节中添加 Microsoft.DotNet.Watcher.Tools 引用：

<ItemGroup>
    <DotNetCliToolReference Include="Microsoft.DotNet.Watcher.Tools" Version="2.0.0" />
</ItemGroup> 

2、运行 dotnet restore。

控制台输出将显示如下信息：

复制代码

log  : Restoring packages for /Users/user/dev/aspnet/Docs/aspnet/tutorials/dotnet-watch/sample/WebApp/project.json...
log  : Restoring packages for tool 'Microsoft.DotNet.Watcher.Tools' in /Users/user/dev/aspnet/Docs/aspnet/tutorials/dotnet-watch/sample/WebApp/project.json...
log  : Installing Microsoft.DotNet.Watcher.Core 1.0.0-preview2-final.
log  : Installing Microsoft.DotNet.Watcher.Tools 1.0.0-preview2-final.

使用 dotnet watch 运行 dotnet 命令

任何与 dotnet 有关的命令都可以以 dotnet watch 这样的方式运行：例如：

为了让 WebApp 在 watcher 模式下运行，在 WebApp 目录里面运行 dotnet watch run 命令。 控制台便会监控代码文件变化。

在 dotnet watch 模式进行修改

确保 dotnet watch 在运行中。

让我们来修复上面发现的那个两个数相乘结果错误。

打开文件 WebApp/Controllers/MathController.cs。我们故意在代码中引入了错误。

public static int Product(int a, int b)
{
    // We have an intentional bug here
    // + should be *
    return a + b;//手工高亮
}

通过把代码 a + b 替换为 a * b 修复错误。

保存文件，验证 http://localhost:5000/api/math/product?a=4&b=5 链接返回正确的结果。

使用 dotnet watch 运行测试

1、打开文件 WebApp/Controllers/MathController.cs。撤销原先的修改并保存文件。

2、导航到WebAppTests目录

3、运行dotnet restore命令

4、运行dotnet watch test, 控制台输出将显示如下信息：

Total tests: 2. Passed: 1. Failed: 1. Skipped: 0.
Test Run Failed.

修改代码，并保存文件。

dotnet watch 将会检测到文件变更并且重新运行测试。

查看英文原文：Developing ASP.NET Core apps using dotnet watch