diff --git a/docs/get-started/first-app.md b/docs/get-started/first-app.md index 75a9cf016b..3b0e62ac15 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 69c6c0fdae..5cf8e41d78 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 fbafff3c14..48a9e6380b 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 c126a8a121..de5b82246e 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 2e84970f24..9f8fc082e2 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 0000000000..0e0a01f226 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 8c5a8be724..446136aa0a 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 848848d603..dcf28a24a0 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 f25ecf84b8..0ce8f42da1 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 867d4a3546..9f662e7101 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 0000000000..19c7af5bcf 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 94f6616d17..0000000000 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 d894c2a5ed..9d0e0e3759 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 b179d0e8b7..0000000000 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 5a7af6ec1f..0000000000 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 02643c208f..3563a606b1 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 fd45885ace..fb643c427e 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 7cb368e9f6..10a9d6762e 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 5ea1a25d5a..e7506a94bd 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 53c836d1cc..5792f2c47c 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 3adea375b4..8b6bdf55a6 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 61d804c22c..f85f0ba6e0 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 27508dc165..07a057c2a0 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 4120c03ccc..f3498fb351 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 1b08c87514..040d0323c4 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 f5d9c4aa39..75385d68ad 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 e7390114a3..a4fbab5435 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 e852da3a0a..f9eac4d774 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 7a577f7429..0000000000 --- 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 0000000000..38704b08f2 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 df32a68d1b..6e8b4bf925 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 0000000000..7cc5537ea4 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 cc5c02db3a..b29e54ec8d 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.":::