MSIX 打包扩展

MSIX 打包扩展是一种 Azure DevOps 扩展，可帮助使用 MSIX 包格式生成、打包和签名 Windows 应用。

CI/CD 工作流已成为开发过程中必不可少的一部分，可提高效率和质量，同时降低成本和缩短上市时间。 Microsoft 的 CI/CD 解决方案 Azure DevOps 管道已广泛采用且很受欢迎，但将需要打包为 MSIX 的应用的生成和部署工作流集成到 Azure Pipelines 则是一件枯燥的工作，尤其是对于不是 Azure Pipelines 或 MSIX 专家的用户来说。 此 Azure DevOps 扩展提供了一个简单直观的解决方案，使你可以更轻松地自动执行打包为 MSIX 的应用的生成和部署过程，并使具有现有 CI/CD 工作流的应用可以移动到 MSIX，而不会中断其生成和部署机制。

MSIX 打包扩展包含以下任务，可根据要求用于自定义生成管道：

1. MSIX 生成和打包 - 使用 MSIX 包格式生成和打包 Windows 应用
2. MSIX 包签名 - 使用受信任的证书对 MSIX 包进行签名
3. MSIX 的应用安装程序文件 - 为 MSIX 应用创建或更新 .appinstaller 文件
4. 为 MSIX 应用附加创建包 - 为 MSIX 应用附加创建 VHDX 包

安装扩展

浏览 Azure DevOps 商城，并查找名为 MSIX 打包扩展的扩展。

创建管道

创建 Azure DevOps 项目的新管道。

将该选项选择为“使用经典编辑器创建无 YAML 的管道”。

选择版本控制系统，并提供存储库和默认分支的详细信息。

当要求选择模板时，单击“从空作业开始”。

将“代理规范”选择更改为 “windows-2019”，因为 MSIX 扩展仅在 Windows 代理上运行。

默认情况下，你可在管道中看到“代理作业 1”。 单击加号符号以向代理作业 1 添加任务。

在“添加任务”搜索栏中搜索”MSIX”，你可在 MSIX 打包扩展中看到之前提到的任务。 可根据要求添加所需的任务以自定义生成管道。 但我们将演示如何在此页上配置所有四项任务。

MSIX 生成和打包

注意：如果想使用此任务生成打包应用，需要包含 Windows 应用程序打包项目，因为该任务需要 Package.appxmanifest.xml 文件。 系统不会自动添加该任务。

YAML

以下示例演示如何在 yaml 文件中配置生成和包任务：

steps:
- task: MSIX.msix-ci-automation-task-dev.msix-packaging.MsixPackaging@1
  displayName: 'MSIX build and package'
  inputs:
    outputPath: '$(Build.ArtifactStagingDirectory)\MyApp.msix'
    solution: MyUWPApp.sln
    buildPlatform: x64
    updateAppVersion: true
    manifestFile: MyUWPApp/Package.appxmanifest
    appVersion: 2.0.0.0
    appPackageDistributionMode: SideloadOnly
    msbuildArchitecture: x64

UI

• 显示名称 - 自定义任务名称
• 输出路径 - 指定将由此任务创建的 MSIX 包的输出路径。 上面示例中的路径使用预定义的变量 ArtifactStagingDirectory，该路径是代理上用于存储项目的本地路径，在此处用于存储稍后可使用发布项目任务发布的任务输出文件。
• 使用 MSBuild 生成解决方案 - 选择此选项可使用 msbuild 为指定的目标平台生成解决方案。 如果已经有了只需要打包的二进制文件，请将框保留为未选中状态。 如果将框保留为未选中状态，则系统将要求你提供二进制文件的路径。
• 要生成的项目 - 提供需要生成的项目或解决方案文件的路径。
• 生成前清理 - 如果希望任务在生成之前运行清理生成，请选中此复选框。
• 生成 MSIX 捆绑 - 选择此复选框可生成 MSIX 捆绑，而不是包。 请确保在“输出路径”选项中将输出文件命名为 .msixbundle 扩展名，而不是 .msix。
• 配置 - 在调试和版本生成配置之间进行选择。
• 平台 - 指定目标生成平台，例如 x64、x86、任何 CPU。
• 更新清单中的应用版本 - 选择此复选框可从应用的 .appxmanifest 文件中所指定的应用中更改应用版本。 这不会覆盖 .appxmanifest 文件，但会更改生成的输出 MSIX 包中的应用版本。 如果选择此选项，系统将要求你提供清单文件的路径，以及要为应用设置的应用版本号。
• 应用程序包分发模式 - 从下拉菜单中选择要生成 Microsoft Store 应用包或非 Microsoft Store 应用包的模式。
• Msbuild 版本和体系结构 - 通过指定高级选项自定义 MSBuild。

MSIX 包签名

签名任务允许使用证书签名。 证书可来自安全文件库，还可编码为字符串，就如同使用 Azure Key Vault 任务提取的一样。

YAML

以下示例演示如何在 yaml 文件中配置包签名任务：

steps:
- task: MSIX.msix-ci-automation-task-dev.msix-signing.MsixSigning@1
  displayName: 'Sign MSIX package'
  inputs:
    certificateType: base64
    encodedCertificate: '$(kvtestcert)'

UI

本示例显示了当证书源为安全文件库时的任务。

本示例显示了当证书源为 Azure Key Vault 时的任务。

• 显示名称 - 自定义任务名称
• 要签署的包 - MSIX 包签名任务使用 SignTool 来签名与此路径匹配的所有文件，而不管它们是 MSIX 包还是包。
• 证书文件类型 - 选择要使用的证书文件的源。
• 时间戳服务器 - 用于指定时间戳服务器地址的 URL。 这是一个可选参数。

