Google ChromeGoogle Chrome

Jedno rozšíření, čtyři obchody: publikuj v Chromu, Edgi, Firefoxu a Safari ze stejného kódu

Tým AiToolsForAppsNapsáno s pomocí AI15 min čtení

Ve zkratce

  • Od Chromu 148 jsou všechna API rozšíření dostupná pod namespace browser, vedle klasického chrome, podle příručky Transition to browser namespace od Chrome for Developers. Shrnutí I/O 2026 pro webová rozšíření (listopad 2026) to říká takto: sdílený globál „snižuje potřebu aliasů pro kompatibilitu“.
  • Rozšíření s devtools_page zpočátku zůstala stranou: podpora browser v tomto případě přišla v Chromu 152.
  • Co se nesjednotilo, je karta v obchodě: Chrome chce snímky 1280x800, Edge přijímá 640x480 nebo 1280x800, Apple vyžaduje 16:10 bez alfa kanálu (1280x800, 1440x900, 2560x1600 nebo 2880x1800) a AMO doporučuje 1280x800 nebo poměr 1,6:1.
  • Ani limity textu se neshodují: description v manifestu 132 znaků v Chromu, popis v obchodě 250 až 10 000 v Edgi, shrnutí 250 v AMO a název aplikace 30 v App Store Connect.
  • A ochrana soukromí se deklaruje čtyřikrát: záložka Privacy v Chromu, stránka Privacy v Partner Center, data_collection_permissions v manifestu pro AMO a zásady ochrany soukromí v App Store Connect.
Jeden blok kódu, ze kterého vycházejí čtyři světelné pásy ke čtyřem prázdným rámům různých proporcí, jeden pro každý obchod s rozšířeními
Jeden blok kódu, ze kterého vycházejí čtyři světelné pásy ke čtyřem prázdným rámům různých proporcí, jeden pro každý obchod s rozšířeními

Po léta začínalo přenesení rozšíření pro Chrome do Firefoxu, Edge a Safari stejným ošklivým řádkem v záhlaví každého souboru: aliasem, který rozhodoval, jestli se sáhne na chrome.*, nebo na browser.*. V roce 2026 je ten řádek nadbytečný. Nadbytečné zůstávají pořád hodiny, které se ztratí předěláváním karty v obchodě čtyřikrát, a tady přichází ke slovu aiChrome, nástroj od AiToolsForApps pro ty, kdo rozšíření pro Chrome vytvářejí, prodávají nebo v nich soutěží: má katalog rozměrů a limitů karty v Chrome Web Store s ověřovacím razítkem a to, co nesedí se specifikací, se nedodá. Tento článek vypráví, co už není v kódu potřeba a co zůstává ruční prací obchod po obchodu.

Co přesně se v roce 2026 změnilo s namespace browser?

Chrome převzal globál browser, který už používaly Firefox a Safari. Podle oficiální dokumentace přechodu na namespace browser jsou „od Chromu 148 všechna API rozšíření Chromu dostupná pod namespace browser, vedle stávajícího chrome“. Namespace chrome se neodstraňuje: oba existují vedle sebe, takže se nic nerozbije.

Praktický dopad je, že rozšíření cílené jen na moderní prohlížeče lze napsat jednou, s browser.* a promisy, a funguje ve všech čtyřech enginech bez mezivrstvy. Dva důležité detaily:

  • runtime.onMessage přijímá promisy. V Chromu 148 může listener přímo vrátit Promise a odpovědět asynchronně, místo klasického return true, které drží kanál otevřený.
  • Polyfill přestává být potřeba. Dokumentace Chromu uvádí, že webextension-polyfill „v Chromu 148 a novějších nedělá nic“, protože prohlížeč už má nativní podporu.
Vlevo dva zamotané kabely spojené adaptérem; vpravo jediný čistý souvislý kabel bez adaptéru
Vlevo dva zamotané kabely spojené adaptérem; vpravo jediný čistý souvislý kabel bez adaptéru

