[iOS] Support for bluetooth permission (#30729)

* [iOS] Support for bluetooth permission

* Public API

Author: kubaflo

src/Essentials/src/Permissions/Permissions.ios.cs

@@ -4,6 +4,7 @@
 using System.Threading.Tasks;
 using AddressBook;
 using AVFoundation;
+using CoreBluetooth;
 using MediaPlayer;
 using Speech;
 
@@ -153,6 +154,49 @@ public override Task<PermissionStatus> RequestAsync()
 			}
 		}
 
+		public partial class Bluetooth : BasePlatformPermission
+		{
+			static CBCentralManager CentralManager;
+
+			static void EnsureCBManagerInitialized()
+			{
+				CentralManager ??= new CBCentralManager();
+			}
+
+			protected override Func<IEnumerable<string>> RequiredInfoPlistKeys =>
+				() => new string[] { "NSBluetoothAlwaysUsageDescription" };
+
+			public override Task<PermissionStatus> CheckStatusAsync()
+			{
+				EnsureDeclared();
+				EnsureCBManagerInitialized();
+				EnsureMainThread();
+
+				var status = CheckPermissionsStatus(CBManager.Authorization);
+				return Task.FromResult(status);
+			}
+
+
+			static PermissionStatus CheckPermissionsStatus(CBManagerAuthorization authorization)
+			{
+				return authorization switch
+				{
+					CBManagerAuthorization.NotDetermined => PermissionStatus.Unknown,
+					CBManagerAuthorization.Restricted => PermissionStatus.Restricted,
+					CBManagerAuthorization.Denied => PermissionStatus.Denied,
+					CBManagerAuthorization.AllowedAlways => PermissionStatus.Granted,
+					_ => PermissionStatus.Unknown,
+				};
+			}
+
+			public override Task<PermissionStatus> RequestAsync()
+			{
+				// A request for Bluetooth permissions is prompted as soon as the CBManager is used. 
+				// Therefore, CheckStatus and RequestAsync have the same implementation.
+				return CheckStatusAsync();
+			}
+		}
+
 		public partial class Media : BasePlatformPermission
 		{
 			/// <inheritdoc/>

src/Essentials/src/PublicAPI/net-ios/PublicAPI.Unshipped.txt

@@ -19,6 +19,9 @@ Microsoft.Maui.Media.SpeechOptions.Rate.get -> float?
 Microsoft.Maui.Media.SpeechOptions.Rate.set -> void
 *REMOVED*Microsoft.Maui.Storage.IFilePicker.PickMultipleAsync(Microsoft.Maui.Storage.PickOptions? options = null) -> System.Threading.Tasks.Task<System.Collections.Generic.IEnumerable<Microsoft.Maui.Storage.FileResult!>!>!
 Microsoft.Maui.Storage.IFilePicker.PickMultipleAsync(Microsoft.Maui.Storage.PickOptions? options = null) -> System.Threading.Tasks.Task<System.Collections.Generic.IEnumerable<Microsoft.Maui.Storage.FileResult?>!>!
+~override Microsoft.Maui.ApplicationModel.Permissions.Bluetooth.CheckStatusAsync() -> System.Threading.Tasks.Task<Microsoft.Maui.ApplicationModel.PermissionStatus>
+~override Microsoft.Maui.ApplicationModel.Permissions.Bluetooth.RequestAsync() -> System.Threading.Tasks.Task<Microsoft.Maui.ApplicationModel.PermissionStatus>
+~override Microsoft.Maui.ApplicationModel.Permissions.Bluetooth.RequiredInfoPlistKeys.get -> System.Func<System.Collections.Generic.IEnumerable<string>>
 static Microsoft.Maui.Authentication.WebAuthenticator.AuthenticateAsync(Microsoft.Maui.Authentication.WebAuthenticatorOptions! webAuthenticatorOptions, System.Threading.CancellationToken cancellationToken) -> System.Threading.Tasks.Task<Microsoft.Maui.Authentication.WebAuthenticatorResult!>!
 static Microsoft.Maui.Authentication.WebAuthenticator.AuthenticateAsync(System.Uri! url, System.Uri! callbackUrl, System.Threading.CancellationToken cancellationToken) -> System.Threading.Tasks.Task<Microsoft.Maui.Authentication.WebAuthenticatorResult!>!
 static Microsoft.Maui.Authentication.WebAuthenticatorExtensions.AuthenticateAsync(this Microsoft.Maui.Authentication.IWebAuthenticator! webAuthenticator, System.Uri! url, System.Uri! callbackUrl, System.Threading.CancellationToken cancellationToken) -> System.Threading.Tasks.Task<Microsoft.Maui.Authentication.WebAuthenticatorResult!>!

src/Essentials/src/PublicAPI/net-maccatalyst/PublicAPI.Unshipped.txt

@@ -19,6 +19,9 @@ Microsoft.Maui.Media.SpeechOptions.Rate.get -> float?
 Microsoft.Maui.Media.SpeechOptions.Rate.set -> void
 *REMOVED*Microsoft.Maui.Storage.IFilePicker.PickMultipleAsync(Microsoft.Maui.Storage.PickOptions? options = null) -> System.Threading.Tasks.Task<System.Collections.Generic.IEnumerable<Microsoft.Maui.Storage.FileResult!>!>!
 Microsoft.Maui.Storage.IFilePicker.PickMultipleAsync(Microsoft.Maui.Storage.PickOptions? options = null) -> System.Threading.Tasks.Task<System.Collections.Generic.IEnumerable<Microsoft.Maui.Storage.FileResult?>!>!
+~override Microsoft.Maui.ApplicationModel.Permissions.Bluetooth.CheckStatusAsync() -> System.Threading.Tasks.Task<Microsoft.Maui.ApplicationModel.PermissionStatus>
+~override Microsoft.Maui.ApplicationModel.Permissions.Bluetooth.RequestAsync() -> System.Threading.Tasks.Task<Microsoft.Maui.ApplicationModel.PermissionStatus>
+~override Microsoft.Maui.ApplicationModel.Permissions.Bluetooth.RequiredInfoPlistKeys.get -> System.Func<System.Collections.Generic.IEnumerable<string>>
 static Microsoft.Maui.Authentication.WebAuthenticator.AuthenticateAsync(Microsoft.Maui.Authentication.WebAuthenticatorOptions! webAuthenticatorOptions, System.Threading.CancellationToken cancellationToken) -> System.Threading.Tasks.Task<Microsoft.Maui.Authentication.WebAuthenticatorResult!>!
 static Microsoft.Maui.Authentication.WebAuthenticator.AuthenticateAsync(System.Uri! url, System.Uri! callbackUrl, System.Threading.CancellationToken cancellationToken) -> System.Threading.Tasks.Task<Microsoft.Maui.Authentication.WebAuthenticatorResult!>!
 static Microsoft.Maui.Authentication.WebAuthenticatorExtensions.AuthenticateAsync(this Microsoft.Maui.Authentication.IWebAuthenticator! webAuthenticator, System.Uri! url, System.Uri! callbackUrl, System.Threading.CancellationToken cancellationToken) -> System.Threading.Tasks.Task<Microsoft.Maui.Authentication.WebAuthenticatorResult!>!