用于 MSIX 的应用安装程序文件

YAML

以下示例演示如何在 yaml 文件中配置 AppInstaller 文件任务：

steps:
- task: MSIX.msix-ci-automation-task-dev.app-installer-file.AppInstallerFile@1
  displayName: 'Create App Installer file'
  inputs:
    package: '$(Build.ArtifactStagingDirectory)\MyApp.msix'
    outputPath: '$(Build.ArtifactStagingDirectory)\MyApp.appinstaller'
    uri: 'https://myuwpapp-demo.azurewebsites.net/MyApp.appinstaller'
    mainItemUri: 'https://myuwpapp-demo.azurewebsites.net/MyApp.msix'
    showPromptWhenUpdating: true
    updateBlocksActivation: true

UI

• 显示名称 - 自定义任务名称
• 包 - 这是要为其创建应用安装程序的包或捆绑的路径。
• 输出文件路径 - 这是要写入的应用安装程序文件的路径。
• 创建应用安装程序文件的方法 - 选择是创建新的应用安装程序文件还是更新现有的应用程序安装程序文件。 如果选择更新现有应用安装程序文件，系统将要求你提供现有应用安装程序文件的路径。
• 应用安装程序文件的版本 - 将给出的版本号。 必须采用格式（主版本号）.（次版本号）.（生成号）.（修订号）。
• URI - 重定向的应用安装程序文件的 Web URI。
• 主包/捆绑 URI - 应用包/捆绑位置的 URI。
• 启动时更新 - 选择此选项可将应用设置为在启动时检查更新。 如果选中此复选框，系统将要求你提供详细信息，例如“更新检查之间的小时数”、是否“更新时向用户显示 UI”，以及是否想要“更新以阻止应用激活”。

为 MSIX 应用附加创建包

YAML

以下示例演示如何在 yaml 文件中配置任务以创建用于应用附加的 VHDX 文件：

steps:
- task: MSIX.msix-ci-automation-task-dev.msix-app-attach.MsixAppAttach@1
  displayName: 'Create package for MSIX app attach'
  inputs:
    package: '$(Build.ArtifactStagingDirectory)\MyApp.msix'
    vhdxOutputPath: '$(Build.ArtifactStagingDirectory)\MyApp.vhdx'

UI

• 显示名称 - 自定义任务名称。
• 包路径 - 这是 MSIX 包/捆绑的路径。
• VHDX 输出路径 - 这是将由此任务创建的 VHDX 文件的路径。
• VHDX 大小 - VHDX 的最大大小 (MB)。

配置完所有任务后，可以使用“发布生成项目”任务将所有项目从临时位置发布到 Azure Pipelines 项目或所选文件共享。

向 AVD 发布 MSIX 应用附加包

YAML

以下示例演示如何在 yaml 文件中配置 avd 应用附加任务：

steps:
- task: MSIX.msix-ci-automation-task-dev.avd-app-attach-publish.AVDAppAttachPublish@0
  displayName: 'Publish MSIX app attach package to AVD'
  inputs:
    vhdxPath: '$(Build.ArtifactStagingDirectory)/App.vhdx' 
    connectedServiceNameARM: 'ed1db943-1e1c-4eac-8683-ead2abc281b5' 
    resourceGroupName: 'appattach-test-rg' 
    storageAccount: 'appattachteststorage' 
    fileShare: 'appattach-test-fs' 
    hostPool: 'appattach-hostpool' 
    workSpace: 'appattach-test-ws' 
    applicationGroup: 'appattach-test-ag-rail' 

UI

• 显示名称 - 自定义任务名称。

• 包路径 - 这是 MSIX 包/捆绑的路径。

• VHDX 输出路径 - 这是将由此任务创建的 VHDX 文件的路径。

• VHDX 大小 - VHDX 的最大大小 (MB)。

• 显示名称 - 自定义任务名称。

• VHDX 路径 - 这是应用将被附加（发布）到 Azure 虚拟桌面 (AVD) 的 VHDX 文件的路径。

• Azure 订阅 - 这是与应用程序需要附加的应用的目标 Azure 订阅的服务连接。 下拉列表列出了当前 ADO 登录用户可用的所有 Azure 订阅，用户可以选择其中任何订阅并与之建立服务连接。

• 资源组 - 选择需要发布应用的资源组。 此资源组应包含应用附加所需的所有目标资源，例如存储帐户、主机池、工作区、应用程序组。 此下拉列表列出了所选 Azure 订阅下所有可用的资源组。

• 存储帐户 - 选择要上传应用程序（或 VHDX）的存储帐户。 此下拉列表列出了所选资源组下的所有可用存储帐户。

• 文件共享 - 在所选存储帐户中选择要上传应用程序（或 VHDX）的文件共享。 此下拉列表列出了所选存储帐户下所有可用的文件共享。

• 主机池 - 选择要用于附加应用程序的主机池。 此下拉列表列出了所选资源组下所有可用的主机池。

• 工作区 - 选择要用于附加应用程序的工作区。 此下拉列表列出了所选资源组下所有可用的工作区。

• 应用程序组 - 选择要用于附加应用程序的应用程序组。 此下拉列表列出了所选资源组下所有可用的应用程序组。

配置完所有任务后，可以使用“发布生成项目”任务将所有项目从临时位置发布到 Azure Pipelines 项目或所选文件共享。

提供反馈的方法

欢迎提供有关 MSIX 打包扩展的反馈。 请通过以下渠道联系我们：

• 查看 Azure DevOps 商城上的扩展
• MSIX 技术社区
• GitHub 开放源代码项目 - 此扩展的源代码是 MSIX SDK 开放源代码项目的一部分，欢迎对此提出意见和建议。