Упаковка и публикация интеграции

Сервисы Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Опубликуйте инструмент, службу или продукт, который интегрируется с Azure DevOps в Visual Studio Marketplace. Marketplace — это центральный центр для пользователей, которые могут обнаруживать интеграции и расширения.

Предпосылки

Перед публикацией в Marketplace необходимо выполнить следующий список требований.

Вам также потребуются следующие ресурсы:

• По крайней мере один снимок экрана интеграции
• URL для призыва к действию или начала использования для пользователей

Создание издателя

Каждое расширение или интеграция, включая интеграции от Microsoft, должно иметь издателя. Любой пользователь может создать издателя и опубликовать в нем расширения. Вы также можете предоставить доступ издателя другим пользователям, например команде разработчиков.

1. Войдите на Visual Studio Marketplace Publishing Portal.

2. Если вы не являетсяе частью существующего издателя, нажмите кнопку +Создать издателя.
   Введите имя издателя; Поле идентификатора автоматически заполняется на основе записи.

   

   Примечание.

   • Убедитесь, что имя издателя находится в пределах 16 символов для многобайтовых символов.
   • Сохраните идентификатор издателя— его нужно в файле манифеста расширения.

   Если вам не предлагается создать издателя, прокрутите страницу до Публиковать расширения под заголовком Связанные сайты.

   • Задайте уникальный идентификатор издателя, например mycompany-myteam. Используйте это значение для атрибута publisher в манифесте.
   • Задайте отображаемое имя, например My Team.

3. Просмотрите соглашение издателя Marketplace и нажмите кнопку "Создать".

   

После создания издателя можно управлять элементами, хотя никакие элементы не отображаются до публикации.

Настройка структуры проекта

Создайте следующий макет каталога:

home/
├── images/
│   ├── integration-logo.png    (128×128 px minimum)
│   └── screenshot.png          (1366×768 px)
├── overview.md
└── vss-integration.json

Создание манифеста

Создайте следующее содержимое, а затем обновите vss-integration.json значения для интеграции:

{
    "manifestVersion": 1,
    "id": "myservice",
    "version": "1.0.0",
    "name": "My Service",
    "publisher": "mycompany",
    "description": "Awesome tools to help you and your team do great things everyday.",
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services.Integration"
        }
    ],    
    "icons": {
        "default": "images/service-logo.png"
    },
    "categories": [
        "Plan and track"
    ],
    "tags": [
        "working",
        "people person",
        "search"
    ],
    "screenshots": [
        {
            "path": "images/screen1.png"
        },
        {
            "path": "images/screen2.png"
        }
    ],
    "content": {
        "details": {
            "path": "overview.md"
        },
        "license": {
            "path": "fabrikam-license-terms.md"
        }
    },
    "links": {
        "getstarted": {
            "uri": "https://www.mycompany.com/help/getstarted"
        },
        "learn": {
            "uri": "https://www.mycompany.com/features"
        },
        "support": {
            "uri": "https://www.mycompany.com/support"
        }
    },
    "branding": {
        "color": "rgb(34, 34, 34)",
        "theme": "dark"
    }
}

Обновите поля с помощью следующих ссылок:

Требуются следующие свойства:

Следующие необязательные свойства помогают пользователям обнаруживать и узнать о расширении.

Упаковка интеграции

1. Установите средство упаковки, если вы еще не сделали:

   npm install -g tfx-cli
   

2. Упаковайте интеграцию в VSIX-файл:

   tfx extension create --manifest-globs vss-integration.json
   

   Подсказка

   Используется --rev-version для автоматического увеличения номера версии исправления.

Публикация в Marketplace

После упаковки расширения его можно отправить в Marketplace от имени издателя. Идентификатор publisher, указанный в файле манифеста расширения , должен соответствовать идентификатору издателя, под которым загружено расширение.

1. На портале управления выберите издателя в раскрывающемся меню в верхней части страницы.

2. Выберите Новое расширение>Azure DevOps.

   

3. Перетащите файл или выберите его, чтобы найти созданный вами на предыдущем этапе упаковки файл VSIX, а затем выберите Загрузить.

   

   После быстрой проверки расширение появится в списке опубликованных расширений. Не беспокойтесь, расширение видно только вам.

   

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

Поделитесь интеграцией

Прежде чем установить интеграцию в организации Azure DevOps, необходимо поделиться ею с этой организацией.

1. Выберите интеграцию из списка отображаемых элементов.
2. Выберите Поделиться.
3. Введите имя организации (например, fabrikam-fiber-inc для dev.azure.com/fabrikam-fiber-inc).

Обновление интеграции

Чтобы обновить уже опубликованное расширение, сделайте следующее:

1. Выберите расширение из списка отображаемых элементов.
2. Щелкните правой кнопкой мыши и выберите "Обновить " для версии разработки, например publisher.extension-dev.
3. Подтвердите ваше расширение.
4. Примените те же обновления к рабочей версии, например publisher.extension.
5. Перейдите к .VSIX-файлу для расширения и загрузите его.

Azure DevOps автоматически устанавливает обновленную версию для всех учетных записей, у которых уже есть расширение. Новые установки также получают последнюю версию.

Сделать интеграцию общедоступной

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

Дополнительные сведения о требованиях, необходимых для общедоступных списков, см. раздел Сделать расширение общедоступным.

Связанный контент

• Референция манифеста расширения
• Упакуйте и опубликуйте расширения
• Visual Studio Marketplace