Публікація розширення в 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. При кожному оновленні версія має бути строго більшою за попередню.
Скриншоти та графіка для листинга
Вимоги магазину:
- Іконка магазину: 128×128 px, PNG, без прозорості в кутах (магазин обріже)
- Скриншоти: мінімум 1, максимум 5, розмір 1280×800 або 640×400 px
- Промо-зображення (мале): 440×280 px (опціонально, але підвищує CTR)
- Промо-зображення (велике): 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 з scope https://www.googleapis.com/auth/chromewebstore.
Групові політики для корпоративного розповсюджень
Для внутрішніх розширень (лише працівники компанії) можна використовувати принудкову установку через Google Workspace Admin або Windows Group Policy, без публікації в магазину. Це обходить ревю для закритих інструментів.