Расширение упаковки MSIX

Расширение упаковки MSIX — это расширение для Azure DevOps, которое помогает создавать, упаковывать и подписывать приложения Windows с использованием формата пакета MSIX.

Рабочие процессы CI/CD стали неотъемлемой частью процесса разработки для повышения эффективности и качества при снижении затрат и времени вывода на рынок. Решение CI/CD Майкрософт Azure DevOps Pipelines широко распространено и популярно, но текущий процесс интеграции рабочих процессов сборки и развертывания для приложений, которые необходимо упаковать как MSIX в Azure Pipelines, является утомительным, особенно для людей, которые не являются экспертами Azure Pipelines или MSIX. Это расширение Azure DevOps предлагает простое и интуитивно понятное решение, что упрощает автоматизацию процесса сборки и развертывания для приложений, упакованных как MSIX, и для приложений с существующими рабочими процессами CI/CD для перехода в MSIX без нарушения их механизмов сборки и развертывания.

Расширение упаковки MSIX содержит следующие задачи, которые можно использовать для настройки вашего конвейера в соответствии с вашими требованиями:

1. Сборка и пакет MSIX — создание и упаковка приложений Windows с помощью формата пакета MSIX
2. Подписывание пакета MSIX — подписывание пакетов MSIX с помощью доверенного сертификата
3. Файл установщика приложений для MSIX — создание или обновление файла appinstaller для приложений MSIX
4. Создание пакета для подключения приложения MSIX — создание пакета VHDX для подключения приложения MSIX

Установка расширения

Просмотрите Azure DevOps Marketplace и найдите расширение MSIX Packaging Extension.

Создание конвейера

Создайте конвейер для проекта Azure DevOps.

Выберите параметр "Использовать классический редактор" для создания конвейера без YAML.

Выберите систему управления версиями и укажите сведения о репозитории и ветви по умолчанию.

При запросе на выбор шаблона нажмите кнопку "Пуск" с пустого задания.

Измените выбор спецификации агента на windows-2019 , так как расширение MSIX выполняется только в агенте Windows.

Вы должны видеть Задание агента 1 по умолчанию в вашем конвейере. Щелкните значок плюса, чтобы добавить задачу в задание агента 1.

Найдите MSIX в строке поиска «Добавление задач», и вы увидите ранее упомянутые задачи в расширении MSIX Packaging. Вы можете по своему усмотрению создать конвейер, добавив задачи, необходимые в соответствии с вашими требованиями. Но мы покажем, как настроить все четыре задачи на этой странице.

Сборка и пакетирование MSIX

Примечание. Если вы пытаетесь создать упакованое приложение с помощью этой задачи, необходимо включить проект упаковки приложений Windows, так как задача нуждается в файле Package.appxmanifest. Задача не добавит это автоматически для вас.

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

Пользовательского интерфейса

• Отображаемое имя — настройка имени задачи
• Выходной путь — укажите выходной путь для пакета MSIX, который будет создан этой задачей. Путь в приведенном выше примере использует предопределенную переменнуюBuild.ArtifactStagingDirectory , которая является локальным путем агента для хранения артефактов, и используется здесь для хранения выходных файлов задач, которые позже можно опубликовать с помощью задачи публикации артефактов.
• Создание решения с помощью MSBuild — выберите этот параметр, чтобы создать решение с помощью msbuild для указанной целевой платформы. Оставьте флажок снятым, если у вас уже есть бинарные файлы, которые нужно упаковать. Если вы оставите флажок пустым, вам предложат указать путь к двоичным файлам.
• Проект для сборки — укажите путь к файлу проекта или решения, который необходимо создать.
• Очистка перед сборкой — установите этот флажок, если вы хотите, чтобы задача выполняла чистую сборку до сборки.
• Создайте пакет MSIX . Установите этот флажок, чтобы создать пакет MSIX вместо пакета. Не забудьте назвать ваш выходной файл в параметре Выходного пути с расширением ".msixbundle" вместо ".msix".
• Конфигурация — выбор между конфигурациями отладки и релиза.
• Платформа — укажите целевую платформу сборки, например x64, x86, любой ЦП.
• Обновление версии приложения в манифесте . Установите этот флажок, чтобы изменить версию приложения, указанную в appxmanifest-файле приложения. Это не перезаписывает файл APPXmanifest, но не изменяет версию приложения в созданном выходном пакете MSIX. Если этот параметр выбран, вам будет предложено указать путь к файлу манифеста и номер версии приложения, заданный для приложения.
• Режим распространения пакета приложения — выберите режим в раскрывающемся меню, чтобы создать пакет приложения 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)'

Пользовательского интерфейса

В этом примере показана задача, когда источник сертификата является библиотекой безопасных файлов.

В этом примере показана задача, когда источник сертификата — Azure Key Vault.

• Отображаемое имя — настройка имени задачи
• Пакет для подписи — задача подписывания пакета MSIX использует SignTool для подписания всех файлов, соответствующих этому пути, независимо от того, являются ли они пакетами MSIX или пакетами-свёртками.
• Тип файла сертификата — выберите источник используемого файла сертификата.
• Сервер временных меток — это URL-адрес, указывающий на адрес сервера временных меток. Этот параметр является необязательным.

