通过

使用嵌入应用安装程序文件更新应用

  • 项目

重要

嵌入式应用安装程序文件在 Windows 版本 10.0.21300.0 中可用。 若要使用此功能，请确保 MaxVersionTested 引用此版本或更新版本的 Windows 操作系统。

应用安装程序文件提供 Windows 应用可以遍历搜索更新和修复的更新路径。

使用 Visual Studio 构建和发布带有嵌入式应用安装程序文件的 Windows 应用时，必须确保已安装 Windows 10 SDK 2104（或更高版本），并且项目属性将 Windows 10 21H1（或更高版本）作为目标版本（MaxVersionTested 和 MinVersion）。 如果尚未配置，则在安装 Windows 应用时，Windows 应用不会将嵌入式 AppInstaller 配置设置到设备。

MSIX 打包工具操作说明

以下步骤将指导你了解如何使用 MSIX 打包工具编辑预先存在的 Windows 应用以包含嵌入式应用安装程序应用。

注意

以下指南假定你之前已使用 Visual Studio 创建了应用安装程序文件，以通过 MSIX 工具包或手动创建应用安装程序文件自动创建应用安装程序文件。 有关创建应用安装程序文件的指导，请访问以下 Docs 文章之一：

打开 Windows 应用进行编辑

以下步骤将指导你了解如何使用 Microsoft MSIX 打包工具应用开始编辑 Windows 应用。

  1. 启动 Microsoft MSIX 打包工具（位于 Microsoft Store：MSIX 打包工具）。
  2. 选择“包编辑器”按钮以编辑现有包。
  3. 选择“浏览”按钮，并在提示窗口中找到你的 Windows 应用，然后选择“打开”按钮。
  4. 选择“打开包”按钮。

将应用安装程序文件导入 Windows 应用

以下步骤将指导你了解如何使用 Microsoft MSIX 打包工具应用将应用安装程序文件嵌入到预先存在的 Windows 应用中。 这些步骤假定你已使用 Microsoft MSIX 打包工具应用打开 Windows 应用进行编辑。

  1. 在 MSIX 打包工具的左侧，选择“包文件”。
  2. 展开树状视图内的“包”条目。
  3. 右键单击“包”，然后从下拉菜单中选择“添加文件”。
  4. 选择提示窗口内的“浏览”按钮，导航到并选择应用安装程序文件，然后选择“打开”按钮。
  5. 选择“保存”按钮。

更新 AppxManifest

以下步骤将指导你更新 AppxManifest，以指向之前添加到 Windows 应用的应用安装程序文件。

  1. 在“MSIX 打包工具”的左侧，选择“包信息”。
  2. 滚动到“包信息”章节底部。
  3. 选择“打开文件”按钮，在记事本窗口中打开 AppxManifest。
  4. 确保 <Package> 属性包括以下命名空间和可忽略命名空间：
    <Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
    xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
    xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
    xmlns:uap13="http://schemas.microsoft.com/appx/manifest/uap/windows10/13" 
    xmlns:build="http://schemas.microsoft.com/developer/appx/2015/build"
    IgnorableNamespaces="uap mp uap13 build">
  5. <Properties> 内部包括以下 <uap13:AutoUpdate> 和子参数：
    <Properties>
    ...
    <uap13:AutoUpdate>
        <uap13:AppInstaller File="Update.appinstaller" />
    </uap13:AutoUpdate>
</Properties>
  6. 保存你对 AppxManifest 进行的更改。
  7. 关闭“AppxManifest” 记事本窗口，并返回到 MSIX 打包工具。

注意

上述说明假定应用安装程序文件名为“Update.appinstaller”。

关闭并打包 Windows 应用

以下步骤将指导你将 Windows 应用打包为较新版本。 这些步骤假设你已配置“签名首选项”以满足组织或客户端要求。

  1. 在“MSIX 打包工具”中，选择“保存”按钮。
  2. 在提示窗口中，选择“是，递增”按钮。
  3. 导航到想要保存新更新的 Windows 应用的位置，然后选择“保存”按钮。
  4. 选择“关闭”按钮。
  5. “关闭 MSIX 打包工具”窗口。

Visual Studio 操作说明

在开始之前，请确保使用的是安装了 Windows 10 SDK 2104 或更高版本的 Windows 10 设备。 需要此 SDK 以确保在生成应用时使用正确的值设置目标版本和最低版本属性。

嵌入应用安装程序文件

以下步骤将指导你将应用安装程序文件嵌入到 Windows 应用 （UWP） Visual Studio 项目。

  1. 在“Visual Studio 项目”的“解决方案资源管理器”中，右键单击 Windows 应用名称。
  2. 从下拉菜单中选择“添加”>>“现有项”。
  3. 导航到应用安装程序文件，选择它并选择“添加”按钮。
  4. 在“解决方案资源管理器”中，双击“Update.appinstaller”打开文件进行检查。
  5. 确认应用安装程序文件正确，并关闭该文件。

更新 AppxManifest

以下步骤将指导你更新 Visual Studio 项目中的 AppxManifest，以面向新嵌入的应用安装程序文件。

本指南假定：

  • 已安装 Windows 10 SDK 2104 或更高版本
  • 项目属性设置为面向 Windows 10 版本 2104 或更高版本。
  • 应用安装程序文件的名称为 Update.appinstaller
  1. 在“Visual Studio 项目”的顶部菜单中，选择“生成”。
  2. 从下拉菜单中选择“生成解决方案”。 确保 Windows 应用生成成功。
  3. 从功能区中选择“本地计算机”以测试 Windows 应用的功能。
  4. 在 Windows 应用启动后不久将其关闭，并停止调试。
  5. 在“解决方案资源管理器”中，右键单击 Package.appxmanifest
  6. 从下拉菜单中选择“查看代码”。
  7. 确保 <Package> 属性包括以下命名空间和可忽略命名空间：
    <Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
    xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
    xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
    xmlns:uap13="http://schemas.microsoft.com/appx/manifest/uap/windows10/13" 
    xmlns:build="http://schemas.microsoft.com/developer/appx/2015/build"
    IgnorableNamespaces="uap mp uap13 build">
  8. <Properties> 内部包括以下 <uap13:AutoUpdate> 和子参数：
    <Properties>
    ...
    <uap13:AutoUpdate>
        <uap13:AppInstaller File="Update.appinstaller" />
    </uap13:AutoUpdate>
</Properties>
  9. 保存对文件的更改，并关闭该文件。

生成 Windows 应用

以下步骤将指导你创建 Windows 应用包，以在受支持的操作系统上进行安装。

  1. 在“Visual Studio 项目”中，右键单击 Windows 应用名称。
  2. 从下拉菜单中选择“发布”>>“创建应用包...”。
  3. 在新的“创建应用包”对话框窗口中选择“旁加载”单选按钮。
  4. 选择“下一步”按钮。
  5. 选择“是，使用当前证书:”单选按钮。
  6. 导入现有证书，或自动生成证书以为 Windows 应用签名。
  7. 选择“下一步”按钮。
  8. 为 Windows 应用指定 Windows 应用程序包的解决方案配置、版本和可选内部版本。
  9. 选择“创建”按钮。