Temporary commit of incoming PackageInformation setup.

Author: mjr4077au

src/PSADT/PSADT.WindowsRuntime/Management/Deployment/AppDisplayInformation.cs

@@ -0,0 +1,46 @@
+using Windows.ApplicationModel;
+using Windows.Foundation;
+using Windows.Storage.Streams;
+
+namespace PSADT.WindowsRuntime.Management.Deployment
+{
+    /// <summary>
+    /// Provides an application's name, description, and logo.
+    /// </summary>
+    public sealed class AppDisplayInformation
+    {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="AppDisplayInformation"/> class based on the provided <see cref="AppDisplayInfo"/> object.
+        /// </summary>
+        /// <param name="appDisplayInfo">The <see cref="AppDisplayInfo"/> object to wrap.</param>
+        internal AppDisplayInformation(AppDisplayInfo appDisplayInfo)
+        {
+            _appDisplayInfo = appDisplayInfo;
+        }
+
+        /// <summary>
+        /// Gets the application's description.
+        /// </summary>
+        public string Description => _appDisplayInfo.Description;
+
+        /// <summary>
+        /// Gets the application's display name.
+        /// </summary>
+        public string DisplayName => _appDisplayInfo.DisplayName;
+
+        /// <summary>
+        /// Gets the application's logo.
+        /// </summary>
+        /// <param name="size">The desired size of the logo.</param>
+        /// <returns>A <see cref="RandomAccessStreamReference"/> representing the application's logo.</returns>
+        public RandomAccessStreamReference GetLogo(Size size)
+        {
+            return _appDisplayInfo.GetLogo(size);
+        }
+
+        /// <summary>
+        /// The underlying AppDisplayInfo object that this class wraps around.
+        /// </summary>
+        private readonly AppDisplayInfo _appDisplayInfo;
+    }
+}

src/PSADT/PSADT.WindowsRuntime/Management/Deployment/AppInformation.cs

@@ -0,0 +1,46 @@
+using System.Collections.Generic;
+using System.Collections.ObjectModel;
+using Windows.ApplicationModel;
+
+namespace PSADT.WindowsRuntime.Management.Deployment
+{
+    /// <summary>
+    /// Provides information about an application such as its name, logo, package information, ID.
+    /// </summary>
+    public sealed class AppInformation
+    {
+        /// <summary>
+        /// Initializes a new instance of the AppInformation class based on the provided AppInfo object.
+        /// </summary>
+        /// <param name="appInfo">The AppInfo object to initialize the AppInformation instance with.</param>
+        internal AppInformation(AppInfo appInfo)
+        {
+            _appInfo = appInfo;
+        }
+
+        /// <summary>
+        /// Gets the app identifier.
+        /// </summary>
+        public string Id => _appInfo.Id;
+
+        /// <summary>
+        /// An identifier that uniquely identifies the app's package.
+        /// </summary>
+        public string PackageFamilyName => _appInfo.PackageFamilyName;
+
+        /// <summary>
+        /// An enum that represents the execution context for the specified app. Values may be one of Unknown, Host, or Guest. On Desktop devices, this will be Host.
+        /// </summary>
+        public AppExecutionContext ExecutionContext => _appInfo.ExecutionContext;
+
+        /// <summary>
+        /// A list of file extensions that the application has been registered to handle. An app can register to handle an extension under the windows.fileTypeAssociation in the application manifest file.
+        /// </summary>
+        public IReadOnlyList<string> SupportedFileExtensions => new ReadOnlyCollection<string>(_appInfo.SupportedFileExtensions);
+
+        /// <summary>
+        /// The underlying AppInfo object that this class wraps around.
+        /// </summary>
+        private readonly AppInfo _appInfo;
+    }
+}

src/PSADT/PSADT.WindowsRuntime/Management/Deployment/AppListEntryInformation.cs

