Skip to content

Commit 2d22d9a

Browse files
authored
Document dotnet-watch breaking change
1 parent ed97bb1 commit 2d22d9a

File tree

1 file changed

+37
-0
lines changed

1 file changed

+37
-0
lines changed
Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
---
2+
title: "Breaking change: dotnet-watch requires disabling Hot Reload mode for projects targeting .NET 5 or older"
3+
description: Learn about a breaking change in the .NET 9 SDK where dotnet-watch requires disabling Hot Reload for projects targeting .NET 5 or older.
4+
ms.date: 07/09/2024
5+
---
6+
# Error reported for .NET 5 targets or older
7+
8+
## Previous behavior
9+
10+
Previously, `dotnet-watch` automatically disabled Hot Reload when used with projects targeting .NET 5 or older.
11+
12+
## New behavior
13+
14+
An error is reported when dotnet-watch is launched without `--no-hot-reload` on projects targeting .NET 5 or older:
15+
16+
> Hot Reload based watching is only supported in .NET 6.0 or newer apps.
17+
18+
## Version introduced
19+
20+
.NET 9 RC 1
21+
22+
## Type of breaking change
23+
24+
This change can affect development workflow.
25+
26+
## Reason for change
27+
28+
We have made significant changes in the internal architecture of the tool. Preserving behavior for out of support .NET versions did not warrant increasing complexity of the new implementation.
29+
30+
## Recommended action
31+
32+
Pass `--no-hot-reload` to `dotnet-watch` command line, or update your project to target `net6.0` or higher (`TargetFramework` property).
33+
34+
## Affected APIs
35+
36+
N/A
37+

0 commit comments

Comments
 (0)