Mohu používat browser, aniž bych rozbil věci uživatelům se starým Chromem?

Ano, a sama dokumentace Chromu uvádí dvě cesty. Pokud je tvé publikum už na Chromu 148 nebo vyšším, deklaruj v manifestu "minimum_chrome_version": "148" a používej browser bez podmínek. Pokud potřebuješ pokrýt starší verze, dej na začátek spuštění guard:

if (!globalThis.browser) {
  globalThis.browser = chrome;
}

Případ, který nejvíc překvapuje, jsou DevTools. Ve starších verzích deklarace devtools_page vypínala namespace browser v celém rozšíření, nejen na stránce DevTools. Toto omezení zmizelo v Chromu 152, takže už pokrývá jakékoli rozšíření. Listenery onMessage, které vracejí promisy, stále nejsou dostupné v kontextech stránky DevTools.

Co se v kódu pořád nesjednotilo

To, že je namespace stejný, neznamená, že je stejný i manifest. Podle příručky MDN pro vytvoření multiprohlížečového rozšíření:

BodChrome / EdgeFirefoxSafari
Namespacechrome a browser (148+)browser (a chrome kvůli kompatibilitě)browser
Pozadí v MV3service worker rozšířenístránky na pozadípodporuje obojí
browser_specific_settingsnepodporovánonutné (blok gecko)—
BaleníZIP s manifest.json v kořeniZIPbalení ve stylu aplikace

Tedy: namespace přestává být proměnná, ale blok background a browser_specific_settings si dál žádají jeden manifest pro každý cíl. Rozumné je udržovat základní manifest a varianty generovat při buildu, ne ručně spravovat čtyři soubory.

Co dalšího Chrome oznámil v shrnutí I/O 2026?

Kromě namespace přináší shrnutí I/O 2026 od Chrome for Developers dvě změny, které se týkají toho, jak se publikuje, ne jak se programuje: týmové role v Developer Dashboardu a soukromé publikování pro firmy.

Tři nové role jsou:

  • Admin: obecná správa a přidávání nových členů.
  • Item Manager: umožňuje „nahrávat a odesílat aktualizace rozšíření“, aniž by dostal kontrolu nad účtem.
  • Viewer: pro toho, kdo se potřebuje dívat jen na metriky výkonu.

A další členy lze pozvat, aniž by každý musel projít registrací vývojáře. Pro agenturu, která publikuje jménem klienta, je to přesně ta díra, kterou bylo potřeba zacelit: dřív znamenalo nahrání aktualizace sdílení účtu.

Soukromé publikování pro firmy umožňuje nasadit rozšíření externím organizacím, které ho schvalují přímo z Chrome Web Store. Stejné shrnutí přidává pár kontextových údajů o ekosystému: registrace vývojářů se za poslední rok zdvojnásobily, 17 % nových rozšíření v Chrome Web Store obsahuje AI a registrace vývojářů se rozšiřuje o více než 120 dalších zemí.

Rozměry obrázků jsou v každém obchodě jiné: srovnávací tabulka

Tady je práce, která nezmizí. Každý obchod chce stejný snímek v jiném ořezu a jeden ze čtyř rovnou odmítá průhlednost. Toto je srovnání podle oficiální dokumentace každého z nich:

PrvekChrome Web StoreMicrosoft Edge Add-onsAMO (Firefox)App Store Connect (Safari)
Ikona / logo karty128x128 PNG (96x96 grafiky + 16 px průhledného okraje)1:1, doporučeno 300x300, minimum 128x12832x32 a 64x64, PNG nebo JPEGikona nadřazené aplikace
Snímky obrazovky1280x800 (preferováno) nebo 640x400, hranaté rohy a bez okrajů640x480 nebo 1280x800, maximálně 6doporučeno 1280x800, nebo poměr 1,6:116:10: 1280x800, 1440x900, 2560x1600 nebo 2880x1800
Počet snímkůalespoň 1, až 5až 6alespoň ty ke klíčovým funkcím1 až 10 na velikost
Malá dlaždice440x280 (volitelná)440x280 (volitelná)——
Velká dlaždice / banner1400x560 (volitelný)1400x560 PNG (volitelný)——
Průhlednostikona ji potřebuje v okraji——zakázána: bez alfa kanálu a bez průhledností

