Skip to content

Commit 4dd1ab3

Browse files
authored
Reorder DTB documentation sections
This puts the VS2022 instructions at the top, increasing the chance that users following these instructions produce high-fidelity binlogs.
1 parent a687a00 commit 4dd1ab3

File tree

1 file changed

+18
-18
lines changed

1 file changed

+18
-18
lines changed

docs/design-time-builds.md

+18-18
Original file line numberDiff line numberDiff line change
@@ -98,23 +98,6 @@ The following are symptoms of a design-time build that is taking too long:
9898

9999
You can force Visual Studio to show the results of a design-time build using the following instructions:
100100

101-
#### Visual Studio 2015 or below
102-
103-
1. Delete the `.vs` directory that sits alongside the solution that is experiencing the problem
104-
2. Start a _Developer Command Prompt for VS2015_
105-
3. At the prompt, run `SET TRACEDESIGNTIME=true`
106-
4. At the prompt, run `devenv`
107-
5. Open the solution
108-
6. Under `%TEMP%`, look for `[RANDOMGUID].designtime.log` files, these will contain the results of the design-time build. If running Visual Studio 2015 Update 2 or higher, the name of the project and design-time target that is being called will also be included in the file name.
109-
110-
#### Visual Studio 2017 or later
111-
112-
1. Install the [Project System Tools](https://github.com/dotnet/project-system-tools#project-system-tools) extension
113-
2. In Visual Studio, choose the `View > Other Windows > Build Logging` menu item.
114-
3. Click on the "play" button.
115-
116-
This will cause design-time builds to show up in the build logging tool window. If you have the [MSBuild Structured Log Viewer](https://msbuildlog.com) installed, you can double-click on a log to view it in the viewer, otherwise you can right-click and choose `Save As...` to save the log in the new [binary log format](https://github.com/Microsoft/msbuild/wiki/Binary-Log).
117-
118101
#### Visual Studio 2022 or later
119102

120103
You may use the [Project System Tools](https://github.com/dotnet/project-system-tools#project-system-tools) extension mentioned immediately above, however that extension does not capture all available information. To capture all build information:
@@ -127,7 +110,7 @@ You may use the [Project System Tools](https://github.com/dotnet/project-system-
127110
```
128111
You can use whatever path you like for `MSBUILDDEBUGPATH`, but it must be writeable by the current user.
129112
1. Type `devenv` to start Visual Studio with this configuration.
130-
1. Open the `MSBUILDDEBUGPATH` path in Windows Explorer to see the captured `.binlog` and other diagnostic files. You can open them using the [MSBuild Structured Log Viewer](https://msbuildlog.com)
113+
1. Open the `MSBUILDDEBUGPATH` path in Windows Explorer to see the captured `.binlog` and other diagnostic files. You can open them using the [MSBuild Structured Log Viewer](https://msbuildlog.com).
131114

132115
⚠️ While this environment variable is set, all builds will be logged. It's possible for the number of output logs to be very high.
133116

@@ -136,6 +119,23 @@ For more information, see:
136119
- [Providing MSBuild Binary Logs for investigation](https://github.com/dotnet/msbuild/blob/main/documentation/wiki/Providing-Binary-Logs.md)
137120
- [Further MSBuild documentation on binlogs](https://github.com/dotnet/msbuild/blob/main/documentation/wiki/Building-Testing-and-Debugging-on-Full-Framework-MSBuild.md#logs).
138121

122+
#### Visual Studio 2017
123+
124+
1. Install the [Project System Tools](https://github.com/dotnet/project-system-tools#project-system-tools) extension.
125+
2. In Visual Studio, choose the `View > Other Windows > Build Logging` menu item.
126+
3. Click on the "play" button.
127+
128+
This will cause design-time builds to show up in the build logging tool window. If you have the [MSBuild Structured Log Viewer](https://msbuildlog.com) installed, you can double-click on a log to view it in the viewer, otherwise you can right-click and choose `Save As...` to save the log in the new [binary log format](https://github.com/Microsoft/msbuild/wiki/Binary-Log).
129+
130+
#### Visual Studio 2015 or below
131+
132+
1. Delete the `.vs` directory that sits alongside the solution that is experiencing the problem.
133+
2. Start a _Developer Command Prompt for VS2015_.
134+
3. At the prompt, run `SET TRACEDESIGNTIME=true`
135+
4. At the prompt, run `devenv`
136+
5. Open the solution.
137+
6. Under `%TEMP%`, look for `[RANDOMGUID].designtime.log` files, these will contain the results of the design-time build. If running Visual Studio 2015 Update 2 or higher, the name of the project and design-time target that is being called will also be included in the file name.
138+
139139
### Diagnosing failing or slow design-time builds
140140

141141
After following the above instructions, open the resulting build log file or Output window (for the new project system).

0 commit comments

Comments
 (0)