检测包标识和运行时上下文

你的应用程序可能有某些版本不是在 MSIX 包中分发的。 在运行时,应用可以通过使用 Windows 包管理器 API 或你自己的自定义安装程序来检测自己是不是作为 MSIX 包部署。 可以更改更新设置等应用行为,也可以利用仅适用于 MSIX 包的功能。

若要确定应用程序是在支持完整 MSIX 功能集的 Windows 版本上作为 MSIX 包运行,可在 kernel32.dll 中使用 GetCurrentPackageFullName 本机函数。 当桌面应用程序作为没有包标识的未包装应用程序运行时,此函数会返回一个错误,它能帮助你推断应用运行的上下文。

如果函数成功,这意味着:

  • 你的应用包装在 MSIX 包中。
  • 你的应用可以在 Windows 10 版本 1709(内部版本 16299)或更高版本的应用上运行,可获得完整的 MSIX 支持。

在本机代码中使用 GetCurrentPackageFullName

以下代码示例演示了如何使用 GetCurrentPackageFullName 来确定应用的上下文。

#define _UNICODE 1
#define UNICODE 1

#include <Windows.h>
#include <appmodel.h>
#include <malloc.h>
#include <stdio.h>

int __cdecl wmain()
{
    UINT32 length = 0;
    LONG rc = GetCurrentPackageFullName(&length, NULL);
    if (rc != ERROR_INSUFFICIENT_BUFFER)
    {
        if (rc == APPMODEL_ERROR_NO_PACKAGE)
            wprintf(L"Process has no package identity\n");
        else
            wprintf(L"Error %d in GetCurrentPackageFullName\n", rc);
        return 1;
    }

    PWSTR fullName = (PWSTR) malloc(length * sizeof(*fullName));
    if (fullName == NULL)
    {
        wprintf(L"Error allocating memory\n");
        return 2;
    }

    rc = GetCurrentPackageFullName(&length, fullName);
    if (rc != ERROR_SUCCESS)
    {
        wprintf(L"Error %d retrieving PackageFullName\n", rc);
        return 3;
    }
    wprintf(L"%s\n", fullName);

    free(fullName);

    return 0;
}

在托管代码中使用 GetCurrentPackageFullName 函数

若要在托管 .NET Framework 应用中调用 GetCurrentPackageFullName需要使用 Platform Invoke (P/Invoke) 或其他形式的互操作。

若要简化此过程,可以使用 DesktopBridgeHelpers 库。 此库支持 .NET Framework 4 及更高版本,并在内部使用 P/Invoke 来提供帮助器类,以确定应用是否在支持完整 MSIX 功能集的 Windows 版本上运行。 此库还可以 NuGet 包的形式提供。

在项目中安装包后,可以创建 DesktopBridge.Helpers 类的新实例,并调用 IsRunningAsUwp 方法。 如果你的应用作为 MSIX 包在 Windows 10 版本 1709(内部版本 16299)或更高版本上运行,则此方法返回 true;如果不满足以上任意条件,则返回 false。 下面的示例演示如何调用此方法。

private bool IsRunningAsUwp()
{
   UwpHelpers helpers = new UwpHelpers();
   return helpers.IsRunningAsUwp();
}

private void Form1_Load(object sender, EventArgs e)
{
   if (IsRunningAsUwp())
   {
       txtUwp.Text = "I'm running as MSIX";
   }
   else
   {
       txtUwp.Text = "I'm running as a native desktop app";
   }
}