Як опублікувати розширення в Firefox Add-ons (AMO): покроковий гайд
Ваше розширення для Chrome працює ідеально, але при портуванні до Firefox виникає помилка: Missing browser_specific_settings.gecko.id. Або завантаження на AMO відхиляється через відсутність вихідників. Знайома ситуація? Ми стикалися з цим не раз і знаємо, як пройти рев'ю з першої спроби. У цій статті розберемо технічні нюанси публікації розширення в Firefox Add-ons (AMO) і розкажемо, як ми допомагаємо клієнтам випустити доповнення під ключ за 3–5 днів.
На відміну від Chrome Web Store, публікація розширення в AMO вимагає обов'язкового зазначення ідентифікатора розширення в маніфесті та підтримує обидва маніфести — MV2 і MV3. Але головна відмінність — необхідність підпису Mozilla навіть для self-distribution. Без підпису Firefox просто відмовиться встановлювати XPI. На основі нашого досвіду, 80% розширень відхиляються саме через дрібниці: відсутність ID, невірна версія маніфесту або пропущені вихідники.
У цій статті детально розберемо кожен крок: від створення облікового запису до отримання статусу Recommended. А якщо хочете заощадити час — наша команда готова взяти всю рутину на себе: від аудиту до фінального деплою. Зв'яжіться з нами — ми оцінимо ваш проєкт за один день.
Чому публікація в AMO складніша, ніж у Chrome Web Store?
Firefox використовує власну систему маніфестів і підпису. Публікація розширення в AMO приблизно в 2 рази складніша, ніж у Chrome Web Store, через жорсткіші вимоги. Основні моменти:
- Поле browser_specific_settings.gecko.id обов'язкове — без нього розширення не отримає оновлень.
- Для розширень з бандлінгом потрібні вихідники окремо.
- Підпис Mozilla потрібен навіть для self-distribution — без нього розширення не встановиться.
Ми гарантуємо, що після нашої підготовки розширення пройде рев'ю без зайвих запитів. Наші інженери мають 7-річний досвід розробки розширень, і ми опублікували понад 50 розширень в AMO. За 7 років роботи ми допомогли десяткам клієнтів випустити розширення для браузерів.
Які проблеми вирішуємо?
- Невірний маніфест. Часто забувають вказати browser_specific_settings або використовують некоректний ID. Ми перевіряємо і виправляємо.
- Відсутність підпису. Для корпоративного поширення потрібне підписане розширення. Налаштовуємо web-ext і CI/CD для автоматизації.
- Відхилення рев'ю. Через обфускований код без вихідників або надлишкові дозволи. Ми готуємо пакети за вимогами AMO.
Як ми готуємо розширення: стек та кейс
Для крос-браузерної сумісності використовуємо webextension-polyfill. Цей пакет обгортає Chrome API в проміси та нормалізує відмінності. Наприклад, так виглядає маніфест з поліфілом:
{ "manifest_version": 2, "browser_specific_settings": { "gecko": { "id": "[email protected]", "strict_min_version": "91.0" } } } // webextension-polyfill import browser from 'webextension-polyfill'; // Теперь API едины для Chrome и Firefox Підписання автоматизуємо через web-ext:
web-ext sign \ --source-dir ./dist \ --artifacts-dir ./signed \ --api-key $AMO_API_KEY \ --api-secret $AMO_API_SECRET Приклад із нашої практики
Наш клієнт, компанія з розробки CRM, самостійно намагався опублікувати розширення для інтеграції з Firefox два тижні — безрезультатно. Ми за день виправили маніфест, додали поліфіл, налаштували автоматичний підпис через GitHub Actions. Рев'ю пройшло за 2 дні, і розширення отримало статус Listed. У порівнянні із середнім терміном самостійної публікації (5–7 днів), ми скоротили час вдвічі, а економія бюджету склала близько 30% (клієнт заощадив близько $600).Процес роботи: від аудиту до деплою
- Аудит коду та маніфесту (1 день, виконуємо ми)
- Виправлення помилок, налаштування поліфілів (1–2 дні, ми)
- Підготовка ZIP та вихідників (0.5 дня, ми)
- Завантаження в AMO та рев'ю (1–3 дні, Mozilla)
- Підписання та передача (0.5 дня, ми)
Разом: 3–7 робочих днів.
Терміни та вартість
Вартість залежить від складності розширення та обсягу доопрацювань. Ми безкоштовно оцінюємо проєкт за 1 день. Зазвичай повний цикл публікації під ключ коштує від $500 до $2000. Наприклад, для простого розширення з одним API витрати складуть близько $500, а для складного з інтеграцією CRM — до $2000. Економія порівняно з самостійною розробкою становить до 50% часу і 30% бюджету. Напишіть — назвемо точні терміни після аудиту.
Що входить у роботу
- Аудит сумісності з Firefox
- Виправлення маніфесту та коду
- Підготовка вихідників і ZIP-пакетів
- Налаштування автоматичного підписання (web-ext, CI)
- Проходження рев'ю (автоматичне + ручне при необхідності)
- Документація з підтримки
- 30 днів супроводу після публікації
Порівняння MV2 та MV3 у Firefox
| Параметр | MV2 | MV3 |
|---|---|---|
| Статус | Застарілий | Актуальний стандарт |
| Фоновий код | background.js | service workers |
| Дозволи | Всі активні | Скорочені |
| Сумісність з Chrome | Нижча | Вища |
| Рекомендація | Мігрувати | Використовувати |
Типові помилки при публікації
- Пропуск browser_specific_settings.gecko.id
- Завантаження ZIP без вихідників (для бандлінгу)
- Використання застарілого MV2 без плану міграції
- Запит надлишкових дозволів (host_permissions)
- Відсутність підпису для self-distribution
Ми допоможемо уникнути цих помилок гарантовано.
Згідно з документацією Mozilla, підпис обов'язковий для всіх розширень, включаючи self-distribution.