使用 dotnet watch 开发 ASP.NET Core 应用程序
原文：Developing ASP.NET Core applications using dotnet watch
作者：Victor Hurdugaci
翻译：谢炀(Kiler)
校对：刘怡(AlexLEWIS)、许登洋(Seay)
介绍
dotnet watch 是一个开发阶段在源文件发生变动的情况下使用 dotnet 命令的工具。 当代码发生变动的时候可以用来执行编译，运行测试，或者发布操作。
在本教程中，我们将使用一个现有的计算两个数字之和以及乘积的 WebApi 应用程序来演示如何使用 dotnet watch 。示例应用程序故意包含一个错误，作为本教程的一部分我们会修复它。
开始入门
开始下载 示例程序。示例程序包含两个项目， WebApp （Web 应用程序）以及 WebAppTests （Web 应用程序配套的单元测试项目）
在命令行控制台中，进入下载示例程序的目录并且运行下述命令：
1、dotnet restore
2、cd WebApp
3、dotnet run
控制台输出将显示如下信息，表明该应用程序正在运行并等待请求：
$ dotnet run
Project WebApp (.NETCoreApp,Version=v1.0) will be compiled because inputs were modified
Compiling WebApp for .NETCoreApp,Version=v1.0Compilation succeeded. 0 Warning(s) 0 Error(s)
Time elapsed 00:00:02.6049991Hosting environment: Production
Content root path: /Users/user/dev/aspnet/Docs/aspnet/tutorials/dotnet-watch/sample/WebApp
Now listening on: http://localhost:5000Application 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 引用：
复制代码
"tools": { "Microsoft.DotNet.Watcher.Tools": "1.0.0-preview2-final" //手工高亮},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 这样的方式运行：例如：
| 命令 | 带上 watch 的命令Command |
|---|---|
dotnet run |
dotnet watch run |
dotnet run -f net451 |
dotnet watch run -f net451 |
dotnet run -f net451 -- --arg1 |
dotnet watch run -f net451 -- --arg1 |
dotnet test |
dotnet watch test |
为了让 WebApp 在 watcher 模式下运行，在 WebApp 目录里面运行 dotnet watch run 命令。 控制台输出将显示如下信息，表明 dotnet watch 现在正在监控代码文件：
user$ dotnet watch run
[DotNetWatcher] info: Running dotnet with the following arguments: run
[DotNetWatcher] info: dotnet process id: 39746Project WebApp (.NETCoreApp,Version=v1.0) was previously compiled. Skipping compilation.
Hosting environment: Production
Content root path: /Users/user/dev/aspnet/Docs/aspnet/tutorials/dotnet-watch/sample/WebApp
Now listening on: http://localhost:5000Application started. Press Ctrl+C to shut down.在 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 修复错误。
保存文件。 控制台输出将显示如下信息，表明 dotnet watch 检测到文件的改变并重启了应用程序。
[DotNetWatcher] info: File changed: /Users/user/dev/aspnet/Docs/aspnet/tutorials/dotnet-watch/sample/WebApp/Controllers/MathController.cs
[DotNetWatcher] info: Running dotnet with the following arguments: run
[DotNetWatcher] info: dotnet process id: 39940Project WebApp (.NETCoreApp,Version=v1.0) will be compiled because inputs were modified
Compiling WebApp for .NETCoreApp,Version=v1.0Compilation succeeded. 0 Warning(s) 0 Error(s)
Time elapsed 00:00:03.3312829Hosting environment: Production
Content root path: /Users/user/dev/aspnet/Docs/aspnet/tutorials/dotnet-watch/sample/WebApp
Now listening on: http://localhost:5000Application started. Press Ctrl+C to shut down.验证 http://localhost:5000/api/math/product?a=4&b=5 链接返回正确的结果。
使用 dotnet watch 运行测试
文件监控也能运行其他 dotnet 命令例如 test 或者 publish。
1、打开 WebAppTests 目录，确认 project.json 文件中已经包含了 dotnet watch。
2、运行 dotnet watch test 命令。
如果你之前在 MathController 中修复了错误你会看到控制台输出显示如下信息，否则你会看到测试失败的信息：
WebAppTests user$ dotnet watch test
[DotNetWatcher] info: Running dotnet with the following arguments: test
[DotNetWatcher] info: dotnet process id: 40193Project WebApp (.NETCoreApp,Version=v1.0) was previously compiled. Skipping compilation.
Project WebAppTests (.NETCoreApp,Version=v1.0) was previously compiled. Skipping compilation.
xUnit.net .NET CLI test runner (64-bit .NET Core osx.10.11-x64) Discovering: WebAppTests Discovered: WebAppTests Starting: WebAppTests Finished: WebAppTests
=== TEST EXECUTION SUMMARY ===
WebAppTests Total: 2, Errors: 0, Failed: 0, Skipped: 0, Time: 0.259sSUMMARY: Total: 1 targets, Passed: 1, Failed: 0.[DotNetWatcher] info: dotnet exit code: 0[DotNetWatcher] info: Waiting for a file to change before restarting dotnet...一旦所有的测试运行起来了，监控器会指示他在下一次重新启动 dotnet test 前会等待一个文件的变更。
3、打开控制器 WebApp/Controllers/MathController.cs 文件并且修改代码。如果你没有修复乘法错误，马上修改。并保存。
dotnet watch 将会检测到文件变更并且重新运行测试。 控制台输出将显示如下信息：
[DotNetWatcher] info: File changed: /Users/user/dev/aspnet/Docs/aspnet/tutorials/dotnet-watch/sample/WebApp/Controllers/MathController.cs
[DotNetWatcher] info: Running dotnet with the following arguments: test
[DotNetWatcher] info: dotnet process id: 40233Project WebApp (.NETCoreApp,Version=v1.0) will be compiled because inputs were modified
Compiling WebApp for .NETCoreApp,Version=v1.0Compilation succeeded. 0 Warning(s) 0 Error(s)
Time elapsed 00:00:03.2127590Project WebAppTests (.NETCoreApp,Version=v1.0) will be compiled because dependencies changed
Compiling WebAppTests for .NETCoreApp,Version=v1.0Compilation succeeded. 0 Warning(s) 0 Error(s)
Time elapsed 00:00:02.1204052xUnit.net .NET CLI test runner (64-bit .NET Core osx.10.11-x64) Discovering: WebAppTests Discovered: WebAppTests Starting: WebAppTests Finished: WebAppTests
=== TEST EXECUTION SUMMARY ===
WebAppTests Total: 2, Errors: 0, Failed: 0, Skipped: 0, Time: 0.260sSUMMARY: Total: 1 targets, Passed: 1, Failed: 0.[DotNetWatcher] info: dotnet exit code: 0[DotNetWatcher] info: Waiting for a file to change before restarting dotnet...由于水平有限，错漏之处在所难免，欢迎大家批评指正，不胜感激，我们将及时修正。
dotNet Core Studying Group：436035237
相关文章：
ASP.NET Core 1.0 入门——了解一个空项目
ASP.NET Core 1.0 部署 HTTPS （.NET Framework 4.5.1）
.NET Core 1.0、ASP.NET Core 1.0和EF Core 1.0简介
云服务器下ASP.NET Core 1.0环境搭建（包含mono与coreclr）
使用VS Code开发ASP.NET Core 应用程序
dotnet run是如何启动asp.net core站点的
ASP.NET Core提供模块化Middleware组件
“dotnet restore"和"dotnet run"都做了些什么？
探秘 dotnet run 如何运行 .NET Core 应用程序
.NET Portability Analyzer 已开源
ASP.NET Core的配置（1）：读取配置信息
ASP.NET Core的配置（2）：配置模型详解
.NET Core 1.0 RC2 历险之旅
使用VS Code开发 调试.NET Core 应用程序
让我们Core在一起：ASP.NET Core & .NET Core
.NET Core VS Code 环境配置
官方博客明确了 .NET Core RC2/RTM 时间表
.NET Core全新的配置管理[共9篇]
利用记事本创建一个ASP.NET Core RC2 MVC应用
微软.NET 正式劈腿成功，横跨所有平台
.NET Core 1.0 CentOS7 尝试
解读发布：.NET Core RC2 and .NET Core SDK Preview 1
[.NET Core].NET Core R2安装及示例教程
ASP.NET Core 开发-中间件(Middleware)
结合Jexus + Kestrel 部署 asp.net core 生产环境
通过Jexus 部署 dotnetcore版本MusicStore 示例程序
ASP.NET Core 中文文档 第一章 入门
用 Visual Studio Code 在 macOS 上创建首个 ASP.NET Core 应用程序
用 Visual Studio 和 ASP.NET Core MVC 创建首个 Web API
用 Visual Studio 发布一个 Azure 云 Web 应用程序
ASP.NET Core MVC 与 Visual Studio 入门
第二章指南（4.2）添加 Controller
DotNet Core 介绍
asp.net core 中间件详解及项目实战
教你实践ASP.NET Core Authorization（免看文档教程）
asp.net core 使用 Redis 和 Protobuf 进行 Session 缓存
asp.net core 中间件详解及项目实战
第二章 指南（4.3）添加 View
dotnet core开发体验之开始MVC
dotnet core 开发体验之Routing
聊聊ASP.NET Core默认提供的这个跨平台的服务器——KestrelServer
简析.NET Core 以及与 .NET Framework的关系
.NET Core 使用Dapper 操作MySQL
使用 CommandLineApplication 类创建专业的控制台程序
简析 .NET Core 构成体系
.NET Core也可以使用MongoDB了
.NET Core & ASP.NET Core 1.0在Redhat峰会上正式发布
.NET Core：面向未来的开源跨平台开发技术
微软说它深爱着Linux，现在它用行动证明了
移植.NET Core计划，整合各平台变得更简单了！
ASP.NET Core 介绍
通过几个Hello World感受.NET Core全新的开发体验
ASP.NET Core 运行原理剖析1:初始化WebApp模版并运行
.NET Core系列 ： 1、.NET Core 环境搭建和命令行CLI入门
Asp.Net Core 发布和部署（ MacOS + Linux + Nginx ）
Asp.Net Core 发布和部署（Linux + Jexus ）
学习ASP.NET Core，你必须了解无处不在的“依赖注入”
.NET Core应用类型（Portable apps & Self-contained apps）
.NET Core 1.0发布：微软开源跨平台大布局序幕
ASP.NET Core 运行原理剖析2:Startup 和 Middleware(中间件)
在Windows Server 2012 R2 Standard 部署 ASP.NET Core程序
ASP.NET Core 开发-Entity Framework (EF) Core 1.0 Database First
拥抱.NET Core，跨平台的轻量级RPC：Rabbit.Rpc
原文地址：http://www.cnblogs.com/dotNETCoreSG/p/aspnetcore-2_8-dotnet-watch.html
.NET社区新闻，深度好文，微信中搜索dotNET跨平台或扫描二维码关注