Zdroje: obrázky karty v Chrome Web Store, publikování rozšíření pro Microsoft Edge (dokument aktualizovaný v roce 2026), vytvoření atraktivní karty v AMO a specifikace snímků v App Store Connect.

Čtyři prázdné panely různých proporcí s měřicími pravítky pod nimi a ořezovými vodítky překrytými na jednom z nich
Čtyři prázdné panely různých proporcí s měřicími pravítky pod nimi a ořezovými vodítky překrytými na jednom z nich

Tři praktické důsledky té tabulky:

  1. 1280x800 je společný jmenovatel. Funguje v Chromu, v Edgi i v AMO a je jedním ze čtyř platných rozměrů Applu. Pokud budeš vyrábět jen jednu sadu snímků, ať je to tahle.
  2. Apple tě nutí zploštit obrázek. App Store Connect nepřijímá alfa ani průhlednosti, takže PNG exportované s průhledným pozadím se odmítne, i když „vypadá dobře“. Je potřeba obrázek zploštit a znovu změřit binární soubor, ne se spoléhat na prohlížeč obrázků.
  3. Ikona pro Chrome není plný čtverec. Je to plátno 128x128 s grafikou 96x96 a 16 px průhledného okraje na každé straně. Je to nejčastější chyba při znovupoužití ikony z jiného obchodu.

Ani limity znaků se neshodují

Každý obchod ořezává text jinde a ve dvou z nich se text nepíše v obchodě: pochází z manifestu. Tohle říká oficiální dokumentace:

PoleLimitZdroj
name v manifestumaximálně 75 znakůklíč name v Chromu
description v manifestunejvýše 132 znaků, prostý text bez HTMLklíč description v Chromu
Popis karty v Edgiminimálně 250, maximálně 10 000 znakůpublikování v Edge Add-ons
Hledané výrazy v Edgiaž 7 výrazů, celkem 21 slov, 30 znaků na výrazpublikování v Edge Add-ons
Shrnutí v AMO250 znakůkarta v AMO
Název aplikace v App Store2 až 30 znakůinformace o aplikaci v App Store Connect
Podtitul v App Store30 znakůinformace o aplikaci v App Store Connect

Dva detaily, které ušetří jedno kolo revize:

  • V Edgi jsou název rozšíření a krátký popis v Partner Center jen pro čtení: pocházejí z manifestu. Aby se změnily, je potřeba upravit manifest.json, znovu zabalit a znovu nahrát. Takže těch 132 znaků description není jen záležitost Chromu: putují s tebou.
  • V Edgi, pokud balíček deklaruje více jazyků, ale v Partner Center se objeví jen jedna lokalizace, bývá důvod ten, že manifest obsahuje pevné řetězce místo zástupných __MSG_extensionName__ s default_locale a _locales. Partner Center rozpoznává jazyky podle těchto odkazů i18n.
  • V Safari jsou název a podtitul ty nadřazené aplikace, ne rozšíření: 30 znaků je velmi málo, pokud jsi přicházel s názvem o 75.

Deklarace ochrany soukromí se dělá čtyřikrát a ve Firefoxu patří do manifestu

Žádná ze čtyř kontrol neuznává deklaraci jiné a od konce roku 2025 Firefox přestal žádat deklaraci ve formuláři a žádá ji uvnitř manifestu. Je to část procesu, která se při plánování multiprohlížečového spuštění nejvíc podceňuje.

Chrome Web Store. Záložka soukromí v dashboardu vyžaduje jediný účel, zdůvodnění pro každé oprávnění deklarované v manifestu, deklaraci použití vzdáleného kódu, potvrzení postupů nakládání s daty a URL zásad ochrany soukromí.

