49 lines
2.5 KiB
Markdown
49 lines
2.5 KiB
Markdown
dotnet-watch
|
|
===
|
|
`dotnet-watch` is a file watcher for `dotnet` that restarts the specified application when changes in the source code are detected.
|
|
|
|
### How To Install
|
|
|
|
Add `Microsoft.DotNet.Watcher.Tools` to the `tools` section of your `project.json` file:
|
|
|
|
```
|
|
{
|
|
...
|
|
"tools": {
|
|
"Microsoft.DotNet.Watcher.Tools": {
|
|
"version": "1.0.0-*",
|
|
"imports": "portable-net451+win8"
|
|
}
|
|
}
|
|
...
|
|
}
|
|
```
|
|
|
|
### How To Use
|
|
|
|
dotnet watch [dotnet arguments]
|
|
|
|
Add `watch` after `dotnet` in the command that you want to run:
|
|
|
|
| What you want to run | Dotnet watch command |
|
|
| ---------------------------------------------- | -------------------------------------------------------- |
|
|
| dotnet run | dotnet **watch** run |
|
|
| dotnet run --arg1 value1 | dotnet **watch** run --arg1 value |
|
|
| dotnet run --framework net451 -- --arg1 value1 | dotnet **watch** run --framework net451 -- --arg1 value1 |
|
|
| dotnet test | dotnet **watch** test |
|
|
|
|
### Advanced configuration options
|
|
|
|
Configuration options can be passed to `dotnet watch` through environment variables. The available variables are:
|
|
|
|
| Variable | Effect |
|
|
| ---------------------------------------------- | -------------------------------------------------------- |
|
|
| DOTNET_USE_POLLING_FILE_WATCHER | If set to "1" or "true", `dotnet watch` will use a polling file watcher instead of CoreFx's `FileSystemWatcher`. Used when watching files on network shares or Docker mounted volumes. |
|
|
| DOTNET_WATCH_LOG_LEVEL | Used to set the logging level for messages coming from `dotnet watch`. Accepted values `None`, `Trace`, `Debug`, `Information`, `Warning`, `Error`, `Critical`. Default: `Information`. |
|
|
|
|
AppVeyor: [](https://ci.appveyor.com/project/aspnetci/dnx-watch/branch/dev)
|
|
|
|
Travis: [](https://travis-ci.org/aspnet/dotnet-watch)
|
|
|
|
This project is part of ASP.NET Core. You can find samples, documentation and getting started instructions for ASP.NET Core at the [Home](https://github.com/aspnet/home) repo.
|