@@ -0,0 +1,84 @@
+using System;
+using System.Threading.Tasks;
+using Windows.ApplicationModel.Core;
+using Windows.System;
+
+namespace PSADT.WindowsRuntime.Management.Deployment
+{
+    /// <summary>
+    /// Provides an app's display info such as its display name and description, and a method to launch the app.
+    /// </summary>
+    public sealed class AppListEntryInformation
+    {
+        /// <summary>
+        /// Initializes a new instance of the AppListEntryInformation class based on the provided AppListEntry object.
+        /// </summary>
+        /// <param name="appListEntry">The AppListEntry object to initialize the AppListEntryInformation instance with.</param>
+        internal AppListEntryInformation(AppListEntry appListEntry)
+        {
+            _appListEntry = appListEntry;
+            DisplayInfo = new(appListEntry.DisplayInfo);
+            AppInfo = new(appListEntry.AppInfo);
+        }
+
+        /// <summary>
+        /// Provides an app's display name, description, and logo.
+        /// </summary>
+        public AppDisplayInformation DisplayInfo { get; }
+
+        /// <summary>
+        /// Gets the Application User Model ID (AUMID) for this AppListEntry.
+        /// </summary>
+        public string AppUserModelId => _appListEntry.AppUserModelId;
+
+        /// <summary>
+        /// Provides information about an application such as its name, logo, package information, ID.
+        /// </summary>
+        public AppInformation AppInfo { get; }
+
+        /// <summary>
+        /// Launch the app associated with this AppListEntryInformation
+        /// </summary>
+        /// <returns></returns>
+        [System.Diagnostics.CodeAnalysis.SuppressMessage("Usage", "VSTHRD002:Avoid problematic synchronous waits", Justification = "There's no async in PowerShell.")]
+        public bool Launch()
+        {
+            return LaunchAsync().ConfigureAwait(false).GetAwaiter().GetResult();
+        }
+
+        /// <summary>
+        /// Launch the app associated with this AppListEntryInformation
+        /// </summary>
+        /// <returns>A task that represents the asynchronous operation. The task result contains a boolean value indicating whether the app was successfully launched.</returns>
+        public Task<bool> LaunchAsync()
+        {
+            return _appListEntry.LaunchAsync().AsTask();
+        }
+
+        /// <summary>
+        /// Launch the app associated with this AppListEntryInformation within the context of a specified user.
+        /// </summary>
+        /// <param name="user">The user context in which to launch the app.</param>
+        /// <returns>A boolean value indicating whether the app was successfully launched.</returns>
+        [System.Diagnostics.CodeAnalysis.SuppressMessage("Usage", "VSTHRD002:Avoid problematic synchronous waits", Justification = "There's no async in PowerShell.")]
+        public bool LaunchForUser(User user)
+        {
+            return LaunchForUserAsync(user).ConfigureAwait(false).GetAwaiter().GetResult();
+        }
+
+        /// <summary>
+        /// Launch the app associated with this AppListEntryInformation within the context of a specified user.
+        /// </summary>
+        /// <param name="user">The user context in which to launch the app.</param>
+        /// <returns>A task that represents the asynchronous operation. The task result contains a boolean value indicating whether the app was successfully launched.</returns>
+        public Task<bool> LaunchForUserAsync(User user)
+        {
+            return _appListEntry.LaunchForUserAsync(user).AsTask();
+        }
+
+        /// <summary>
+        /// The underlying AppListEntry object that this class wraps around.
+        /// </summary>
+        private readonly AppListEntry _appListEntry;
+    }
+}

src/PSADT/PSADT.WindowsRuntime/Management/Deployment/PackageInformation.cs