Microsoft Edge Add-ons. Stránka Privacy v Partner Center chce totéž v pěti sekcích: Single Purpose, zdůvodnění oprávnění, použití vzdáleného kódu, použití dat a zásady ochrany soukromí. Dokumentace upozorňuje, že jakákoli neúplná nebo zavádějící deklarace „může být považována za porušení zásad pro vývojáře“ a skončit dodatečnou kontrolou, zpožděním nebo zamítnutím. A připomíná, že vzdálený kód není v Manifest V3 povolen.

AMO (Firefox). Od 3. listopadu 2025 musí každé nové rozšíření deklarovat, jaká data sbírá nebo přenáší, pomocí klíče browser_specific_settings.gecko.data_collection_permissions, podle oznámení Mozilly o změnách v souhlasu se sběrem dat (23. října 2025). Pokud nesbíráš nic, je potřeba to výslovně uvést:

{
  "browser_specific_settings": {
    "gecko": {
      "data_collection_permissions": { "required": ["none"] }
    }
  }
}

Dokumentace integrovaného souhlasu ve Firefoxu podrobně popisuje podporované hodnoty (personallyIdentifyingInfo, healthInfo, financialAndPaymentInfo, authenticationInfo, personalCommunications, locationInfo, browsingActivity, websiteContent, websiteActivity, searchTerms, bookmarksInfo, plus technicalAndInteraction jen jako volitelnou) a pokrytí: Firefox 140 na desktopu a 142 na Androidu. Bez správně nastaveného klíče nelze rozšíření odeslat k podpisu. U rozšíření, která existovala před tímto datem, Mozilla říká, že to budou muset převzít „později“, bez zveřejněného konkrétního data.

App Store Connect (Safari). URL zásad ochrany soukromí je povinná pro aplikace pro iOS a macOS a deklarace soukromí se provádí na úrovni nadřazené aplikace, s specifikacemi App Store Connect jako referencí.

Balení: tři ZIPy a jeden projekt v Xcode

Tři ze čtyř obchodů se živí stejným artefaktem; čtvrtý ne. Chrome, Edge, Firefox a Opera berou ZIP s manifest.json v kořeni. Safari potřebuje balení ve stylu aplikace: rozšíření putuje uvnitř nativní aplikace, která se distribuuje přes App Store.

Tři stejné komprimované balíčky v řadě a, oddělený čárou, odlišný kontejner, který jeden z těchto balíčků nese uvnitř
Tři stejné komprimované balíčky v řadě a, oddělený čárou, odlišný kontejner, který jeden z těchto balíčků nese uvnitř

Pro přechod na Safari nabízí Apple nástroj příkazové řádky xcrun safari-web-extension-converter, který z existujícího webového rozšíření vygeneruje projekt v Xcode; je zdokumentován v balení webového rozšíření pro Safari. Tvrdý požadavek není technický, je administrativní: publikování v App Store vyžaduje App Store Connect a ten je dostupný jen členům Apple Developer Program, který stojí 99 USD za rok členství (s výjimkami pro neziskové organizace, akreditované vzdělávací instituce a vládní subjekty, které splní požadavky). Chrome Web Store zase žádá jednorázový registrační poplatek při zřízení vývojářského účtu, podle své stránky registrace; Edge Add-ons registraci neúčtuje, jak uvádí její příručka registrace vývojáře.

Lhůty kontroly, které stojí za to mít v kalendáři

ObchodCo říká oficiální dokumentace
Chrome Web Store„U většiny rozšíření se kontrola dokončí za několik dnů, ale může trvat až několik týdnů“; pokud uplynou více než tři týdny beze změny, je třeba otevřít podporu (proces kontroly)
Microsoft Edge Add-ons„Proces certifikace může po odeslání trvat až sedm pracovních dnů“ (publikování v Edgi)

Chrome přidává nuanci, kterou stojí za to si přečíst, než začneš žádat o oprávnění: kontroly trvají déle u rozšíření, která žádají široká oprávnění k hostitelům nebo citlivá oprávnění ke spouštění, nebo která obsahují hodně kódu či kód, který se špatně kontroluje.

