feat: some macro methods for Android PermissionHelper

src/Uno.UWP/Extensions/PermissionsHelper.cs

@@ -40,8 +40,54 @@ public static bool IsDeclaredInManifest(string permission)
 			var requestedPermissions = packageInfo?.RequestedPermissions;
 
 			return requestedPermissions?.Any(r => r.Equals(permission, StringComparison.OrdinalIgnoreCase)) ?? false;
-		}
+		}
+
+		/// <summary>
+		/// Checks if the given Android permissions are declared the app manifest.
+		/// </summary>
+		/// <param name="permission">Array of permissions.</param>
+		/// <returns>true if all permissions are defined</returns>
+		public static bool AreAllPermissionsDeclaredInManifest(string[] permissions)
+			=> permissions.All(IsDeclaredInManifest);
+
+
+		/// <summary>
+		/// Ensures that the given Android permissions are declared in manifest file.
+		/// </summary>
+		/// <param name="permission">Array of permissions.</param>
+		public static void EnsuresPermissionsAreDeclaredInManifest(string[] permissions)
+		{
+			var context = Application.Context;
+			var packageInfo = context.PackageManager.GetPackageInfo(context.PackageName, PackageInfoFlags.Permissions);
+			var requestedPermissions = packageInfo?.RequestedPermissions;
 
+			if(requestedPermissions is null)
+			{
+				throw new UnauthorizedAccessException("No permissions are defined in the manifest (no permission at all)");
+			}
+
+			foreach(var permission in permissions)
+			{
+				if (!IsDeclaredInManifest(permission))
+				{
+					throw new UnauthorizedAccessException($"The permission {permission} is not defined in the manifest");
+				}
+			}
+
+		}
+
+		/// <summary>
+		/// Validate if a given permission was granted to the app but not request it to the user
+		/// <remarks>
+		/// This should not be invoked directly from the application code.
+		/// You should use the extension methods in <see cref="PermissionsServiceExtensions"/>.
+		/// </remarks>
+		/// </summary>
+		/// <param name="permissionIdentifier">A permission identifier defined in Manifest.Permission.</param>
+		/// <returns>A <see cref="Task"/> representing the asynchronous operation</returns>
+		public static Task<bool> CheckPermissionAsync(string permissionIdentifier)
+			=> _checkPermission(CancellationToken.None, permissionIdentifier);
+
 		/// <summary>
 		/// Validate if a given permission was granted to the app and if not, request it to the user.
 		/// <remarks>
@@ -56,6 +102,7 @@ public static bool IsDeclaredInManifest(string permission)
 		public static Task<bool> TryGetPermission(CancellationToken ct, string permissionIdentifier)
 			=> _tryGetPermission(ct, permissionIdentifier);
 
+
 		/// <summary>
 		/// Validate if a given permission was granted to the app but not request it to the user
 		/// <remarks>
@@ -67,7 +114,7 @@ public static Task<bool> TryGetPermission(CancellationToken ct, string permissio
 		/// <param name="permissionIdentifier">A permission identifier defined in Manifest.Permission.</param>
 		/// <returns>A <see cref="Task"/> representing the asynchronous operation</returns>
 		public static Task<bool> CheckPermission(CancellationToken ct, string permissionIdentifier)
-			=> _checkPermission(ct, permissionIdentifier);
+			=> _checkPermission(ct, permissionIdentifier);
 
 		/// <summary>
 		/// Manifest.Permission.AccessFineLocation