Распространение выпусков с помощью внешне размещённых сборок

2025-05-05

Это важно

Центр приложений Visual Studio был прекращен 31 марта 2025 г., за исключением функций аналитики и диагностики, которые будут поддерживаться до 30 июня 2026 г. Подробнее.

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

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

Создание выпуска с внешним размещением сборки

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

Откройте приложение на веб-сайте Центра приложений, а затем перейдите к разделу "Распространение>выпусков " и выберите новый выпуск.
Выберите "Указать URL-адрес сборки ", чтобы перейти к мастеру создания выпуска без отправки двоичного файла в Центр приложений.
Введите необходимые сведения
1. URL-адрес HTTPS, указывающий на двоичный файл, который вы размещаете.
2. Номер сборки релиза.
3. Для некоторых из операционных систем: версия вашего выпуска.
Нажмите кнопку "Далее", чтобы ввести остальные сведения о выпуске. Отсюда процесс такой же, как и в случае обычных выпусков.
На вкладке "Заметки " при необходимости введите заметки о выпуске для тестировщиков. Нажмите кнопку Далее.
На вкладке "Пункты назначения" выберите тестировщиков или группы для распространения выпуска. Нажмите кнопку Далее.
На вкладке "Проверка " проверьте сведения о выпуске. При необходимости выберите не уведомлять пользователей о выпуске.
Наконец, выберите "Распространить", чтобы распространить выпуск. Он будет отображаться для тестировщиков, которые вы предоставили доступ, и они будут получать уведомления в зависимости от ваших параметров.

Создание выпуска с внешним размещением сборки с помощью API

Вы можете создать выпуск с двоичным файлом, размещенным вне Центра приложений, с помощью интерфейса программирования приложений (API). Первым шагом является создание релиза вместе с правильными URL-адресами и номерами версий. После этого вы можете дополнительно обновить выпуск с дополнительными сведениями и распространить его на тестировщиков.

Если вы не знакомы с API центра приложений или API в целом, ознакомьтесь с введением в API Центра приложений. Здесь вы можете узнать, как выполнить проверку подлинности в API и как найти имя владельца и имя приложения. Вам нужны следующие значения.

Создание внешнего релиза

Чтобы создать релиз, отправьте POST запрос на конечную точку /v0.1/apps/{owner_name}/{app_name}/releases. Эта конечная точка принимает текст со следующими параметрами:

external_download_url (обязательно): URL-адрес HTTPS, указывающий на двоичный файл, который вы размещаете.
build_version (обязательно): версия вашего выпуска.
build_number: номер сборки выпущенной версии.

Параметр {owner_name} в URL-адресе — это имя организации или учетной записи пользователя, которая владеет приложением и {app_name} является именем приложения. Ознакомьтесь с введением в API Центра приложений , чтобы узнать, как найти эти значения для приложения.

Например, давайте создадим новый выпуск для приложения Calculator, принадлежащего организации MyCorp в App Center. Файл сборки размещается в https://mycorp.example.com/calculator/builds/42. Версия — 1.12, а номер сборки — 87324.

Отправьте POST запрос на https://api.appcenter.ms/v0.1/apps/MyCorp/Calculator/releases с следующими данными JSON body:

{
    "build_version": "1.12",
    "build_number": "87324",
    "external_download_url": "https://mycorp.example.com/calculator/builds/42"
}

Задайте токен API в заголовке X-API-Token, а значение application/json для заголовка Content-Type. Пример ответа будет (некоторые значения опущены):

{
    "app_name": "Calculator",
    "is_external_build": true,
    "id": 4,
    "version": "87324",
    "short_version": "1.12",
    "download_url": "https://mycorp.example.com/calculator/builds/42",
    "install_url": "https://mycorp.example.com/calculator/builds/42",
    "destinations": []
}

Указанный URL-адрес является URL-адресом скачивания и is_external_build показывает, что это правильный тип выпуска. URL-адрес установки может отличаться в зависимости от операционной системы приложения. Список destinations пуст, что означает, что тестировщики еще не имеют доступа к выпуску. Давайте распространим следующий выпуск.

Распространение выпуска

После создания выпуска его можно распространить путем вызова распространения в конечную точку/v0.1/apps/{owner_name}/{app_name}/releases/{release_id}/groups POST группы. Кроме того, можно использовать аналогичную конечную точку для распространения тестировщикам. Помните, что вы не можете распространять выпуск со сборкой, размещённой на внешних ресурсах, в магазины приложений. См. требования и ограничения.

Используйте значение id, возвращенное при создании релиза, для параметра {release_id} в URL-адресе. id Найдите группу, которую вы хотите распространить, вызвав конечную точку GET групп рассылки. Здесь мы распространяем выпуск в группу 86aa9283-4e04-4872-a003-208c267d9388 и уведомляем тестировщиков о выпуске:

{
  "id": "86aa9283-4e04-4872-a003-208c267d9388",
  "notify_testers": true
}

Требования и ограничения

Внешне размещённые выпуски имеют следующие требования и ограничения:

Необходимо разместить двоичный файл за безопасным URL-адресом HTTPS. Центр приложений не принимает URL-адреса, начиная с http://, но только те, с которых начинается https://.
Вы можете распространять выпуски только со сборками, размещёнными внешне, для тестировщиков и групп. В таких магазинах, как Google Play и App Store, требуется отправить им двоичный файл.
Обновления в приложении не работают.
Центр приложений не может отображать хэш MD5, размер файла или профиль подготовки двоичного файла.
Центр приложений не может повторно подписать двоичный файл или автоматически управлять устройствами для приложений iOS.

Определение выпусков с внешне размещенными сборками

Выпуски с внешними размещенными сборками отображаются в Центре приложений с символом цепочки на значке. При запросе API сведений о выпуске, те, которые представлены как is_external_buildtrue, являются выпусками с сборками, размещёнными за пределами Центра приложений.

Значок выпуска со сборкой, размещённой на внешнем хостинге

На этом рисунке выпуск 4 является внешним выпуском, а остальные три размещаются в Центре приложений.