Vyplatí se publikovat ve všech čtyřech? Co říká podíl na trhu

Záleží na tom, kolik stojí každá karta, protože rozložení podílu na desktopu je velmi nerovnoměrné. Podle dat Statcounter Global Stats za říjen 2026 na desktopu celosvětově:

ProhlížečPodíl na desktopu (říj. 2026)
Chrome66,98 %
Edge13,24 %
Safari7,83 %
Firefox5,72 %
Opera2,65 %

Čteno s rozumem: Edge je druhý trh a sdílí téměř celou specifikaci s Chromem (stejný ZIP, stejné snímky 1280x800, stejné 440x280 a 1400x560, stejných pět sekcí soukromí). Je to nejlepší návratnost na hodinu práce: s balíčkem, který už máš, a dvěma novými obrázky zdvojnásobíš potenciální dosah. Firefox stojí jiný manifest a klíč pro data. Safari je ten, který stojí doopravdy: projekt v Xcode, roční členství a karta s názvem o 30 znacích.

Checklist: publikovat jednou, uvést čtyřikrát

Tohle je pořadí, které způsobí nejméně přepracování, vycházející ze všeho výše:

  1. Piš kód s browser.* a promisy a přidej guard globalThis.browser = chrome, pokud pokrýváš Chrome starší než 148.
  2. Udržuj základní manifest a varianty generuj při buildu: background.service_worker pro Chrome a Edge, background.scripts pro Firefox a blok browser_specific_settings.gecko jen ve variantě pro Firefox.
  3. Uprav name na 75 znaků a description na 132 před balením: tato dvě pole napájejí kartu v Chromu a jsou v Edgi jen pro čtení.
  4. Pokud chceš vícejazyčnou kartu v Edgi, použij __MSG_extensionName__ a __MSG_extensionDescription__ s default_locale a _locales.
  5. Vyrob snímky v 1280x800 a ulož je bez alfa kanálu od začátku: je to jediná verze, která platí pro všechny čtyři.
  6. Připrav ikonu pro Chrome jako 128x128 s grafikou 96x96 a okrajem 16 px a logo pro Edge jako 300x300 v poměru 1:1.
  7. Vygeneruj dlaždici 440x280 a banner 1400x560 jen jednou: v Chromu i v Edgi fungují stejně.
  8. Napiš jediný účel a zdůvodnění pro každé oprávnění v manifestu a ten text znovu použij v Chromu i v Edgi.
  9. Přidej data_collection_permissions do manifestu pro Firefox, i kdyby šlo jen o ["none"], jinak ho nebudeš moci odeslat k podpisu.
  10. Safari nech na konec a rozpočtuj ho zvlášť: převod pomocí safari-web-extension-converter, Apple Developer Program a snímky 16:10 bez průhlednosti.

Často kladené otázky

Bude se namespace chrome v rozšířeních odstraňovat?

Ne. Oficiální dokumentace Chromu je výslovná: namespace browser se přidává „vedle stávajícího chrome“ a chrome se neodstraňuje. Můžeš migrovat, kdy se ti to hodí, bez spěchu a bez rozbití čehokoli.

Od které verze Chromu mohu používat browser bez podmínek?

Od Chromu 148 u běžných rozšíření a od Chromu 152, pokud tvé rozšíření deklaruje devtools_page. Před 152 vypínala deklarace devtools_page namespace browser v celém rozšíření, nejen na té stránce.

Potřebuji v roce 2026 pořád webextension-polyfill?

Jen pokud podporuješ Chrome 147 nebo starší. V Chromu 148 a novějších sama dokumentace Chromu říká, že polyfill „nedělá nic“, protože podpora je už nativní.

Mohu nahrát stejné snímky do Chromu, Edge, Firefoxu i Safari?

