.NET MAUI 8 (#1880)

* Support versioning.

* Fix moniker.

* Add StartPath property.

* TryDispatchAsync on BlazorWebView

* Diagnosing BlazorWebView issues (#1747)

* Enable logging in Blazor Hybrid apps.

* What's new in .NET 8.

* Fix linting errors.

* Add heading.

* Add xref.

* New PointerGestureRecognizer commands and events (#1749)

* New PointerGestureRecognizer commands and events.

* What's new edit.

* Flashlight.IsSupportedAsync method (#1756)

* Add IsSupportedAsync method.

* Edits.

* BlazorWebView tweaks.

* Three AutomationProperties deprecated. (#1757)

* Add deprecations.

* App.Properties removal (#1758)

* App.Properties removal.

* Fix link.

* Edit.

* Unify SensorSpeed intervals (#1775)

* Unify intervals.

* Edit.

* PhoneDialer.Current removed.

* OpenGLView removed.

* SolidColorBrush.Content is the ContentProperty of the class (#1776)

* SolidColorBrush.Content is the ContentProperty of the class.

* Fix linter error.

* ClickGestureRecognizer obsoleted. (#1777)

* GetPosition of drag/drop gesture (#1778)

* GetPosition of drag/drop gesture.

* Add GetPosition to whatsnew.

* Fix xrefs.

* Add UserAgent property (#1779)

* Set media playback prefs in a WebView on iOS (#1780)

* Set media playback prefs.

* Remove hard tabs.

* Rearrange content.

* Edit.

* Edit.

* Edit.

* Edit.

* Edit.

* VisualElement.FocusChangeRequested event deprecated (#1781)

* VisualElement.FocusChangeRequested event deprecated.

* Edit.

* AppThemeBinding supports DynamicResource values (#1783)

* AppThemeBinding supports DynamicResource values

* Edit.

* Grid gains new Add methods. (#1784)

* iOS lifecycle PerformFetch delegate (#1785)

* PerformFetch delegate.

* Edit.

* Secondary tap on Android (#1787)

* Android support for secondary tap.

* Edit.

* Common properties moved to InputView (#1789)

* Properties moved to InputView.

* Edits.

* Edit.

* PointerEventArgs platform args (#1790)

* Added PlatformPointerEventArgs

* Edit.

* Drag/drop event args gain platform args (#1791)

* Platform args for drag and drop gestures.

* Edits.

* Edits.

* Add tabs.

* Edit.

* Use tabs for platform args.

* Added code examples.

* Edit.

* Control resource generation (#1797)

* Control resource generation

* Fix metadata block.

* Link to content in troubleshooting doc.

* Edits.

* Edit.

* Duplicate image file errors (#1799)

* Duplicate image file errors

* Edit.

* Edit.

* Edit.

* Soft input keyboard extensions (#1800)

* Soft input keyboard extensions.

* Edit.

* Use the .NET xmlns schema for Maps types (#1801)

* ClassModifier XAML attribute.

* XAML class modifiers (#1804)

* XAML class modifiers.

* Fix moniker range.

* WiFi permission on Android 13 (#1806)

* Update table for .NET 7

* Edit.

* Edit.

* Bluetooth permission on Android. (#1807)

* Caching disabled for Android streams (#1808)

* Caching disabled for Android streams.

* Edit.

* Edit.

* Edits.

* Keyboard auto scroll manager on iOS (#1813)

* Keyboard scrolling auto manager.

* Fix include links.

* Consume Android system fonts (#1814)

* Consume Android system fonts.

* Add note about entitlement on .NET 8.

* Close code block.

* Edits.

* Edit.

* Single use query parameters for GoToAsync (#1815)

* Single use query parameters.

* Edit.

* Edits.

* Inspect a WebView on MacCat

* Shell tab color appearance (#1818)

* Shell tab color appearance.

* Fix link.

* Decouple window management from the App class (#1819)

* Decouple window management from the App class

* Edit.

* Add headings.

* Edit.

* Use TApp in UseMauiEmbedding method call. (#1820)

* Keyboard accelerators (#1821)

* Keyboard accelerators draft.

* Edits.

* Table edit.

* Edits.

* Edits.

* Shipping info. (#1826)

* ApplicationIdGuid build property not required. (#1829)

* Geolocation foreground listening (#1832)

* Geolocation foreground listening.

* Edits.

* HideSoftInputOnTapped property (#1833)

* HideSoftInputOnTapped property.

* Edit.

* Use a factory method to avoid reflection.

* Edits.

* Limitation is .NET 7 only (#1834)

* Limitation is .NET 7 only.

* Fix linting error.

* PlatformImage.FromStream can be used on Windows (#1837)

* Use PlatformImage on Windows

* PlatformImage can be used on WIndows.

* Performance (#1844)

* Classify new features. (#1846)

* Upgrade from 7 to 8 (#1855)

* Upgrade from 7 to 8

* Fix link.

* Android animations respect power saving.

* Revert "Android animations respect power saving."

This reverts commit 5f3998c.

* Android animations respect power saving (#1856)

* Android animations respect power saving.

* Fix include file link.

* Edit.

* Heading edit.

* Put moniker in include file.

* Remove section. (#1857)

* High speed sampling rates for Android sensors (#1861)

* High speed sampling rate sensor permission.

* Edit.

* Edits.

* Publish unpackaged apps (#1864)

* Initial content

* Publishing selectors per platform.

* Edits.

* Edits.

* Unpackaged apps on Windows.

* VSMac EOL (#1865)

* VSMac EOL.

* Edits.

* .NET 7 to .NET 8 (#1867)

* .NET 7 to .NET 8.

* .NET 7 to 8

* net7 to net8

* Build your first app in .NET 8 (#1868)

* .NET 8 images.

* Try .NET 7/8 split.

* iOS images.

* Fix image link

* Windows images.

* Android images.

* Rename image.

* Resize image.

* VSMac Android images.

* More images.

* Edits.

* Edits.

* .NET 8 installation (#1871)

* .NET 7 to 8

* VSMac edits.

* Edit.

* Edit.

* iOS release notes

* dotnet publish in .NET 8 (#1877)

* dotnet publish in .NET 8

* Edit.

* Edit.

* Default RuntimeIdentifier on iOS (#1878)

* Default RuntimeIdentifier on iOS

* Edit.

* Edit.

* Troubleshoot a remote build. (#1879)

* Troubleshoot a remote build.

* Edits.

* Release note links.

Author: davidbritch

.openpublishing.publish.config.json

@@ -7,6 +7,7 @@
       "locale": "en-us",
       "monikers": [],
       "moniker_ranges": [
+        ">=net-maui-7.0"
       ],
       "open_to_public_contributors": true,
       "xref_query_tags": [

docs/TOC.yml

@@ -115,6 +115,8 @@
               href: xaml/fundamentals/mvvm.md
         - name: Compilation
           href: xaml/xamlc.md
+        - name: Class modifiers
+          href: xaml/class-modifiers.md
         - name: Field modifiers
           href: xaml/field-modifiers.md
         - name: Generics
@@ -471,6 +473,8 @@
               href: user-interface/menu-bar.md
             - name: Display menu items
               href: user-interface/menuitem.md
+            - name: Keyboard accelerators
+              href: user-interface/keyboard-accelerators.md
         - name: Shadows
           href: user-interface/shadow.md
         - name: Styles
@@ -784,8 +788,10 @@
               items:
                 - name: Overview
                   href: windows/deployment/overview.md
-                - name: Publish with the .NET CLI
+                - name: Publish a packaged app with the .NET CLI
                   href: windows/deployment/publish-cli.md
+                - name: Publish an unpackaged app with the .NET CLI
+                  href: windows/deployment/publish-unpackaged-cli.md
                 - name: Publish with Visual Studio to a folder
                   href: windows/deployment/publish-visual-studio-folder.md
     - name: Troubleshooting

docs/android/deployment/index.md

@@ -8,10 +8,9 @@ ms.date: 04/05/2023
 
 > [!div class="op_single_selector"]
 >
-> - [Publish for Android](index.md)
-> - [Publish for iOS](../../ios/deployment/index.md)
-> - [Publish for macOS](../../mac-catalyst/deployment/index.md)
-> - [Publish for Windows](../../windows/deployment/overview.md)
+> - [Publish for Google Play distribution](publish-google-play.md)
+> - [Publish for ad-hoc distribution](publish-ad-hoc.md)
+> - [Publish using the command line](publish-cli.md)
 
 The final step in the development of a .NET Multi-platform App UI (.NET MAUI) app is to publish it. Publishing is the process of creating a package that contains the app and is ready for users to install on their devices. Publishing involve two essential tasks:
 

docs/android/deployment/publish-ad-hoc.md

@@ -6,6 +6,11 @@ ms.date: 05/15/2023
 
 # Publish an Android app for ad-hoc distribution
 
+> [!div class="op_single_selector"]
+>
+> - [Publish for Google Play distribution](publish-google-play.md)
+> - [Publish using the command line](publish-cli.md)
+
 When distributing Android apps outside Google Play, and other marketplaces, *ad-hoc* distribution enables you to make the app available for download on a website or server. Android requires that apps created for ad-hoc distribution use the Android Package (APK) format.
 
 To distribute a .NET Multi-platform App UI (.NET MAUI) Android app, you'll need to sign it with a key from your keystore. Keystores are binary files that serve as repositories of certificates and private keys.

docs/android/deployment/publish-cli.md

@@ -6,6 +6,11 @@ ms.date: 05/16/2023
 
 # Publish an Android app using the command line
 
+> [!div class="op_single_selector"]
+>
+> - [Publish for Google Play distribution](publish-google-play.md)
+> - [Publish for ad-hoc distribution](publish-ad-hoc.md)
+
 To distribute a .NET Multi-platform App UI (.NET MAUI) Android app, you'll need to sign it with a key from your keystore. A *keystore* is a database of security certificates that's created by using `keytool` from the Java Development Kit (JDK). A keystore is required when publishing a .NET MAUI Android app, as Android won't run apps that haven't been signed.
 
 ## Create a keystore file
@@ -59,7 +64,7 @@ To build your app from the command line, and sign it using your keystore, open a
 
 | Parameter                    | Value                                                                                           |
 |------------------------------|-------------------------------------------------------------------------------------------------|
-| `-f` or `--framework`        | The target framework, which is `net7.0-android`.                                                |
+| `-f` or `--framework`        | The target framework, which is `net8.0-android`.                                                |
 | `-c` or `--configuration`    | The build configuration, which is `Release`.                                                    |
 
 > [!WARNING]
@@ -91,19 +96,21 @@ For a full list of build properties, see [Build properties](/xamarin/android/dep
 Run the `dotnet publish` command with the following parameters to build and sign your app:
 
 ```console
-dotnet publish -f net7.0-android -c Release -p:AndroidKeyStore=true -p:AndroidSigningKeyStore={filename}.keystore -p:AndroidSigningKeyAlias={keyname} -p:AndroidSigningKeyPass={password} -p:AndroidSigningStorePass={password}
+dotnet publish -f net8.0-android -c Release -p:AndroidKeyStore=true -p:AndroidSigningKeyStore={filename}.keystore -p:AndroidSigningKeyAlias={keyname} -p:AndroidSigningKeyPass={password} -p:AndroidSigningStorePass={password}
 ```
 
+[!INCLUDE [dotnet publish in .NET 8](~/includes/dotnet-publish-net8.md)]
+
 For example, use the following command to build and sign your app using the previously created keystore:
 
 ```console
-dotnet publish -f net7.0-android -c Release -p:AndroidKeyStore=true -p:AndroidSigningKeyStore=myapp.keystore -p:AndroidSigningKeyAlias=myapp -p:AndroidSigningKeyPass=mypassword -p:AndroidSigningStorePass=mypassword
+dotnet publish -f net8.0-android -c Release -p:AndroidKeyStore=true -p:AndroidSigningKeyStore=myapp.keystore -p:AndroidSigningKeyAlias=myapp -p:AndroidSigningKeyPass=mypassword -p:AndroidSigningStorePass=mypassword
 ```
 
 Both the `AndroidSigningKeyPass` and `AndroidSigningStorePass` properties support `env:` and `file:` prefixes that can be used to specify an environment variable or file that contains the password. Specifying the password in this way prevents it from appearing in build logs. For example, to use an environment variable named `AndroidSigningPassword`:
 
 ```console
-dotnet publish -f net7.0-android -c Release -p:AndroidKeyStore=true -p:AndroidSigningKeyStore=myapp.keystore -p:AndroidSigningKeyAlias=myapp -p:AndroidSigningKeyPass=env:AndroidSigningPassword -p:AndroidSigningStorePass=env:AndroidSigningPassword
+dotnet publish -f net8.0-android -c Release -p:AndroidKeyStore=true -p:AndroidSigningKeyStore=myapp.keystore -p:AndroidSigningKeyAlias=myapp -p:AndroidSigningKeyPass=env:AndroidSigningPassword -p:AndroidSigningStorePass=env:AndroidSigningPassword
 ```
 
 > [!IMPORTANT]
@@ -112,10 +119,10 @@ dotnet publish -f net7.0-android -c Release -p:AndroidKeyStore=true -p:AndroidSi
 To use a file located at *C:\Users\user1\AndroidSigningPassword.txt*:
 
 ```console
-dotnet publish -f net7.0-android -c Release -p:AndroidKeyStore=true -p:AndroidSigningKeyStore=myapp.keystore -p:AndroidSigningKeyAlias=myapp -p:AndroidSigningKeyPass=file:C:\Users\user1\AndroidSigningPassword.txt -p:AndroidSigningStorePass=file:C:\Users\user1\AndroidSigningPassword.txt
+dotnet publish -f net8.0-android -c Release -p:AndroidKeyStore=true -p:AndroidSigningKeyStore=myapp.keystore -p:AndroidSigningKeyAlias=myapp -p:AndroidSigningKeyPass=file:C:\Users\user1\AndroidSigningPassword.txt -p:AndroidSigningStorePass=file:C:\Users\user1\AndroidSigningPassword.txt
 ```
 
-Publishing builds and signs the app, and then copies the AAB and APK files to the *bin\\Release\\net7.0-android\\publish* folder. There are two AAB files - one unsigned and another signed. The signed variant has **-signed** in the file name.
+Publishing builds and signs the app, and then copies the AAB and APK files to the *bin\\Release\\net8.0-android\\publish* folder. There are two AAB files - one unsigned and another signed. The signed variant has **-signed** in the file name.
 
 For more information about the `dotnet publish` command, see [dotnet publish](/dotnet/core/tools/dotnet-publish).
 

docs/android/deployment/publish-google-play.md

@@ -6,6 +6,11 @@ ms.date: 05/15/2023
 
 # Publish an Android app for Google Play distribution
 
+> [!div class="op_single_selector"]
+>
+> - [Publish for ad-hoc distribution](publish-ad-hoc.md)
+> - [Publish using the command line](publish-cli.md)
+
 The most common approach to distributing Android apps to users is through the Google Play. The first time an app is submitted to Google Play it must be submitted through the Google Play Console. Subsequent versions of the app can be submitted through Visual Studio. In both cases, a Google Play Developer account is required. Apps submitted to Google Play require approval from Google.
 
 To distribute a .NET Multi-platform App UI (.NET MAUI) Android app, you'll need to sign it with a key from your keystore, prior to upload to Google Play. Keystores are binary files that serve as repositories of certificates and private keys.

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:

docs/android/manifest.md

@@ -8,7 +8,7 @@ ms.date: 03/07/2023
 
 Every .NET Multi-platform App UI (.NET MAUI) app on Android has an *AndroidManifest.xml* file, located in the *Platforms\\Android* folder, that describes essential information about your app to build tools, the Android operating system, and Google Play.
 
-The manifest file for your .NET MAUI Android app is generated as part of the .NET MAUI build process on Android. This build process takes the XML in the *Platforms\\Android\\AndroidManifest.xml* file, and merges it with any XML that's generated from specific attributes on your classes. The resulting manifest file can be found in the *obj* folder. For example, it can be found at *obj\\Debug\\net7.0-android\\AndroidManifest.xml* for debug builds on .NET 7.
+The manifest file for your .NET MAUI Android app is generated as part of the .NET MAUI build process on Android. This build process takes the XML in the *Platforms\\Android\\AndroidManifest.xml* file, and merges it with any XML that's generated from specific attributes on your classes. The resulting manifest file can be found in the *obj* folder. For example, it can be found at *obj\\Debug\\net8.0-android\\AndroidManifest.xml* for debug builds on .NET 8.
 
 <!-- TODO: Uncomment when VS 17.6 P2 is released
 > [!NOTE]
@@ -181,7 +181,7 @@ public class MainApplication : MauiApplication
 
 ```
 
-This declaration causes the following XML fragment to be generated in *obj\\Debug\\net7.0-android\\AndroidManifest.xml*:
+This declaration causes the following XML fragment to be generated in *obj\\Debug\\net8.0-android\\AndroidManifest.xml*:
 
 ```xml
 <application android:label="MyMauiApp" android:theme="@style/Maui.SplashTheme" android:debuggable="true" ...>

docs/deployment/visual-studio-properties.md

@@ -28,7 +28,7 @@ The **Application** section describes some settings related to which platforms y
   | Setting | Default value | Description |
   | - | - | - |
   | Target the iOS platform | Checked | Specifies that this project will target the iOS platform. |
-  | Target iOS Framework | `net7.0-ios` | The [Target Framework Moniker][tfm] used to target iOS.
+  | Target iOS Framework | `net8.0-ios` | The [Target Framework Moniker][tfm] used to target iOS.
   | Minimum Target iOS Framework | `14.2` | The minimum version of iOS your app targets.
 
 - **Android Targets**
@@ -38,7 +38,7 @@ The **Application** section describes some settings related to which platforms y
   | Setting | Default value | Description |
   | - | - | - |
   | Target the Android platform | Checked | When checked, the .NET MAUI project will target and build an Android version of your app. Uncheck to disable the Android target. |
-  | Target Android Framework | `net7.0-android` | The [Target Framework Moniker][tfm] used to target Android.
+  | Target Android Framework | `net8.0-android` | The [Target Framework Moniker][tfm] used to target Android.
   | Minimum Target Android Framework | `21.0` | The minimum version of Android your app targets.
 
 - **Windows Targets**
@@ -48,7 +48,7 @@ The **Application** section describes some settings related to which platforms y
   | Setting | Default value | Description |
   | - | - | - |
   | Target the Windows platform | Checked | When checked, the .NET MAUI project will target and build a Windows version of your app. Uncheck to disable the Windows target. |
-  | Target Windows Framework | `net7.0-windows10.0.19041.0` | The [Target Framework Moniker][tfm] used to target Windows.
+  | Target Windows Framework | `net8.0-windows10.0.19041.0` | The [Target Framework Moniker][tfm] used to target Windows.
   | Minimum Target Windows Framework | `10.0.17763.0` | The minimum version of Windows your app targets.
 
 ## Build

docs/docfx.json

@@ -77,7 +77,8 @@
     "markdownEngineName": "markdig",
     "groups": {
       "net": {
-        "dest": "net-dest"
+        "dest": "net-dest",
+        "moniker_range": ">=net-maui-7.0"
       }
     }
   }