Публикация расширения в Chrome Web Store
Chrome Web Store — единственный официальный канал распространения расширений для Chrome. Процесс публикации включает регистрацию аккаунта разработчика, подготовку пакета и прохождение ревью.
Регистрация аккаунта разработчика
Перейдите на chrome.google.com/webstore/devconsole. Требуется аккаунт Google и однократный взнос $5 для верификации. После оплаты — постоянный доступ без ограничений по количеству расширений.
Подготовка ZIP-пакета
В архив входят только файлы расширения, без скрытых файлов и папок разработки:
# Сборка перед публикацией
npm run build
# Создание архива — исключаем ненужное
cd dist/
zip -r ../extension-v1.2.0.zip . \
--exclude "*.map" \
--exclude ".DS_Store" \
--exclude "node_modules/*" \
--exclude "*.test.js"
Структура пакета:
manifest.json ← обязателен в корне
icons/
icon-16.png
icon-32.png
icon-48.png
icon-128.png ← используется в Web Store
background/
sw.js
content/
injected.js
popup/
popup.html
popup.js
Требования к manifest.json
{
"manifest_version": 3,
"name": "Название расширения",
"version": "1.0.0",
"description": "Краткое описание до 132 символов — появляется в листинге магазина",
"icons": {
"16": "icons/icon-16.png",
"32": "icons/icon-32.png",
"48": "icons/icon-48.png",
"128": "icons/icon-128.png"
}
}
version должен соответствовать формату 1.2.3 или 1.2.3.4. При каждом обновлении версия должна быть строго больше предыдущей.
Скриншоты и графика для листинга
Требования Store:
- Иконка магазина: 128×128 px, PNG, без прозрачности в уголках (Store обрезает)
- Скриншоты: минимум 1, максимум 5, размер 1280×800 или 640×400 px
- Промо-изображение (Small): 440×280 px (опционально, но повышает CTR)
- Промо-изображение (Large): 920×680 px (для промо-блока на главной)
- Видео: ссылка на YouTube (опционально)
Скриншоты делайте с реальным контентом, показывайте ключевые сценарии использования.
Заполнение листинга
В Developer Dashboard:
- Название: до 45 символов. Уникальное, точно описывает функцию.
- Краткое описание: до 132 символов. Первые 45 — самые важны для поиска.
- Подробное описание: HTML поддерживается частично. Используйте списки, чётко описывайте возможности.
- Категория: выбирается из списка (Productivity, Developer Tools, и т.д.)
-
Язык: основной язык листинга. Можно добавить локализованные версии через
_locales/.
Privacy disclosure
С 2024 года обязательно заполнять Data Privacy Policy:
- Указать, какие данные собирает расширение
- Если расширение не собирает данных — явно отметить это
- Ссылка на Privacy Policy (обязательна если собираете хоть что-то)
Без корректного заполнения ревью завернут.
Публикация и ревью
После загрузки ZIP и заполнения листинга — кнопка «Submit for review». Ревью обычно занимает от нескольких часов до нескольких дней. Первая публикация нового расширения занимает дольше (до 2-3 недель в сложных случаях).
Причины отказа и как их избежать:
- Запрос излишних разрешений — просите только то, что реально используете. Каждое разрешение требует обоснования.
-
Внешний код без политики безопасности — весь JS должен быть в пакете или нужна явная декларация в
content_security_policy. -
Нарушение политики минимальных разрешений —
<all_urls>вместо конкретных хостов будет поводом для дополнительной проверки. - Отсутствующая или некорректная Privacy Policy — при сборе любых данных.
Обновление расширения
Загрузите новый ZIP с увеличенной версией через Developer Dashboard → кнопка «Upload new package». Обновление проходит тот же ревью. Пользователи получат обновление автоматически в течение нескольких часов после публикации.
Автоматизация через Chrome Web Store API
Для CI/CD можно загружать обновления автоматически:
# Установка chrome-webstore-upload-cli
npm install -g chrome-webstore-upload-cli
# Публикация
webstore upload \
--source extension.zip \
--extension-id your-extension-id \
--client-id $CWS_CLIENT_ID \
--client-secret $CWS_CLIENT_SECRET \
--refresh-token $CWS_REFRESH_TOKEN \
--auto-publish
Токены получают через Google Cloud Console → OAuth 2.0 с scопом https://www.googleapis.com/auth/chromewebstore.
Групповые политики для корпоративного распространения
Для internal-расширений (только сотрудники компании) можно использовать принудительную установку через Google Workspace Admin или Windows Group Policy, без публикации в Store. Это обходит ревью для закрытых инструментов.