Поделиться через

Экспорт конфигурации сборки Центра приложений в Azure Pipelines

  • Статья

Важно!

Прекращение поддержки Центра приложений Visual Studio запланировано на 31 марта 2025 г. Хотя вы можете продолжать использовать Центр приложений Visual Studio до полного прекращения его использования, существует несколько рекомендуемых вариантов, на которые можно перейти.

Узнайте больше о сроках поддержки и альтернативных вариантах.

Общие сведения

С помощью Центра приложений можно экспортировать все конфигурации сборки Центра приложений в Azure Pipelines с помощью функции экспорта сборок. Вы можете скачать ФАЙЛ JSON или YAML и импортировать его в Azure Pipelines.

Хотя прямая миграция конфигураций сборки Центра приложений в Azure Pipelines является самым простым вариантом, она может быть недостаточно оптимизирована для конкретного приложения. Рассмотрите возможность создания Azure Pipelines с нуля для более оптимизированного взаимодействия (Android, Xcode, Xamarin)

Предварительные требования

Вам потребуется проект Azure DevOps, в который вы будете импортировать конфигурацию сборки. Вы можете создать новый проект или использовать существующий.

(Необязательно) Добавление подключения к службе для задач Центра приложений

Если в конфигурацию сборки интегрированы тесты центра приложений или распространение центра приложений, необходимо создать подключение к службе.

  1. Перейдите в раздел Параметры проекта Azure DevOps —> Конвейеры —> Подключения к службам
  2. Выберите "Новое подключение к службе".
  3. Выполните поиск по запросу "Центр приложений Visual Studio" —> далее
  4. Создайте маркер API, присвойте подключению имя и сохраните его.

Экспорт с помощью JSON-файла

ЭкспортИРУЙТЕ JSON-файл со страницы сборки Центра приложений.

  1. Перейдите на портал Центра приложений.
  2. Выбор приложения
  3. Перейдите в раздел Сборка, выберите свою ветвь и выберите экспорт Нажмите кнопку Экспорт.
  4. Выберите "Скачать" и выберите "Скачать JSON".

Изменение идентификатора проекта в JSON-файле

Получение идентификатора проекта Azure DevOps

  1. Перейдите по URL-адресу ниже и скопируйте идентификатор проекта.
https://dev.azure.com/{organization}/_apis/projects?api-version=6.0

Идентификатор проекта 2. Вставьте идентификатор проекта в project параметр JSON-файла.

Изменение JSON

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

  1. Перейдите в раздел Azure DevOps —> Конвейеры —> Импорт конвейера и выберите скачанный конвейер JSON-файла Импорт.
  2. В Pipeline разделе выберите Hosted (Azure Pipelines) под параметром Agent Pool
  3. Выберите последнюю версию агента macOS, размещенного в Майкрософт, в параметре .Agent Specification
  4. В Get Sources разделе добавьте подключение к репозиторию приложения.

(Необязательно) Отправка файлов подписи и обновление паролей

Если вы используете вход кода в конфигурациях сборки Центра приложений, вам потребуется отправить соответствующие файлы в Azure Pipelines с помощью функции "Безопасные файлы ". Кроме того, необходимо обновить переменные паролей , хранящиеся в конвейерах.

Android

  1. Отправка файла хранилища ключей в проект Azure DevOps
  2. Обновление keystorePasswordпеременных , keyAlias, keyPasswordи keystoreFilename

iOS/macOS

  1. Отправка профилей и сертификатов подготовки в проект Azure DevOps
  2. Обновление P12Passwordпеременных , P12Filenameи MobileProvisionFilename

Windows (UWP)

  1. Отправка сертификата в проект Azure DevOps
  2. Обновление packageCertificatePassword, packageCertificateFileNameи packageCertificateBase64String

Если у вас интегрирована система распространения или тестирования Центра приложений, вам потребуется изменить соответствующие задачи.

  1. Перейдите к Azure DevOps —> Конвейеры
  2. Выберите импортированные конвейеры и нажмите кнопку Изменить.
  3. Найдите задачи Центра приложений и выберите ранее созданное подключение к службе в параметре "Подключение к службе центра приложений" Подключение службы.

Экспорт с помощью YAML-файла

Экспорт файла YAML со страницы сборки Центра приложений.

  1. Перейдите на портал Центра приложений.
  2. Выбор приложения
  3. Перейдите в раздел Сборка, выберите свою ветвь и выберите экспорт Нажмите кнопку Экспорт.
  4. Выберите "Скачать" и выберите "Скачать YAML".

Настройка репозитория для работы с Azure Pipelines

  1. Фиксация скачаемого azure-pipelines.yml файла в репозитории приложения
  2. Перейдите в раздел Azure DevOps —> Конвейеры —> Создание конвейера.
  3. Выбор расположения кода
  4. Проверьте конвейер и выберите Run

Дополнительные сведения о процессе создания конвейера YAML можно найти здесь.

(Необязательно) Отправка файлов подписи и обновление паролей

Если вы используете вход кода в конфигурациях сборки Центра приложений, вам потребуется отправить соответствующие файлы в Azure Pipelines с помощью функции "Безопасные файлы ". Кроме того, необходимо обновить переменные паролей , хранящиеся в конвейерах.

Android

  1. Отправка файла хранилища ключей в проект Azure DevOps
  2. Создание keystorePasswordсекретных переменных , keyAlias, keyPasswordи keystoreFilename в Azure Pipelines
  3. Обновление файла YAML с помощью созданных переменных секрета
...
  keystorePassword: $(keystorePassword)
  keyAlias: $(keyAlias)
  keyPassword: $(keyPassword)
  keystoreFilename: $(keystoreFilename)
...

iOS/macOS

  1. Отправка профилей и сертификатов подготовки в проект Azure DevOps
  2. Создание P12Passwordсекретных переменных , P12Filenameи MobileProvisionFilename в Azure Pipelines
  3. Обновление файла YAML с помощью созданных переменных секрета
...
  P12Password: $(P12Password)
  P12Filename: $(P12Filename)
  MobileProvisionFilename: $(MobileProvisionFilename)
...

Windows (UWP)

  1. Отправка сертификата в проект Azure DevOps
  2. Создание packageCertificatePasswordсекретных переменных , packageCertificateFileNameи packageCertificateBase64String в Azure Pipelines
  3. Обновление файла YAML с помощью созданных переменных секрета
...
  packageCertificatePassword: $(packageCertificatePassword)
  packageCertificateBase64String: $(packageCertificateFileName)
  packageCertificateFileName: $(packageCertificateBase64String)
...

(Необязательно) Авторизация только что созданного конвейера для использования подключения к службе центра приложений

Если у вас интегрирована система распространения или тестирования Центра приложений, вам потребуется авторизовать конвейеры для использования подключения к службе.

  1. Откройте выполняемое в данный момент задание, вы увидите сообщение о разрешениях
  2. Выберите запущенное задание и Permit доступ к подключению службы Разрешить.