@@ -0,0 +1,96 @@
+using System;
+using System.Collections.Generic;
+using System.Collections.ObjectModel;
+using System.Linq;
+using System.Threading.Tasks;
+using Windows.ApplicationModel;
+
+namespace PSADT.WindowsRuntime.Management.Deployment
+{
+    /// <summary>
+    /// Provides information about a package.
+    /// </summary>
+    public sealed class PackageInformation
+    {
+        /// <summary>
+        /// 
+        /// </summary>
+        /// <param name="package"></param>
+        internal PackageInformation(Package package)
+        {
+            _package = package;
+            Dependencies = new ReadOnlyCollection<PackageInformation>([.. package.Dependencies.Select(static d => new PackageInformation(d))]);
+        }
+
+        /// <summary>
+        /// Gets the packages on which the current package depends.
+        /// </summary>
+        public IReadOnlyList<PackageInformation> Dependencies { get; }
+
+        /// <summary>
+        /// Gets the package identity of the current package.
+        /// </summary>
+        public PackageId Id => _package.Id;
+
+        /// <summary>
+        /// The CheckUpdateAvailabilityAsync method allows developers to check for updates to the main app package listed in the .appinstaller file. It allows the developer to determine if the updates are required due to .appinstaller policy. This method currently only works for applications installed via .appinstaller files.
+        /// </summary>
+        /// <returns>A PackageUpdateAvailabilityResult that indicates if an application has an update, and if the update is required.</returns>
+        [System.Diagnostics.CodeAnalysis.SuppressMessage("Usage", "VSTHRD002:Avoid problematic synchronous waits", Justification = "There's no async in PowerShell.")]
+        public PackageUpdateAvailabilityResult CheckUpdateAvailability()
+        {
+            return CheckUpdateAvailabilityAsync().ConfigureAwait(false).GetAwaiter().GetResult();
+        }
+
+        /// <summary>
+        /// The CheckUpdateAvailabilityAsync method allows developers to check for updates to the main app package listed in the .appinstaller file. It allows the developer to determine if the updates are required due to .appinstaller policy. This method currently only works for applications installed via .appinstaller files.
+        /// </summary>
+        /// <returns>A PackageUpdateAvailabilityResult that indicates if an application has an update, and if the update is required.</returns>
+        public Task<PackageUpdateAvailabilityResult> CheckUpdateAvailabilityAsync()
+        {
+            return _package.CheckUpdateAvailabilityAsync().AsTask();
+        }
+
+        /// <summary>
+        /// The FindRelatedPackages method provides the dependencies and then dependents for a given package as a Package list. The list can be filtered by the type of dependency using the options parameter.
+        /// </summary>
+        /// <param name="options">The FindRelatedPackageOptions which defines the search options.</param>
+        /// <returns>A read-only list of <see cref="PackageInformation"/> objects representing the related packages.</returns>
+        public IReadOnlyList<PackageInformation> FindRelatedPackages(FindRelatedPackagesOptions options)
+        {
+            return new ReadOnlyCollection<PackageInformation>([.. _package.FindRelatedPackages(options).Select(static p => new PackageInformation(p))]);
+        }
+
+        /// <summary>
+        /// Returns the .appinstaller XML file location. Use this method when you need to retrieve the .appinstaller XML file location for your app. For example, this is useful if your app needs to share a URI to its associated .appinstaller file. You can optionally add arguments to the URI.
+        /// </summary>
+        /// <returns>The .appinstaller XML file location.</returns>
+        public AppInstallerInfo GetAppInstallerInfo()
+        {
+            return _package.GetAppInstallerInfo();
+        }
+
+        /// <summary>
+        /// Enumerates the packaged apps on the device and returns the list synchronously. Only apps included in the current package are returned.
+        /// </summary>
+        /// <returns>A list of AppListEntry objects that specify the packaged apps along with their display name, description, and logo.</returns>
+        public IReadOnlyList<AppListEntryInformation> GetAppListEntries()
+        {
+            return new ReadOnlyCollection<AppListEntryInformation>([.. _package.GetAppListEntries().Select(static entry => new AppListEntryInformation(entry))]);
+        }
+
+        /// <summary>
+        /// Enumerates the packaged apps on the device and returns the list asynchronously. Only apps included in the current package are returned.
+        /// </summary>
+        /// <returns>A task that represents the asynchronous operation. The task result contains a list of AppListEntryInformation objects that specify the packaged apps along with their display name, description, and logo.</returns>
+        public async Task<IReadOnlyList<AppListEntryInformation>> GetAppListEntriesAsync()
+        {
+            return new ReadOnlyCollection<AppListEntryInformation>([.. (await _package.GetAppListEntriesAsync().AsTask().ConfigureAwait(false)).Select(static entry => new AppListEntryInformation(entry))]);
+        }
+
+        /// <summary>
+        /// Gets the underlying <see cref="Package"/> object.
+        /// </summary>
+        private readonly Package _package;
+    }
+}

src/PSADT/PSADT.WindowsRuntime/Management/Deployment/PackageManagement.cs

@@ -6,6 +6,7 @@
 using System.Threading;
 using System.Threading.Tasks;
 using PSADT.Interop;
+using Windows.ApplicationModel;
 using Windows.Management.Deployment;
 using Windows.Win32.Storage.Packaging.Appx;
 using Windows.Win32.System.Com;
@@ -17,6 +18,15 @@ namespace PSADT.WindowsRuntime.Management.Deployment
     /// </summary>
     public static class PackageManagement
     {
+        /// <summary>
+        /// Retrieves a list of all provisioned Appx/Msix packages on the system using the PackageManager API.
+        /// </summary>
+        /// <returns>A list of provisioned packages.</returns>
+        public static IList<Package> GetAppxProvisionedPackages()
+        {
+            return new PackageManager().FindProvisionedPackages();
+        }
+
         /// <summary>
         /// Provisions the specified Appx/Msix package for all users on the system by staging the package and then provisioning it using the PackageManager API. Validates the input package URI and checks for the existence of the package file before attempting to stage and provision. Retrieves the package family name from the package manifest to use for provisioning. Throws exceptions if any step of the staging or provisioning process fails, or if the input package URI is invalid or does not point to an existing file.
         /// </summary>