Сайт

Публикация

Публикация расширения означает выбор того, кто может его видеть, повышение версии и создание Git-релиза (только в десктопной версии с привязанным удалённым репозиторием) перед загрузкой в Marketplace.

  1. Выберите аудиторию

    У основной кнопки диалога публикации два режима:

    • «Опубликовать» — релиз всем пользователям в Marketplace.
    • «Опубликовать внутри команды» — оставляет версию доступной только внутри вашей команды и не публикует её для всех пользователей.

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

  2. Повысьте версию

    Выберите patch, minor или major, либо введите версию вручную. Она должна быть корректной x.y.z и выше текущей. Релиз помечается тегом v{version}.

  3. Проверьте файлы

    В диалоге перечислены именно те файлы, которые будут отправлены, на основе .extensionignore и показаны Files, Size и Tag для быстрого просмотра. Файлы получают значок, если они always included (например, манифест), git-ignored или sensitive — напоминание исключить секреты или нежелательные файлы, которые ещё не указаны в .extensionignore.

  4. Релиз

    Подтвердите публикацию. Если в расширении заданы проверки перед публикацией, они выполняются первыми и должны успешно пройти, так как неудачная проверка блокирует релиз. В десктопной версии с привязанным удалённым репозиторием ваши исходники коммитятся, помечаются тегом v{version} и пушатся в удалённый репозиторий, после чего пакет загружается в Marketplace. Без привязанного удалённого репозитория (или не на десктопной версии) загружается только пакет Marketplace, отправки в Git не происходит.

Сначала привяжите удалённый репозиторий

Шагу Git-релиза нужен remote ля отправки. Вы можете привязать его одним из двух способов:

  • В «Контроле версий» — используйте «Добавить remote…» в панели «Контроль версий». Она добавляет origin и привязывает его к extension.
  • В манифесте — объявите git с URL репозитория.

Проверка монетизации

Если у extension есть блок billing, диалог показывает строку монетизации ещё до публикации:

  • Готово — все цены заданы и нет отличий с созданными офферами. Цены передаются в биллинг вместе с релизом.
  • Заблокировано — цена не задана или package.json расходится с созданным оффером. Кнопка «Опубликовать» при этом недоступна, а кнопка «Открыть монетизацию» ведёт в панель, где вы можете исправить эти проблемы.

Эта проверка применяется к обеим аудиториям и к «Опубликовать эту версию».

Продвижение уже загруженной версии

Если текущая версия уже загружена и находится в режиме ожидания («На проверке»), диалог предложит «Опубликовать эту версию», при выборе это лишь сменит её статус на «Опубликовано», без повторного релиза. Выберите «Опубликовать новую версию», чтобы повысить версию и создать новый релиз.

Быстрое обновление

Если расширение установлено, действие обновления в диалоге выполняет быстрое обновление: оно сохраняет, публикует и обновляет установленную копию до новой версии за один шаг, что удобно при итерациях.

После публикации

Опубликованная версия попадает в «На проверке» и получает статус «Опубликовано» после одобрения (или «Отклонено»). Версия «Опубликовать внутри команды» минует Marketplace и остаётся внутри команды. Какие файлы попали в пакет, описано Что публикуется.