Skip to content

Commit d11b4e5

Browse files
authored
Merge pull request #10664 from MicrosoftDocs/main638775722054787848sync_temp
Repo sync for protected branch
2 parents f4a6ce2 + 6032f5f commit d11b4e5

10 files changed

+359
-437
lines changed

.openpublishing.redirection.json

Lines changed: 332 additions & 330 deletions
Large diffs are not rendered by default.
-21.8 KB
Binary file not shown.
-38.2 KB
Binary file not shown.
-37.2 KB
Binary file not shown.
Binary file not shown.
-72 KB
Binary file not shown.

docs/debugger/specify-command-line-arguments.md

Lines changed: 0 additions & 95 deletions
This file was deleted.

docs/debugger/toc.yml

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -138,8 +138,6 @@
138138
href: project-settings-for-a-cpp-debug-configuration.md
139139
- name: Enable debug features in C++ (-D_DEBUG)
140140
href: enabling-debug-features-in-visual-cpp-d-debug.md
141-
- name: Pass command-line arguments while debugging (C++)
142-
href: specify-command-line-arguments.md
143141
- name: Project settings (C#)
144142
href: project-settings-for-csharp-debug-configurations.md
145143
- name: Project settings (.NET C#)

docs/extensibility/visualstudio.extensibility/dotnet-management-overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.date: 02/04/2025
88
ms.topic: conceptual
99
ms.subservice: extensibility-integration
1010
---
11-
# .NET Companatibilty for VisualStudio.Extensibility Extensions
11+
# .NET Compatibility for VisualStudio.Extensibility Extensions
1212

1313
The new VisualStudio.Extensibilty model allows extensions to be run outside the main Visual Studio process in a separate .NET host process. Because .NET is used as the runtime to execute VisualStudio.Extensibility extensions, extensions built using the VisualStudio.Extensibility framework must stay up-to-date with the publicly supported .NET long-term servicing (LTS) runtimes.
1414

docs/test/live-unit-testing-faq.yml

Lines changed: 26 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -48,26 +48,26 @@ sections:
4848
4949
- If NuGet packages referenced by the projects in the solution haven't been restored, Live Unit Testing won't work. Performing an explicit build of the solution or restoring NuGet packages in the solution before turning on Live Unit Testing should resolve this issue.
5050
51-
- If you are using MSTest-based tests in your projects, make sure that you remove the reference to `Microsoft.VisualStudio.QualityTools.UnitTestFramework`, and add references to the latest MSTest NuGet packages, `MSTest.TestAdapter` (a minimum version of 1.1.11 is required) and `MSTest.TestFramework` (a minimum version of 1.1.11 is required). For more information, see the "Supported test frameworks" section of the [Use Live Unit Testing in Visual Studio](live-unit-testing.md#supported-test-frameworks) article.
51+
- If you're using MSTest-based tests in your projects, make sure that you remove the reference to `Microsoft.VisualStudio.QualityTools.UnitTestFramework`, and add references to the latest MSTest NuGet packages, `MSTest.TestAdapter` (a minimum version of 1.1.11 is required) and `MSTest.TestFramework` (a minimum version of 1.1.11 is required). For more information, see the "Supported test frameworks" section of the [Use Live Unit Testing in Visual Studio](live-unit-testing.md#supported-test-frameworks) article.
5252
5353
- At least one project in your solution should have either a NuGet reference or direct reference to the xUnit, NUnit, or MSTest test framework. This project should also reference a corresponding Visual Studio test adapters NuGet package.
5454
5555
- question: |
5656
Why is my project not building?
5757
answer: |
58-
The build errors get reported to the Output window when the Live Unit Testing drop-down is selected. There are a few common issues caused by incorrect configuration in the [setup wizard](../test/live-unit-testing.md#configure) that can cause build issues in Live Unit Testing.
58+
The build errors get reported to the Output window when the Live Unit Testing drop-down is selected. There are a few common issues caused by incorrect configuration in the [setup wizard](../test/live-unit-testing.md#configure) that can cause build issues in Live Unit Testing.
5959
6060
- If the [Workspace Root](../test/live-unit-testing.md#workspace-root) property is too long, it’s possible that the build will fail due to exceptions indicating that the path is too long.
6161
6262
- If the [Repository Root](../test/live-unit-testing.md#repository-root) property doesn't point towards the repository root, the workspace will be populated with the wrong set of files.
6363
64-
- For git repositories, the [Exclude files](../test/live-unit-testing.md#specify-the-excluded-files) property usually avoids copying the files specified in the *gitignore* file. However, it’s possible to check in files to the git repository that are ignored, or it’s possible to run tools that auto generate files, but these are not generated during the build. In these cases, the "<Custom>" option should be chosen and a custom set of rules that only list the artifacts folders should be listed.
64+
- For git repositories, the [Exclude files](../test/live-unit-testing.md#specify-the-excluded-files) property usually avoids copying the files specified in the *gitignore* file. However, it’s possible to check in files to the git repository that are ignored, or it’s possible to run tools that auto generate files, but these aren't generated during the build. In these cases, the "<Custom>" option should be chosen and a custom set of rules that only list the artifacts folders should be listed.
6565
6666
Besides the issues described previously, the following project configurations that might not build correctly.
6767
6868
- If project dependencies are specified as a global solution configuration and not as `ProjectReferences` for each project, Live Unit Testing might end up building the incorrect set of projects. To fix this, add explicit references between projects.
6969
70-
- Until a [Live Unit Testing playlist](../test/live-unit-testing.md#specify-the-excluded-files) is chosen, Live Unit Testing will not build any projects. To fix this, include some tests in the Live Unit Testing playlist.
70+
- Until a [Live Unit Testing playlist](../test/live-unit-testing.md#specify-the-excluded-files) is chosen, Live Unit Testing won't build any projects. To fix this, include some tests in the Live Unit Testing playlist.
7171
7272
- If you're using MSTest-based tests in your projects, make sure that you remove the reference to `Microsoft.VisualStudio.QualityTools.UnitTestFramework`, and add references to the latest MSTest NuGet packages, `MSTest.TestAdapter` (a minimum version of 1.1.11 is required) and `MSTest.TestFramework` (a minimum version of 1.1.11 is required). For more information, see [Supported test frameworks](../test/live-unit-testing.md#supported-test-frameworks).
7373
@@ -81,6 +81,23 @@ sections:
8181
</RunSettings>
8282
```
8383
84+
- question: |
85+
Does Live Unit Testing support source generator projects?
86+
answer: |
87+
Live Unit Testing can't build the source generator projects with instrumentation.
88+
Due to how the C# compiler sets up assembly loading for source generators, the attempt to build source generator projects with instrumentation fails to load Live Unit Testing assemblies.
89+
90+
You can set `<ExcludeFromCodeCoverage>true</ExcludeFromCodeCoverage>` property in the source generator
91+
csproj files, to make these projects build in Live Unit Testing.
92+
93+
- question: |
94+
How to resolve error "Could not load file or assembly 'Microsoft.Bcl.AsyncInterfaces'"?
95+
96+
answer: |
97+
Live Unit Testing runs the build inside of its own process for performance reasons.
98+
If this separate build process is causing an error, you can set `<UseInProcMSBuildNode>false</UseInProcMSBuildNode>` to the *.lutconfig* file to ensure
99+
that all of the build happens in the MSBuild process.
100+
84101
- question: |
85102
Why are my tests failing to run?
86103
answer: |
@@ -108,7 +125,7 @@ sections:
108125
answer: |
109126
If your solution requires custom steps to build for instrumentation (Live Unit Testing) that aren't required for the "regular" non-instrumented build, then you can add code to your project or *.targets* files that checks for the `BuildingForLiveUnitTesting` property and performs custom pre/post build steps. You can also choose to remove certain build steps (like publishing or generating packages) or to add build steps (like copying prerequisites) to a Live Unit Testing build based on this project property. Customizing your build based on this property doesn't alter your regular build in any way, and only impacts Live Unit Testing builds.
110127
111-
For example, there may be a target that produces NuGet packages during a regular build. You probably do not want NuGet packages to be generated after every edit you make. So you can disable that target in the Live Unit Testing build by doing something like the following:  
128+
For example, there may be a target that produces NuGet packages during a regular build. You probably don't want NuGet packages to be generated after every edit you make. So you can disable that target in the Live Unit Testing build by doing something like the following:  
112129
113130
```xml
114131
<Target Name="GenerateNuGetPackages" BeforeTargets="AfterBuild" Condition="'$(BuildingForLiveUnitTesting)' != 'true'">
@@ -164,7 +181,7 @@ sections:
164181
- name: Continuous builds
165182
questions:
166183
- question: |
167-
Why does Live Unit testing keep building my solution all the time even if I am not making any edits?
184+
Why does Live Unit testing keep building my solution all the time even if I'm not making any edits?
168185
answer: |
169186
Your solution can build even if you're not making edits if the build process generates source code that's part of the solution itself, and your build target files don't have appropriate inputs and outputs specified. Targets should be given a list of inputs and outputs so that MSBuild can perform the appropriate up-to-date checks and determine whether a new build is required.
170187
@@ -173,7 +190,7 @@ sections:
173190
- name: Editor icons
174191
questions:
175192
- question: |
176-
Why do I not see any icons in the editor even though Live Unit Testing seems to be running the tests based on the messages in the Output window?
193+
Why don't I see any icons in the editor even though Live Unit Testing seems to be running the tests based on the messages in the Output window?
177194
answer: |
178195
You might not see icons in the editor if the assemblies that Live Unit Testing is operating on aren't instrumented for any reason. For example, Live Unit Testing isn't compatible with projects that set `<UseHostCompilerIfAvailable>false</UseHostCompilerIfAvailable>`. In this case, your build process needs to be updated to either remove this setting or to change it to `true` for Live Unit Testing to work. 
179196
@@ -197,7 +214,7 @@ sections:
197214
- question: |
198215
Can I edit the files under the workspace folder?
199216
answer: |
200-
No, you should not open or edit the files under the build and test directories of the workspace folder.
217+
No, you shouldn't open or edit the files under the build and test directories of the workspace folder.
201218
Live Unit Testing should manage all of the files in the *src* folder, to keep them in sync between
202219
the [Repository Root](../test/live-unit-testing.md#repository-root) and [Workspace Root](../test/live-unit-testing.md#workspace-root).
203220
@@ -206,7 +223,7 @@ sections:
206223
- question: |
207224
Does live unit testing support Dev Drive for the default workspace root?
208225
answer: |
209-
Yes, but you need to make sure it's enabled. If you are using a Dev Drive, make sure that the [projected file system (ProjFS)](/windows/dev-drive/#filters-for-common-scenarios) filter is enabled. For example, the following command enables ProjFS and Windows Defender:
226+
Yes, but you need to make sure it's enabled. If you're using a Dev Drive, make sure that the [projected file system (ProjFS)](/windows/dev-drive/#filters-for-common-scenarios) filter is enabled. For example, the following command enables ProjFS and Windows Defender:
210227
211228
```cmd
212229
fsutil devdrv setfiltersallowed PrjFlt,WdFilter

0 commit comments

Comments
 (0)