diff --git a/docs/android/linking.md b/docs/android/linking.md index b86bef10fb..2f2becd554 100644 --- 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) +[!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 index 33c240f543..df367a47e8 100644 --- 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) +[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol-net8.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 index 043b1741c0..510eb93b2d 100644 --- 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) +[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol-net8.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-net8.md b/docs/includes/vsmac-eol-net8.md new file mode 100644 index 0000000000..7a577f7429 --- /dev/null +++ b/docs/includes/vsmac-eol-net8.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/includes/vsmac-eol.md b/docs/includes/vsmac-eol.md new file mode 100644 index 0000000000..d89ce8dc98 --- /dev/null +++ b/docs/includes/vsmac-eol.md @@ -0,0 +1,7 @@ +--- +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). diff --git a/docs/ios/apple-account-management.md b/docs/ios/apple-account-management.md index a84478d7b1..f56553b310 100644 --- 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) +[!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 index dada49d5cc..9b2aede18c 100644 --- 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) +[!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 index 5ff57e59d6..3cfead7095 100644 --- 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) +[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)] + [!INCLUDE [Publish](../includes/publish-vsmac.md)] diff --git a/docs/ios/deployment/publish-app-store.md b/docs/ios/deployment/publish-app-store.md index c345d3f7f9..5477853942 100644 --- 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) +[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)] + [!INCLUDE [Publish](../includes/publish-vsmac.md)] diff --git a/docs/ios/deployment/publish-in-house.md b/docs/ios/deployment/publish-in-house.md index 0b98be3138..5926615b8f 100644 --- 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) +[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)] + [!INCLUDE [Publish](../includes/publish-vsmac.md)] diff --git a/docs/ios/device-provisioning/automatic-provisioning.md b/docs/ios/device-provisioning/automatic-provisioning.md index 8c527d3e41..891bbb0bcc 100644 --- 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) +[!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 index 65c11d2fde..fff8f5165e 100644 --- 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) +[!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) +[!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) +[!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 index d5bce18beb..f600e3e73c 100644 --- 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) +[!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) +[!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 index 47a0bcbde4..f7d2b0ea44 100644 --- 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) +[!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 index 9af7d51dbf..3493af5b5a 100644 --- 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) +[!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 index 3b580d9cdc..82e5d1606c 100644 --- 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) +[!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 index d1b09a18bc..9fa2366f1d 100644 --- a/docs/ios/linking.md +++ b/docs/ios/linking.md @@ -21,6 +21,8 @@ no-loc: [ ILLink ] # [Visual Studio for Mac](#tab/vsmac) +[!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 index 81444707db..2a0f6e40b2 100644 --- 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) +[!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 index 8ea5c4ff06..0630bbdaa4 100644 --- a/docs/mac-catalyst/capabilities.md +++ b/docs/mac-catalyst/capabilities.md @@ -38,6 +38,8 @@ Once you've created an App ID you must create a provisioning profile for the App ## Download provisioning profiles +[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)] + Once you've created a provisioning profile it must be downloaded by Visual Studio for Mac: 1. In Visual Studio for Mac, go to *Visual Studio > Preferences > Publishing > Apple Developer Account*. diff --git a/docs/mac-catalyst/entitlements.md b/docs/mac-catalyst/entitlements.md index 8c15b6b6ab..0f896b0544 100644 --- a/docs/mac-catalyst/entitlements.md +++ b/docs/mac-catalyst/entitlements.md @@ -30,6 +30,8 @@ To add a new entitlements file to your .NET MAUI app project, add a new XML file ## Set entitlements +[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)] + Entitlements can be configured in Visual Studio for Mac by double-clicking the *Entitlements.plist* file to open it in the entitlements editor: 1. In Visual Studio for Mac's **Solution Window**, double-click the *Entitlements.plist* file from the *Platforms > MacCatalyst* folder of your .NET MAUI app project to open it in the entitlements editor. Then, change from the **Source** view to the **Entitlements** view: @@ -46,6 +48,8 @@ It may also be necessary to set privacy keys in *Info.plist*, for certain entitl ## Consume entitlements +[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)] + A .NET MAUI Mac Catalyst app must be configured to consume the entitlements defined in the *Entitlements.plist* file: 1. In Visual Studio for Mac's **Solution Window**, right-click on your .NET MAUI app project and select **Properties**. diff --git a/docs/mac-catalyst/linking.md b/docs/mac-catalyst/linking.md index 6177bf3e20..0c15ab556f 100644 --- a/docs/mac-catalyst/linking.md +++ b/docs/mac-catalyst/linking.md @@ -9,6 +9,8 @@ no-loc: [ ILLink ] [!INCLUDE [Linker introduction and behavior](../macios/includes/linker-behavior.md)] +[!INCLUDE [Visual Studio for Mac end of life](~/includes/vsmac-eol.md)] + To configure linker behavior in Visual Studio for Mac: 1. In the **Solution Window**, right-click on your .NET MAUI app project and select **Properties**. diff --git a/docs/macios/info-plist.md b/docs/macios/info-plist.md index 88aa28e228..2ffba8c3da 100644 --- 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) +[!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) +[!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) +[!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) +[!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) +[!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 index 25f5363507..7e52bda7b8 100644 --- 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) +[!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) +[!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 index edcc8248d9..5c29eebfd6 100644 --- 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) +[!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":::