Skoro. Pokud je vyrobíš v 1280x800 bez alfa kanálu, platí ve všech čtyřech: je to preferovaná velikost Chromu, jedna ze dvou přijímaných Edgem, doporučená v AMO a jeden ze čtyř rozměrů 16:10 v App Store Connect. Mění se maximální počet (5 v Chromu, 6 v Edgi, 10 na velikost u Applu) a ikony a dlaždice, které je opravdu potřeba předělat.

Proč App Store Connect odmítá mé PNG snímky?

Nejčastější příčinou je průhlednost: specifikace Applu říkají, že obrázky nesmějí obsahovat alfa kanály ani průhlednosti. PNG s alfa neprojde, i když pozadí vypadá bílé. Je potřeba obrázek zploštit a zkontrolovat výsledný binární soubor, ne prohlížeč.

Co se stane, když ve Firefoxu nedeklaruji data_collection_permissions?

Pokud jde o nové rozšíření, nebudeš ho moci odeslat na addons.mozilla.org k podpisu. Je to povinné od 3. listopadu 2025 u nových rozšíření; pokud nesbíráš ani nepřenášíš žádná data, je potřeba to deklarovat pomocí {"required": ["none"]}.

Jak dlouho trvá kontrola v každém obchodě?

Chrome mluví o „několika dnech“ u většiny rozšíření, s případy až několika týdnů. Edge uvádí, že certifikace může trvat až sedm pracovních dnů. Chrome dále upozorňuje, že široká oprávnění k hostitelům a kód, který se špatně kontroluje, proces prodlužují.

Musím platit za publikování ve všech čtyřech obchodech?

Chrome Web Store účtuje jednorázový registrační poplatek při zřízení vývojářského účtu. Edge Add-ons registraci neúčtuje. AMO také ne. Safari vyžaduje Apple Developer Program za 99 USD za rok členství, protože App Store je distribuční kanál.

Co je role Item Manager v dashboardu Chromu?

Je to jedna ze tří týmových rolí oznámených v shrnutí I/O 2026: umožňuje členovi nahrávat a odesílat aktualizace rozšíření, aniž by dostal správu účtu, která zůstává v roli Admin. Třetí, Viewer, vidí jen metriky.

Jedna karta na obchod, ale změřená jen jednou

Práce, kterou namespace browser odstranil, byla nejviditelnější, ale ne nejdražší. Drahá byla a stále je karta v obchodě: čtyři sady rozměrů, čtyři limity znaků a čtyři deklarace soukromí, které se mezi obchody nedědí. Rozdíl mezi tím, že to zvládneš za odpoledne, a třemi koly zamítnutí, spočívá v tom neimprovizovat s rozměry a zkontrolovat binární soubor každého obrázku před nahráním.

Přesně to automatizuje aiChrome od AiToolsForApps: konstruktor manifestu MV3 s doslovným upozorněním, které uživatel uvidí u každého oprávnění, tvůrce karty s jediným účelem a zdůvodněním oprávnění po oprávnění, generátor podkladů, který dodá ikonu 128x128, snímky 1280x800 bez alfa, dlaždici 440x280 a banner 1400x560, a validátor, který měří tvé obrázky v prohlížeči, pixel po pixelu odhalí skutečnou průhlednost a nabídne ti ořez na každou specifikaci. Pokud míříš na všechny čtyři obchody, začni tím, že budeš mít bezchybnou kartu pro Chrome: ověřená tabulka rozměrů, limitů a karty soukromí pro rozšíření Manifest V3 je výchozí bod a vždy rozlišuje, co je oficiální požadavek a co doporučení.

Než kartu zduplikuješ do čtyř obchodů, měj tu pro Chrome změřenou na pixel: vyzkoušej aiChrome zdarma a bez registrace, vygeneruj manifest, kartu soukromí i balíček obrázků a okamžitě si ověř své snímky.

Než kartu zduplikuješ do čtyř obchodů, měj tu pro Chrome změřenou na pixel: vyzkoušej aiChrome zdarma a bez registrace, vygeneruj manifest, kartu soukromí i balíček obrázků a okamžitě si ověř své snímky.

↑ Zpět nahoru