Файл установщика приложений для MSIX

YAML

Ниже приведен пример, в который показано, как настроить задачу файла AppInstaller в yaml-файле:

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

Пользовательского интерфейса

• Отображаемое имя — настройка имени задачи
• Пакет — это путь к пакету или пакету, для которого требуется создать установщик приложений.
• Путь к выходному файлу — это путь к файлу установщика приложений для записи.
• Метод создания файла установщика приложений — выберите, следует ли создать файл установщика приложений или обновить существующий файл. Если вы решили обновить существующую, вам будет предложено указать путь к существующему файлу установщика приложений.
• Версия файла установщика приложений — номер версии, который будет указан. Должен принимать форму (основной). (незначительный). (сборка). (редакция).
• URI — веб-URI для перенаправленного файла установщика приложений.
• Основной URI пакета/набора — URI местоположения пакета или набора приложения.
• Обновление при запуске . Выберите это, чтобы установить приложение, чтобы проверить наличие обновлений при запуске. Если установлен этот флажок, вам будет предложено указать такие сведения, как часы между проверками обновления, хотите ли вы показывать интерфейс при обновлении и хотите ли блокировать обновлением активацию приложения.

Создание пакета для подключения приложения MSIX

YAML

Ниже приведен пример настройки задачи для создания VHDX-файла для подключения приложения в yaml-файле:

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'

Пользовательского интерфейса

• Отображаемое имя — настройка имени задачи.
• Путь пакета - Это путь к пакету/пакету MSIX.
• Путь вывода VHDX — это путь к VHDX-файлу , который будет создан задачей.
• Размер VHDX — максимальный размер в МБ виртуального жесткого диска.

После настройки всех задач можно использовать задачу "Опубликовать артефакты сборки", чтобы переместить все артефакты из временного расположения в артефакты Azure Pipelines или на сетевой ресурс по вашему выбору.

Публикация пакета подключения приложения MSIX к AVD

YAML

Ниже приведен пример настройки задачи подключения приложения avd в yaml-файле:

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' 

Пользовательского интерфейса

• Отображаемое имя — настройка имени задачи.

• Путь пакета - Это путь к пакету/пакету MSIX.

• Путь вывода VHDX — это путь к VHDX-файлу , который будет создан задачей.

• Размер VHDX — максимальный размер в МБ виртуального жесткого диска.

• Отображаемое имя — настройка имени задачи.

• Путь VHDX — это путь к VHDX-файлу, который будет присоединен (опубликован) в Виртуальном рабочем столе Azure (AVD).

• Подписка Azure - Это подключение службы к целевой подписке Azure, к которой должно быть присоединено ваше приложение. В раскрывающемся списке перечислены все подписки Azure, доступные для текущего пользователя ADO, вошедшего в систему, и пользователь может выбрать любой из этих подписок и установить подключение к службе.

• Группа ресурсов — выберите группу ресурсов, которую необходимо опубликовать в приложении. Эта группа ресурсов должна содержать все целевые ресурсы, необходимые для подключения приложений, такие как учетная запись хранения, пул узлов, рабочая область и группа приложений. В этом раскрывающемся списке перечислены все группы ресурсов, доступные в выбранной подписке Azure.

• Учетная запись хранилища - Выберите учетную запись хранилища, в которую будет загружено ваше приложение (или VHDX). В этом раскрывающемся списке перечислены все учетные записи хранения, доступные в выбранной группе ресурсов.

• Файл общего доступа — выберите файл общего доступа в выбранной учетной записи хранения, в который вы хотите загрузить ваше приложение (или VHDX). В этом раскрывающемся списке перечислены все файловые ресурсы, доступные в выбранном хранилище.

• Пул узлов — выберите пул узлов, который будет использоваться для присоединения приложения. В раскрывающемся списке перечислены все пулы узлов, доступные в выбранной группе ресурсов.

• Рабочая область — выберите рабочую область, которая будет использоваться для привязки приложения. В раскрывающемся списке перечислены все рабочие области, доступные в выбранной группе ресурсов.

• Группа приложений — выберите группу приложений, которая будет использоваться для присоединения приложения. В раскрывающемся списке перечислены все группы приложений, доступные в выбранной группе ресурсов.

После настройки всех задач можно использовать задачу "Опубликовать артефакты сборки", чтобы переместить все артефакты из временного расположения в артефакты Azure Pipelines или на сетевой ресурс по вашему выбору.

Способы предоставления отзывов

Мы хотели бы услышать ваши отзывы о расширении MSIX для пакетирования. Обратитесь к нам через следующие каналы:

• Просмотр расширения в Azure DevOps Marketplace
• Техническое сообщество MSIX
• Проект с открытым кодом GitHub — исходный код для этого расширения является частью проекта с открытым исходным кодом пакета SDK MSIX, который приветствует вклады и предложения.