VSMac EOL.

dotnet · Nov 8, 2023 · 23b5dbb · 23b5dbb
1 parent 7ad1239
commit 23b5dbb
Show file tree

Hide file tree

Showing 23 changed files with 71 additions and 0 deletions.
diff --git a/docs/android/linking.md b/docs/android/linking.md
@@ -30,6 +30,8 @@ Linker behavior can be configured for each build configuration of your app. By d
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 1. In the **Solution Window**, right-click on your .NET MAUI app project and select **Properties**.
 1. In the **Project Properties** window, select the **Build > Android > Linker** tab.
 1. In the **Project Properties** window, ensure the **Configuration** drop-down is set to **Release** and set the **Linker Behavior** drop-down to your desired linker behavior:

diff --git a/docs/get-started/first-app.md b/docs/get-started/first-app.md
@@ -205,6 +205,8 @@ If your app fails to compile, review [Troubleshooting known issues](../troublesh
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 ## Prerequisites
 
 - Visual Studio 2022 for Mac 17.4 or greater, with the .NET, .NET MAUI, Android, and iOS workloads installed. For more information, see [Installation](installation.md?tabs=vsmac).

diff --git a/docs/get-started/installation.md b/docs/get-started/installation.md
@@ -46,6 +46,8 @@ Alternatively, to deploy debug builds of your app directly from Windows to your
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 To start developing native, cross-platform .NET MAUI apps on macOS, install Visual Studio 2022 for Mac 17.4 or greater by following the [installation](#installation) steps.
 
 ## Prerequisites

diff --git a/docs/includes/vsmac-eol.md b/docs/includes/vsmac-eol.md
@@ -0,0 +1,9 @@
+---
+ms.topic: include
+ms.date: 11/08/2023
+---
+
+> [!NOTE]
+> Visual Studio for Mac is scheduled for retirement by August 31 2024 in accordance with [Microsoft's Modern Lifecycle Policy](/lifecycle/policies/modern). Visual Studio for Mac 17.6 will continue to be supported until August 31 2024, with servicing updates for security issues and updated platforms from Apple. For more information, including alternative options for developing on a Mac, see [What's happening to Visual Studio for Mac?](/visualstudio/mac/what-happened-to-vs-for-mac).
+>
+> To use Visual Studio for Mac with .NET 8, enable the **Visual Studio > Preferences > Other > Preview Features > Use the .NET 8 SDK if installed (requires restart)** checkbox.
diff --git a/docs/ios/apple-account-management.md b/docs/ios/apple-account-management.md
@@ -48,6 +48,8 @@ If you have an individual Apple Developer account, as opposed to an enterprise a
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 1. In Visual Studio for Mac, go to **Visual Studio > Preferences > Publishing > Apple Developer Account**, click on the **Add** button and select **Individual Account...** or **Enterprise Account...**:
 
     :::image type="content" source="media/apple-account-management/vsmac/add-account.png" alt-text="Add an Apple Developer Account to Visual Studio for Mac.":::

diff --git a/docs/ios/capabilities.md b/docs/ios/capabilities.md
@@ -49,6 +49,8 @@ In Visual Studio, all capabilities are added to your app's *Entitlements.plist*
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 1. In Visual Studio for Mac, enable automatic provisioning for your project. For more information, see [Enable automatic provisioning](~/ios/device-provisioning/automatic-provisioning.md#enable-automatic-provisioning).
 1. In the **Solution Window**, double-click the *Entitlements.plist* file from the *Platforms > iOS* folder of your .NET MAUI app project to open it in the entitlements editor. Then, change from the **Source** view to the **Entitlements** view:
 

diff --git a/docs/ios/deployment/publish-ad-hoc.md b/docs/ios/deployment/publish-ad-hoc.md
@@ -104,6 +104,8 @@ Visual Studio can publish a .NET MAUI iOS app for ad-hoc distribution. For infor
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 [!INCLUDE [Publish](../includes/publish-vsmac.md)]
 
 <!-- markdownlint-disable MD029 -->

diff --git a/docs/ios/deployment/publish-app-store.md b/docs/ios/deployment/publish-app-store.md
@@ -106,6 +106,8 @@ For information about publishing an iOS app using the Command Line Interface (CL
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 [!INCLUDE [Publish](../includes/publish-vsmac.md)]
 
 <!-- markdownlint-disable MD029 -->

diff --git a/docs/ios/deployment/publish-in-house.md b/docs/ios/deployment/publish-in-house.md
@@ -135,6 +135,8 @@ Visual Studio can publish a .NET MAUI iOS app for in-house distribution. For inf
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 [!INCLUDE [Publish](../includes/publish-vsmac.md)]
 
 <!-- markdownlint-disable MD029 -->

diff --git a/docs/ios/device-provisioning/automatic-provisioning.md b/docs/ios/device-provisioning/automatic-provisioning.md
@@ -39,6 +39,8 @@ Once you've added your Apple Developer Account to Visual Studio, you need to ena
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 1. In the **Solution Window**, double-click the **Info.plist** file from the **Platforms > iOS** folder of your .NET MAUI app project to open it in the editor.
 
 1. In the **Info.plist** editor, change from the **Source** view to the **Application** view:

diff --git a/docs/ios/device-provisioning/manual-provisioning.md b/docs/ios/device-provisioning/manual-provisioning.md
@@ -36,6 +36,8 @@ Once you've added your Apple Developer Account to Visual Studio, you need to gen
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 1. In Visual Studio for Mac, go to **Visual Studio > Preferences > Publishing > Apple Developer Account**.
 1. In the **Apple Developer Accounts** window, select a team and then select **View Details**.
 1. In the **Details** window, select **Create Certificate** and then select **Apple Development** or **iOS Development**. A new signing identity will be created and will sync with Apple if you have the correct permissions.
@@ -134,6 +136,8 @@ The provisioning profiles will be downloaded on Windows, and exported to your Ma
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 1. In Visual Studio for Mac, go to **Visual Studio > Preferences > Publishing > Apple Developer Account**.
 1. In the **Apple Developer Accounts** window, select a team and click the **View Details...** button.
 1. In the **Details** window, verify that the new profile appears in the **Provisioning Profiles** list. You may need to restart Visual Studio for Mac to refresh the list.
@@ -162,6 +166,8 @@ After manually creating the development provisioning profile, and installing it
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 1. In the **Solution Window**, right-click on your .NET MAUI app project and select **Properties**.
 1. In the **Project Properties** window, select the **Build > App Info** tab and ensure that the value of the **Application ID** field corresponds to the format of the App ID you created earlier.
 1. In the **Solution Window**, double-click the **Info.plist** file from the **Platforms > iOS** folder of your .NET MAUI app project to open it in the editor.

diff --git a/docs/ios/entitlements.md b/docs/ios/entitlements.md
@@ -47,6 +47,8 @@ Entitlements can be configured in Visual Studio by double-clicking the *Entitlem
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 1. In the **Solution Window**, double-click the *Entitlements.plist* file from the *Platforms > iOS* folder of your .NET MAUI app project to open it in the entitlements editor. Then, change from the **Source** view to the **Entitlements** view:
 
     :::image type="content" source="media/entitlements/editor-source-vsmac.png" alt-text="Visual Studio for Mac iOS entitlements editor source view.":::
@@ -85,6 +87,8 @@ A .NET MAUI iOS app must be configured to consume the entitlements defined in th
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 1. In the **Solution Window**, right-click on your .NET MAUI app project and select **Properties**.
 1. In the **Project Properties** window, select the **Build > iOS > Bundle Signing** tab and click the **...** button next to the **Custom Entitlements** field:
 

diff --git a/docs/ios/includes/deploy.md b/docs/ios/includes/deploy.md
@@ -28,6 +28,8 @@ After configuring provisioning in your .NET MAUI app project, the app can be dep
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 1. In the **Solution Window**, double-click the **Info.plist** file from the **Platforms > iOS** folder of your .NET MAUI app project to open it in the editor.
 1. In the **Info.plist** editor, change from the **Source** view to the **Application** view:
 

diff --git a/docs/ios/includes/distribution-certificate.md b/docs/ios/includes/distribution-certificate.md
@@ -26,6 +26,8 @@ To create a distribution certificate:
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 1. In Visual Studio for Mac, go to **Visual Studio > Preferences > Publishing > Apple Developer Account**.
 1. In the **Apple Developer Accounts** window, select a team and click the **View Details...** button.
 1. In the **Details** window, click **Create Certificate** and select **Apple Distribution** or **iOS Distribution**. A new signing identity will be created and will sync with Apple provided that you have the correct permissions.

diff --git a/docs/ios/includes/download-profiles.md b/docs/ios/includes/download-profiles.md
@@ -22,6 +22,8 @@ The provisioning profiles are downloaded on Windows, and exported to your Mac bu
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 1. In Visual Studio for Mac, go to **Visual Studio > Preferences > Publishing > Apple Developer Account**.
 1. In the **Apple Developer Accounts** window, select your team and click **View Details**.
 1. In the **Details** window, verify that the new profile appears in the **Provisioning Profiles** list. You may need to restart Visual Studio for Mac to refresh the list.

diff --git a/docs/ios/linking.md b/docs/ios/linking.md
@@ -21,6 +21,8 @@ no-loc: [ ILLink ]
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 1. In the **Solution Window**, right-click on your .NET MAUI app project and select **Properties**.
 1. In the **Project Properties** window, select the **Build > iOS > Build** tab.
 1. In the **Project Properties** window, ensure the **Configuration** drop-down is set to **Release** and set the **Linker behavior** drop-down to your desired linker behavior:

diff --git a/docs/ios/wireless-deployment.md b/docs/ios/wireless-deployment.md
@@ -71,6 +71,8 @@ After wirelessly pairing your device to Xcode, provisioned .NET MAUI iOS apps ca
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 1. Ensure that your iOS device is wirelessly paired to your Mac build host. For more information, see [Pair an iOS device](#pair-an-ios-device).
 1. In the Visual Studio for Mac toolbar, ensure that the debug target is set to your connected iOS device:
 

diff --git a/docs/mac-catalyst/capabilities.md b/docs/mac-catalyst/capabilities.md
@@ -45,6 +45,8 @@ Once you've created a provisioning profile it must be downloaded by Visual Studi
 1. In the *Details* window, verify that the new profile appears in the *Provisioning Profiles* list. You may need to restart Visual Studio for Mac to refresh the list.
 1. In the *Details* dialog, click the *Download All Profiles* button.
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 The provisioning profile will then be available for use.
 
 > [!NOTE]

diff --git a/docs/mac-catalyst/entitlements.md b/docs/mac-catalyst/entitlements.md
@@ -44,6 +44,8 @@ Entitlements can be configured in Visual Studio for Mac by double-clicking the *
 
 It may also be necessary to set privacy keys in *Info.plist*, for certain entitlements.
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 ## Consume entitlements
 
 A .NET MAUI Mac Catalyst app must be configured to consume the entitlements defined in the *Entitlements.plist* file:
@@ -60,6 +62,8 @@ A .NET MAUI Mac Catalyst app must be configured to consume the entitlements defi
 
 1. In the **Project Properties** window, click the **OK** button to close the window.
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 > [!IMPORTANT]
 > The custom entitlements field must be set separately for each build configuration for your app.
 

diff --git a/docs/mac-catalyst/linking.md b/docs/mac-catalyst/linking.md
@@ -19,4 +19,6 @@ To configure linker behavior in Visual Studio for Mac:
 
 1. In the **Project Properties** window, click the **OK** button.
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 [!INCLUDE [Control the linker](../includes/linker-control.md)]
diff --git a/docs/macios/info-plist.md b/docs/macios/info-plist.md
@@ -37,6 +37,8 @@ Visual Studio's *Info.plist* editor contains two views of the data:
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 Visual Studio for Mac's *Info.plist* editor contains three views of the data:
 
 - Source, which enables you to edit keys and values manually:
@@ -86,6 +88,8 @@ In **Solution Explorer**, right-click on your .NET MAUI app project and select *
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 In the **Solution Window**, right-click on your .NET MAUI app project and select **Properties**. Then, in the **Project Properties** window, select the **Build > App Info** tab. The **Application Title** field lists the application name.
 
 ---
@@ -106,6 +110,8 @@ In **Solution Explorer**, right-click on your .NET MAUI app project and select *
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 In the **Solution Window**, right-click on your .NET MAUI app project and select **Properties**. Then, in the **Project Properties** window, select the **Build > App Info** tab. The **Application ID** field lists the bundle identifier.
 
 ---
@@ -126,6 +132,8 @@ In **Solution Explorer**, right-click on your .NET MAUI app project and select *
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 In the **Solution Window**, right-click on your .NET MAUI app project and select **Properties**. Then, in the **Project Properties** window, select the **Build > App Info** tab. The **Application Display Version** field lists the application display version.
 
 ---
@@ -146,6 +154,8 @@ In **Solution Explorer**, right-click on your .NET MAUI app project and select *
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 In the **Solution Window**, right-click on your .NET MAUI app project and select **Properties**. Then, in the **Project Properties** window, select the **Build > App Info** tab. The **Application Version** field lists the application version.
 
 ---

diff --git a/docs/user-interface/live-visual-tree.md b/docs/user-interface/live-visual-tree.md
@@ -20,6 +20,8 @@ When your .NET MAUI app is running in debug configuration, with the debugger att
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 When your .NET MAUI app is running in debug configuration, with the debugger attached, the Live Visual Tree window can be opened by selecting **View > Debug Windows > Live Visual Tree** from the Visual Studio for Mac menu bar:
 
 :::image type="content" source="media/live-visual-tree/live-visual-tree-vsmac.png" alt-text="Screenshot of the Live Visual Tree window in Visual Studio for Mac.":::
@@ -46,6 +48,8 @@ Just My XAML can be permanently disabled by selecting **Debug > Options > XAML H
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 The view of the UI elements can be simplified using a feature called Just My XAML. Clicking the **Show Just My XAML** button enables the feature and shows just the UI elements from your XAML in the visual tree:
 
 :::image type="content" source="media/live-visual-tree/just-my-xaml-vsmac.png" alt-text="Screenshot of all UI elements in the Live Visual Tree window in Visual Studio for Mac.":::

diff --git a/docs/xaml/hot-reload.md b/docs/xaml/hot-reload.md
@@ -38,6 +38,8 @@ Then, on iOS in your build settings, check that the Linker is set to "Don't Link
 # [Visual Studio for Mac](#tab/vsmac)
 <!-- markdownlint-enable MD025 -->
 
+[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]
+
 XAML Hot Reload is enabled by default in Visual Studio 2022 for Mac. If it's been previously disabled, it can be enabled by selecting **Visual Studio > Preferences > Other > XAML Hot Reload** from the Visual Studio menu bar. Next, in the **Preferences** dialog box, ensure that the **Enable XAML Hot Reload**, and **.NET MAUI** options are checked:
 
 :::image type="content" source="media/hot-reload/vsmac-preferences.png" alt-text="XAML Hot Reload options for .NET MAUI in Visual Studio for Mac":::
Original file line number	Diff line number	Diff line change
Expand Up		@@ -19,4 +19,6 @@ To configure linker behavior in Visual Studio for Mac:

		1. In the Project Properties window, click the OK button.

		[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)]

		[!INCLUDE [Control the linker](../includes/linker-control.md)]