diff --git a/docs/get-started/first-app.md b/docs/get-started/first-app.md index 75a9cf016..3b0e62ac1 100644 --- a/docs/get-started/first-app.md +++ b/docs/get-started/first-app.md @@ -1,8 +1,9 @@ --- title: "Build your first .NET MAUI app" description: "Learn how to create and run your first .NET MAUI app in Visual Studio 2022 on Windows, or Visual Studio 2022 for Mac." -ms.date: 11/01/2022 +ms.date: 11/10/2023 zone_pivot_groups: devices-deployment +monikerRange: ">=net-maui-8.0" --- # Build your first app @@ -15,7 +16,7 @@ In this tutorial, you'll learn how to create and run your first .NET Multi-platf ## Prerequisites -- Visual Studio 2022 17.3 or greater, with the .NET Multi-platform App UI workload installed. For more information, see [Installation](installation.md?tabs=vswin). +- Visual Studio 2022 17.8 or greater, with the .NET Multi-platform App UI workload installed. For more information, see [Installation](installation.md?tabs=vswin). ## Create an app @@ -116,9 +117,9 @@ In this tutorial, you'll create your first .NET MAUI app in Visual Studio 2022 a :::image type="content" source="media/first-app/vs/android-device-manager.png" alt-text="Android Device Manager window."::: -01. In the Visual Studio toolbar, press the **Pixel 5 - API 30 (Android 11.0 - API 30)** button to build and run the app: +01. In the Visual Studio toolbar, press the **Pixel 5 - API 34 (Android 14.0 - API 33)** button to build and run the app: - :::image type="content" source="media/first-app/vs/pixel5-api30.png" alt-text="Pixel 5 API 30 emulator button."::: + :::image type="content" source="media/first-app/vs/pixel5-api-34.png" alt-text="Pixel 5 API 34 emulator button."::: Visual Studio will start the Android emulator, build the app, and deploy the app to the emulator. @@ -127,7 +128,7 @@ In this tutorial, you'll create your first .NET MAUI app in Visual Studio 2022 a 01. In the running app in the Android emulator, press the **Click me** button several times and observe that the count of the number of button clicks is incremented. - :::image type="content" source="media/first-app/vs/running-app.png" alt-text="App running in the Android emulator." lightbox="media/first-app/vs/running-app-large.png"::: + :::image type="content" source="media/first-app/vs/android-running-app.png" alt-text="App running in the Android emulator."::: ## Troubleshooting @@ -205,11 +206,14 @@ 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)] +[!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). +- Visual Studio 2022 for Mac 17.6 with the .NET, .NET MAUI, Android, and iOS workloads installed. For more information, see [Installation](installation.md?tabs=vsmac). + +> [!IMPORTANT] +> 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. ## Create an app @@ -282,7 +286,7 @@ In this tutorial, you'll create your first .NET MAUI app in Visual Studio 2022 f :::image type="content" source="media/first-app/vsmac/android-device-manager.png" alt-text="Close the Android Device Manager window."::: -01. In the Visual Studio 2022 for Mac toolbar, change the debug target to **Pixel 5 - API 31 (API 31)**: +01. In the Visual Studio 2022 for Mac toolbar, change the debug target to **Pixel 5 - API 34 (API 34)**: :::image type="content" source="media/first-app/vsmac/android-pixel5-debug-target.png" alt-text="Set the created Android emulator as the debug target."::: @@ -322,12 +326,20 @@ In this tutorial, you'll create your first .NET MAUI app in Visual Studio 2022 f :::zone pivot="devices-maccatalyst" -06. In the Visual Studio 2022 for Mac toolbar, ensure that the debug target is set to **My Mac**: +06. In the Visual Studio 2022 for Mac toolbar, ensure that the debug target is set to **My Mac (MacCatalyst)**: :::image type="content" source="media/first-app/vsmac/mac-debug-target.png" alt-text="Ensure the debug target is set to My Mac."::: +01. In Visual Studio 2022 for Mac, right-click on the **MyMauiApp** project and select **Edit Project File**. Then, in the project file editor insert the following XML before the first ``: + + ```xml + + maccatalyst-x64;maccatalyst-arm64 + + ``` + 01. In the Visual Studio 2022 for Mac toolbar, press the **Play** button to launch the app on your Mac: :::image type="content" source="media/first-app/vsmac/mac-run.png" alt-text="Launch the app on your Mac."::: diff --git a/docs/get-started/installation.md b/docs/get-started/installation.md index 69c6c0fda..5cf8e41d7 100644 --- a/docs/get-started/installation.md +++ b/docs/get-started/installation.md @@ -46,13 +46,13 @@ 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)] +[!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. +To start developing native, cross-platform .NET MAUI apps on macOS, install Visual Studio 2022 for Mac 17.6 by following the [installation](#installation) steps. ## Prerequisites -- Visual Studio 2022 for Mac 17.4 or greater. For information about supported operating systems, hardware, supported languages, and additional requirements and guidance, see [Visual Studio 2022 for Mac System Requirements](/visualstudio/releases/2022/mac-system-requirements). +- Visual Studio 2022 for Mac 17.6. For information about supported operating systems, hardware, supported languages, and additional requirements and guidance, see [Visual Studio 2022 for Mac System Requirements](/visualstudio/releases/2022/mac-system-requirements). To build, sign, and deploy .NET MAUI apps for iOS or macOS, you'll also need: diff --git a/docs/get-started/media/first-app/vs/additional-information.png b/docs/get-started/media/first-app/vs/additional-information.png index fbafff3c1..48a9e6380 100644 Binary files a/docs/get-started/media/first-app/vs/additional-information.png and b/docs/get-started/media/first-app/vs/additional-information.png differ diff --git a/docs/get-started/media/first-app/vs/android-debug-target.png b/docs/get-started/media/first-app/vs/android-debug-target.png index c126a8a12..de5b82246 100644 Binary files a/docs/get-started/media/first-app/vs/android-debug-target.png and b/docs/get-started/media/first-app/vs/android-debug-target.png differ diff --git a/docs/get-started/media/first-app/vs/android-device-manager.png b/docs/get-started/media/first-app/vs/android-device-manager.png index 2e84970f2..9f8fc082e 100644 Binary files a/docs/get-started/media/first-app/vs/android-device-manager.png and b/docs/get-started/media/first-app/vs/android-device-manager.png differ diff --git a/docs/get-started/media/first-app/vs/android-running-app.png b/docs/get-started/media/first-app/vs/android-running-app.png new file mode 100644 index 000000000..0e0a01f22 Binary files /dev/null and b/docs/get-started/media/first-app/vs/android-running-app.png differ diff --git a/docs/get-started/media/first-app/vs/ios-chosen-debug-target.png b/docs/get-started/media/first-app/vs/ios-chosen-debug-target.png index 8c5a8be72..446136aa0 100644 Binary files a/docs/get-started/media/first-app/vs/ios-chosen-debug-target.png and b/docs/get-started/media/first-app/vs/ios-chosen-debug-target.png differ diff --git a/docs/get-started/media/first-app/vs/ios-debug-target.png b/docs/get-started/media/first-app/vs/ios-debug-target.png index 848848d60..dcf28a24a 100644 Binary files a/docs/get-started/media/first-app/vs/ios-debug-target.png and b/docs/get-started/media/first-app/vs/ios-debug-target.png differ diff --git a/docs/get-started/media/first-app/vs/ios-running-app.png b/docs/get-started/media/first-app/vs/ios-running-app.png index f25ecf84b..0ce8f42da 100644 Binary files a/docs/get-started/media/first-app/vs/ios-running-app.png and b/docs/get-started/media/first-app/vs/ios-running-app.png differ diff --git a/docs/get-started/media/first-app/vs/new-android-device.png b/docs/get-started/media/first-app/vs/new-android-device.png index 867d4a354..9f662e710 100644 Binary files a/docs/get-started/media/first-app/vs/new-android-device.png and b/docs/get-started/media/first-app/vs/new-android-device.png differ diff --git a/docs/get-started/media/first-app/vs/pixel5-api-34.png b/docs/get-started/media/first-app/vs/pixel5-api-34.png new file mode 100644 index 000000000..19c7af5bc Binary files /dev/null and b/docs/get-started/media/first-app/vs/pixel5-api-34.png differ diff --git a/docs/get-started/media/first-app/vs/pixel5-api30.png b/docs/get-started/media/first-app/vs/pixel5-api30.png deleted file mode 100644 index 94f6616d1..000000000 Binary files a/docs/get-started/media/first-app/vs/pixel5-api30.png and /dev/null differ diff --git a/docs/get-started/media/first-app/vs/restored-dependencies.png b/docs/get-started/media/first-app/vs/restored-dependencies.png index d894c2a5e..9d0e0e375 100644 Binary files a/docs/get-started/media/first-app/vs/restored-dependencies.png and b/docs/get-started/media/first-app/vs/restored-dependencies.png differ diff --git a/docs/get-started/media/first-app/vs/running-app-large.png b/docs/get-started/media/first-app/vs/running-app-large.png deleted file mode 100644 index b179d0e8b..000000000 Binary files a/docs/get-started/media/first-app/vs/running-app-large.png and /dev/null differ diff --git a/docs/get-started/media/first-app/vs/running-app.png b/docs/get-started/media/first-app/vs/running-app.png deleted file mode 100644 index 5a7af6ec1..000000000 Binary files a/docs/get-started/media/first-app/vs/running-app.png and /dev/null differ diff --git a/docs/get-started/media/first-app/vs/windows-debug-target.png b/docs/get-started/media/first-app/vs/windows-debug-target.png index 02643c208..3563a606b 100644 Binary files a/docs/get-started/media/first-app/vs/windows-debug-target.png and b/docs/get-started/media/first-app/vs/windows-debug-target.png differ diff --git a/docs/get-started/media/first-app/vs/windows-run-button.png b/docs/get-started/media/first-app/vs/windows-run-button.png index fd45885ac..fb643c427 100644 Binary files a/docs/get-started/media/first-app/vs/windows-run-button.png and b/docs/get-started/media/first-app/vs/windows-run-button.png differ diff --git a/docs/get-started/media/first-app/vs/windows-running-app.png b/docs/get-started/media/first-app/vs/windows-running-app.png index 7cb368e9f..10a9d6762 100644 Binary files a/docs/get-started/media/first-app/vs/windows-running-app.png and b/docs/get-started/media/first-app/vs/windows-running-app.png differ diff --git a/docs/get-started/media/first-app/vsmac/android-create-emulator.png b/docs/get-started/media/first-app/vsmac/android-create-emulator.png index 5ea1a25d5..e7506a94b 100644 Binary files a/docs/get-started/media/first-app/vsmac/android-create-emulator.png and b/docs/get-started/media/first-app/vsmac/android-create-emulator.png differ diff --git a/docs/get-started/media/first-app/vsmac/android-device-manager.png b/docs/get-started/media/first-app/vsmac/android-device-manager.png index 53c836d1c..5792f2c47 100644 Binary files a/docs/get-started/media/first-app/vsmac/android-device-manager.png and b/docs/get-started/media/first-app/vsmac/android-device-manager.png differ diff --git a/docs/get-started/media/first-app/vsmac/android-pixel5-debug-target.png b/docs/get-started/media/first-app/vsmac/android-pixel5-debug-target.png index 3adea375b..8b6bdf55a 100644 Binary files a/docs/get-started/media/first-app/vsmac/android-pixel5-debug-target.png and b/docs/get-started/media/first-app/vsmac/android-pixel5-debug-target.png differ diff --git a/docs/get-started/media/first-app/vsmac/android-pixel5-run.png b/docs/get-started/media/first-app/vsmac/android-pixel5-run.png index 61d804c22..f85f0ba6e 100644 Binary files a/docs/get-started/media/first-app/vsmac/android-pixel5-run.png and b/docs/get-started/media/first-app/vsmac/android-pixel5-run.png differ diff --git a/docs/get-started/media/first-app/vsmac/ios-debug-target.png b/docs/get-started/media/first-app/vsmac/ios-debug-target.png index 27508dc16..07a057c2a 100644 Binary files a/docs/get-started/media/first-app/vsmac/ios-debug-target.png and b/docs/get-started/media/first-app/vsmac/ios-debug-target.png differ diff --git a/docs/get-started/media/first-app/vsmac/ios-run.png b/docs/get-started/media/first-app/vsmac/ios-run.png index 4120c03cc..f3498fb35 100644 Binary files a/docs/get-started/media/first-app/vsmac/ios-run.png and b/docs/get-started/media/first-app/vsmac/ios-run.png differ diff --git a/docs/get-started/media/first-app/vsmac/mac-debug-target.png b/docs/get-started/media/first-app/vsmac/mac-debug-target.png index 1b08c8751..040d0323c 100644 Binary files a/docs/get-started/media/first-app/vsmac/mac-debug-target.png and b/docs/get-started/media/first-app/vsmac/mac-debug-target.png differ diff --git a/docs/get-started/media/first-app/vsmac/mac-run.png b/docs/get-started/media/first-app/vsmac/mac-run.png index f5d9c4aa3..75385d68a 100644 Binary files a/docs/get-started/media/first-app/vsmac/mac-run.png and b/docs/get-started/media/first-app/vsmac/mac-run.png differ diff --git a/docs/get-started/media/first-app/vsmac/project-dependencies-restored.png b/docs/get-started/media/first-app/vsmac/project-dependencies-restored.png index e7390114a..a4fbab543 100644 Binary files a/docs/get-started/media/first-app/vsmac/project-dependencies-restored.png and b/docs/get-started/media/first-app/vsmac/project-dependencies-restored.png differ diff --git a/docs/get-started/media/first-app/vsmac/select-target-framework.png b/docs/get-started/media/first-app/vsmac/select-target-framework.png index e852da3a0..f9eac4d77 100644 Binary files a/docs/get-started/media/first-app/vsmac/select-target-framework.png and b/docs/get-started/media/first-app/vsmac/select-target-framework.png differ diff --git a/docs/includes/vsmac-eol-net8.md b/docs/includes/vsmac-eol-net8.md deleted file mode 100644 index 7a577f742..000000000 --- a/docs/includes/vsmac-eol-net8.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -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/windows/deployment/media/publish-visual-studio/vs-debugtarget-net8.png b/docs/windows/deployment/media/publish-visual-studio/vs-debugtarget-net8.png new file mode 100644 index 000000000..38704b08f Binary files /dev/null and b/docs/windows/deployment/media/publish-visual-studio/vs-debugtarget-net8.png differ diff --git a/docs/windows/deployment/publish-visual-studio-folder.md b/docs/windows/deployment/publish-visual-studio-folder.md index df32a68d1..6e8b4bf92 100644 --- a/docs/windows/deployment/publish-visual-studio-folder.md +++ b/docs/windows/deployment/publish-visual-studio-folder.md @@ -17,7 +17,7 @@ This article describes how to use Visual Studio to publish your .NET MAUI app fo In Visual Studio, you can only publish to one platform at a time. The target platform is selected with the **Debug Target** drop-down in the Visual Studio toolbar. Set the target to **Windows Machine** or to **Framework** > **net8.0-windows**, as illustrated in the following image: -:::image type="content" source="media/publish-visual-studio/vs-debugtarget-net7.png" alt-text="Selecting the Windows debug target for a .NET MAUI app in Visual Studio."::: +:::image type="content" source="media/publish-visual-studio/vs-debugtarget-net8.png" alt-text="Selecting the Windows debug target for a .NET MAUI app in Visual Studio."::: ## Publish the project diff --git a/docs/windows/media/setup/vs-target-windows-net8.png b/docs/windows/media/setup/vs-target-windows-net8.png new file mode 100644 index 000000000..7cc5537ea Binary files /dev/null and b/docs/windows/media/setup/vs-target-windows-net8.png differ diff --git a/docs/windows/setup.md b/docs/windows/setup.md index cc5c02db3..b29e54ec8 100644 --- a/docs/windows/setup.md +++ b/docs/windows/setup.md @@ -37,7 +37,7 @@ Developer Mode is enabled in **Settings** app, under **Update & Security** > **F In Visual Studio, set the **Debug Target** to **Framework (...)** > **net8.0-windows**. There is a version number in the item entry, which may or may not match the following screenshot: -:::image type="content" source="media/setup/vs-target-windows-net7.png" alt-text="Visual Studio debug target set to Windows for .NET MAUI app."::: +:::image type="content" source="media/setup/vs-target-windows-net8.png" alt-text="Visual Studio debug target set to Windows for .NET MAUI app.":::