Skip to content

Commit fd6b950

Browse files
committed
Merged main into live
2 parents 13d7911 + 548e353 commit fd6b950

25 files changed

+241
-67
lines changed

.whatsnew.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
"labels": [
1111
"-label:CLA"
1212
],
13-
"minAdditionsToFile": 10
13+
"minAdditionsToFile": 2
1414
},
1515
"areas": [
1616
{
Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
---
2+
title: "Adapt to removal of Windows Arm32 .NET debugging"
3+
description: Provides guidance on how to adapt to the removal of Windows Arm32 .NET Debugging support
4+
ms.date: "12/12/2024"
5+
ms.topic: "error-reference"
6+
dev_langs:
7+
- "CSharp"
8+
- "VB"
9+
- "FSharp"
10+
author: "mikejo5000"
11+
ms.author: "mikejo"
12+
manager: mijacobs
13+
ms.subservice: debug-diagnostics
14+
---
15+
16+
# Adapt to removal of Windows Arm32 .NET debugging
17+
18+
.NET support for Windows on Arm32 has ended. Debugging support for this platform will be removed from Visual Studio 2022 starting with the 17.14 update. This article lists potential options for customers currently debugging .NET Code on Windows Arm32.
19+
20+
21+
## Option 1: Run code in an Arm64 process
22+
23+
If your device runs Arm64 Windows or can be upgraded to it, the easiest way is to migrate the debugged process from Arm32 to Arm64. How to manage the switch to Arm64 depends on the type of project you're using:
24+
25+
* For Universal Windows Platform (UWP) apps, see [Update app architecture from Arm32 to Arm64](/windows/arm/arm32-to-arm64).
26+
* For processes that have their own native executable that's self-hosting the .NET Runtime, the native project needs to be configured to target Arm64.
27+
* If the executable project is a .NET project, then something is likely specifying the `RuntimeIdentifier` MSBuild property. `RuntimeIdentifier` should be updated to target `win-arm64` instead of `win-arm` (or similar runtime IDs).
28+
29+
30+
## Option 2: Use an older version of Visual Studio
31+
32+
Visual Studio 17.12 can be used from the Long-Term Servicing Channel (LTSC). For more information, see [Visual Studio Product Lifecycle and Servicing](/visualstudio/productinfo/vs-servicing).
33+
34+
35+
## Option 3: Start without debugging
36+
37+
If you have a project that you still want to run but doesn't require debugging, use **Debug->Start without debugging** to run the project. Since the debugger isn't available, you would need to diagnose any problems by using logging.
38+
39+
> [!NOTE]
40+
> This option is not recommended since .NET support for Windows on Arm32 has ended.
41+
42+
43+
## Option 4: Target Linux
44+
45+
The .NET Runtime continues to support Arm32 Linux. For IoT hardware that isn't capable of running Arm64 Windows but is capable of running Arm32 Linux, the only supported path for running .NET Code on that hardware would be to switch to Linux.

docs/debugger/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -294,6 +294,8 @@
294294
href: error-unable-to-connect-to-the-machine-name-the-machine-cannot-be-found-on-the-network.md
295295
- name: Remote machine does not appear in a Remote Connections dialog
296296
href: error-remote-machine-does-not-appear-in-a-remote-connections-dialog.md
297+
- name: Adapt to removal of Windows Arm32 .NET debugging
298+
href: adapt-to-removal-of-windows-arm32-dotnet-debugging.md
297299
- name: Attach to process
298300
items:
299301
- name: Attach to running processes with the debugger

docs/extensibility/how-to-provide-brokered-service.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -387,7 +387,7 @@ As not all combinations are valid, we recommend either of these combinations:
387387
<xref:Microsoft.ServiceHub.Framework.ServiceJsonRpcDescriptor.Formatters.MessagePack> | <xref:Microsoft.ServiceHub.Framework.ServiceJsonRpcDescriptor.MessageDelimiters.BigEndianInt32LengthHeader> | High performance
388388
<xref:Microsoft.ServiceHub.Framework.ServiceJsonRpcDescriptor.Formatters.UTF8> (JSON) | <xref:Microsoft.ServiceHub.Framework.ServiceJsonRpcDescriptor.MessageDelimiters.HttpLikeHeaders> | Interop with other JSON-RPC systems
389389

390-
By specifying the `MultiplexingStream.Options` object as the final parameter, the RPC connection shared between client and service is just one channel on a [MultiplexingStream](https://github.com/AArnott/Nerdbank.Streams/blob/main/doc/MultiplexingStream.md), which is shared with the JSON-RPC connection to [enable efficient transfer of large binary data over JSON-RPC](https://github.com/microsoft/vs-streamjsonrpc/blob/main/doc/oob_streams.md).
390+
By specifying the `MultiplexingStream.Options` object as the final parameter, the RPC connection shared between client and service is just one channel on a [MultiplexingStream](https://dotnet.github.io/Nerdbank.Streams/docs/MultiplexingStream.html), which is shared with the JSON-RPC connection to [enable efficient transfer of large binary data over JSON-RPC](https://github.com/microsoft/vs-streamjsonrpc/blob/main/doc/oob_streams.md).
391391

392392
The <xref:StreamJsonRpc.ExceptionProcessing.ISerializable?displayProperty=nameWithType> strategy causes exceptions thrown from your service to be serialized and preserved as the <xref:System.Exception.InnerException?displayProperty=nameWithType> to the <xref:StreamJsonRpc.RemoteInvocationException> thrown on the client.
393393
Without this setting, less detailed exception information is available on the client.

docs/ide/whats-new-visual-studio-docs.md

Lines changed: 73 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "What's new in Visual Studio docs"
33
description: Discover recent changes in the Visual Studio documentation, including updated articles about getting started, the IDE, and deployment.
4-
ms.date: 12/02/2024
4+
ms.date: 12/12/2024
55
helpviewer_keywords:
66
- "Visual Studio, what's new, docs"
77
- "what's new [Visual Studio]"
@@ -17,6 +17,12 @@ Welcome to what's new in Visual Studio docs. The following sections provide deta
1717

1818
## November 2024
1919

20+
### Azure
21+
22+
**Updated articles**
23+
24+
- [Sign in with an Azure subscription](../azure/how-to-sign-in-with-azure-subscription.md) - Link to tenant filtering
25+
2026
### Debugger
2127

2228
**New articles**
@@ -28,9 +34,23 @@ Welcome to what's new in Visual Studio docs. The following sections provide deta
2834

2935
**Updated articles**
3036

31-
- [Use the right type of breakpoint](../debugger/using-breakpoints.md) - Refactor breakpoints article and incorporate review feedback
37+
- [Use the right type of breakpoint](../debugger/using-breakpoints.md)
38+
- Add link to breakpoints article for new users
39+
- Refactor breakpoints article and incorporate review feedback
40+
- Add information on export and import of breakpoint groups
41+
- [FAQ - Debugger feature finder](../debugger/find-your-debugging-task.yml) - Refactor breakpoints article and incorporate review feedback
42+
- [View and change variable values with data tips in the code editor](../debugger/view-data-values-in-data-tips-in-the-code-editor.md) - Refactor breakpoints article and incorporate review feedback
43+
- [Attach to a process running on a Docker container](../debugger/attach-to-process-running-in-docker-container.md) - Updates for Attach to Process for Docker with WSL scenarios
3244
- [Use the Memory windows in the Visual Studio debugger (C#, C++, Visual Basic, F#)](../debugger/memory-windows.md) - Update article on Memory windows
45+
- [IDiaSymbol::get_value](../debugger/debug-interface-access/idiasymbol-get-value.md) - Update example usage for IDiaSymbol::get_value
46+
- [Remote Debug ASP.NET on a Remote IIS Computer](../debugger/remote-debugging-aspnet-on-a-remote-iis-7-5-computer.md) - Add security information to remote debugging IIS articles
47+
- [Remote Debug ASP.NET Core on a Remote IIS Computer in Visual Studio](../debugger/remote-debugging-aspnet-on-a-remote-iis-computer.md) - Add security information to remote debugging IIS articles
48+
- [Remote Debug ASP.NET Core on IIS using an Azure VM from Visual Studio](../debugger/remote-debugging-azure.md) - Add security information to remote debugging IIS articles
49+
- [Debug your app with GitHub Copilot in Visual Studio](../debugger/debug-with-copilot.md) - Add Copilot content for Quick Actions light bulb
50+
- [Pass command-line arguments while debugging (C++)](../debugger/specify-command-line-arguments.md) - fix title
51+
- [Inspect variables in the Autos and Locals windows](../debugger/autos-and-locals-windows.md) - Update debugger content for viewing return values
3352
- [First look at the Visual Studio Debugger](../debugger/debugger-feature-tour.md) - Update debugger content for viewing return values
53+
- [Tabular visualizers in Visual Studio](../debugger/view-data-in-tabular-visualizer.md) - Add information about IntelliSense for IEnumerable visualizer
3454
- [IDiaStackWalkHelper::pdataForVA](../debugger/debug-interface-access/idiastackwalkhelper-pdataforva.md) - Add docs for 3 missing IDiaStackWalkHelper functions
3555
- [IDiaStackWalkHelper](../debugger/debug-interface-access/idiastackwalkhelper.md) - Add docs for 3 missing IDiaStackWalkHelper functions
3656
- [SymTagEnum](../debugger/debug-interface-access/symtagenum.md) - Fix broken links due to improper code escapes
@@ -39,29 +59,65 @@ Welcome to what's new in Visual Studio docs. The following sections provide deta
3959

4060
**Updated articles**
4161

62+
- [First look at deployment in Visual Studio](../deployment/deploying-applications-services-and-components.md) - Review and update
4263
- [Visual Studio Installer Projects Extension and .NET](../deployment/installer-projects-net-core.md) - Update .NET installer projects article
4364

4465
### Extensibility
4566

4667
**Updated articles**
4768

69+
- [Use Visual Studio editor extensibility](../extensibility/visualstudio.extensibility/editor/editor.md)
70+
- Fix missing and incorrect links
71+
- Add 17.12 documentation to VisualStudio.Extensibility
72+
- [Sign CLI Reference for VSIX Packages](../extensibility/dotnet-sign-cli-reference-vsix.md) - VSIX Signing: fix Sign CLI examples
4873
- [Overview](../extensibility/visualstudio.extensibility/diagnostics/visualstudio-extensibility-diagnostics-extension.md) - Add 17.12 documentation to VisualStudio.Extensibility
49-
- [Use Visual Studio editor extensibility](../extensibility/visualstudio.extensibility/editor/editor.md) - Add 17.12 documentation to VisualStudio.Extensibility
50-
- [Write to the Visual Studio output window](../extensibility/visualstudio.extensibility/output-window/output-window.md) - Updating docs for VS.Extensibility output window in 17.12
74+
- [Write to the Visual Studio output window](../extensibility/visualstudio.extensibility/output-window/output-window.md)
75+
- Add 17.12 documentation to VisualStudio.Extensibility
76+
- Updating docs for VS.Extensibility output window in 17.12
5177

5278
### IDE
5379

5480
**Updated articles**
5581

82+
- [What is Class Designer?](../ide/class-designer/designing-and-viewing-classes-and-types.md) - Update/fix class designer instructions
83+
- [Quick Actions](../ide/quick-actions.md)
84+
- Add Copilot content for Quick Actions light bulb
85+
- Add instruction for invoking quick actions, refactor
86+
- [What's new in Visual Studio 2022](../ide/whats-new-visual-studio-2022.md) - Update for 17.12
87+
- [Find code changes and other history with CodeLens](../ide/find-code-changes-and-other-history-with-codelens.md) - Add instructions for showing file-level indicators for CodeLens
5688
- [Code style preferences](../ide/code-styles-and-code-cleanup.md) - Clarify code cleanup instructions
57-
- [Create, work with, and delete Visual Studio projects and solutions](../ide/creating-solutions-and-projects.md) - Add new copy between VS instances features
58-
- [Configure trust settings for files and folders](../ide/reference/trust-settings.md) - Add VS 17.12 feature MOTW (Mark of the Web)
89+
- [Create, work with, and delete Visual Studio projects and solutions](../ide/creating-solutions-and-projects.md) - Add new copy between Visual Studio instances features
90+
- [Get better answers by setting the context for GitHub Copilot Chat in Visual Studio](../ide/copilot-chat-context.md) - Add guided chat experience for 17.12
91+
- [Visual Studio Developer Command Prompt and Developer PowerShell](../ide/reference/command-prompt-powershell.md) - Update project location instructions
92+
- [What is the GitHub Copilot Chat experience for Visual Studio?](../ide/visual-studio-github-copilot-chat.md) - Add code referencing update
93+
- [Configure trust settings for files and folders](../ide/reference/trust-settings.md) - Add Visual Studio 17.12 feature motw
5994
- [Find in Files](../ide/find-in-files.md) - Update Find in Files for 17.12 for refresh and modify options
6095
- [Use Visual Studio search](../ide/visual-studio-search.md) - Update for 17.12 for new All In One Search features
61-
- [Quick Actions](../ide/quick-actions.md) - Add instruction for invoking quick actions, refactor
96+
- [Error List window](../ide/reference/error-list-window.md) - Copy from error list: feature update for 17.12
6297
- [Fonts and Colors, Environment, Options dialog box](../ide/reference/fonts-and-colors-environment-options-dialog-box.md) - Add collapsible text indicators to table
98+
- [Change fonts, colors, and themes in Visual Studio](../ide/how-to-change-fonts-and-colors-in-visual-studio.md) - Preserve font settings across themes
6399
- [Sign in to Visual Studio with accounts that require multifactor authentication (MFA)](../ide/work-with-multi-factor-authentication.md) - Add access denied text
64100

101+
### JavaScript
102+
103+
**Updated articles**
104+
105+
- [MSBuild reference for the JavaScript Project System](../javascript/javascript-project-system-msbuild-reference.md) - Update example code for ShouldRunBuildScript in JS projects
106+
- [Tutorial: Create an ASP.NET Core app with Angular in Visual Studio](../javascript/tutorial-asp-net-core-with-angular.md) - Add links related to publish output for ASP.NET Core and JSTS
107+
- [Tutorial: Create an ASP.NET Core app with React in Visual Studio](../javascript/tutorial-asp-net-core-with-react.md)
108+
- Add links related to publish output for ASP.NET Core and JSTS
109+
- Updates for JS project templates related to Vite CLI
110+
- [Tutorial: Create an ASP.NET Core app with Vue in Visual Studio](../javascript/tutorial-asp-net-core-with-vue.md)
111+
- Add links related to publish output for ASP.NET Core and JSTS
112+
- Updates for JS project templates related to Vite CLI
113+
114+
### MSBuild
115+
116+
**Updated articles**
117+
118+
- [Task writing](../msbuild/task-writing.md) - Add section with link to packaging info
119+
- [MSBuild](../msbuild/msbuild.md) - Review and update
120+
65121
### Profiling
66122

67123
**Updated articles**
@@ -74,6 +130,14 @@ Welcome to what's new in Visual Studio docs. The following sections provide deta
74130

75131
- [Debug and analyze unit tests with Test Explorer](../test/debug-unit-tests-with-test-explorer.md) - Add content for debugging unit tests with Copilot
76132

133+
### Version control
134+
135+
**Updated articles**
136+
137+
- [Make a Git commit in Visual Studio](../version-control/git-make-commit.md) - Add note about rename notification
138+
- [Create a Git repository from Visual Studio](../version-control/git-create-repository.md) - Updates for 17.12 support for internal repo
139+
- [About Git in Visual Studio](../version-control/git-with-visual-studio.md) - Add doc for Copy GitHub Permalink feature
140+
77141
### Community contributors
78142

79143
The following people contributed to the Visual Studio docs during this period. Thank you! Learn how to contribute by following the links under "Get involved" in the [what's new landing page](index.yml).
@@ -193,8 +257,8 @@ The following people contributed to the Visual Studio docs during this period. T
193257

194258
**Updated articles**
195259

196-
- [Case study: Isolate a performance issue (C#, Visual Basic, F#)](../profiling/isolate-performance-issue.md) - Update Copilot information in the VS Profiling case studies
197-
- [Case Study: Beginner's guide to optimizing code and reducing compute costs (C#, Visual Basic, C++, F#)](../profiling/optimize-code-using-profiling-tools.md) - Update Copilot information in the VS Profiling case studies
260+
- [Case study: Isolate a performance issue (C#, Visual Basic, F#)](../profiling/isolate-performance-issue.md) - Update Copilot information in the Visual Studio Profiling case studies
261+
- [Case Study: Beginner's guide to optimizing code and reducing compute costs (C#, Visual Basic, C++, F#)](../profiling/optimize-code-using-profiling-tools.md) - Update Copilot information in the Visual Studio Profiling case studies
198262
- [Identify hot paths with a flame graph (C#, Visual Basic, C++, F#)](../profiling/flame-graph.md) - Update Flame Graph article with additional context and information
199263

200264
### Windows
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading

0 commit comments

Comments
 (0)