Google ChromeGoogle Chrome

1つの拡張機能を4つのストアへ:同じコードでChrome、Edge、Firefox、Safariに公開する

チーム: AiToolsForAppsAI の支援を受けて執筆20 分で読めます

要点

  • Chrome 148以降、すべての拡張機能APIが従来のchromeに加えてbrowser名前空間でも利用できます。Chrome for DevelopersのガイドTransition to browser namespaceによるものです。Webエクステンション向けI/O 2026のまとめ(2026年11月)は、共通のグローバルによって「互換性のためのエイリアスの必要性が減る」とまとめています。
  • devtools_pageを持つ拡張機能は最初は対象外でした。その場合のbrowser対応はChrome 152で実現しました。
  • 統一されなかったのはストアの掲載情報です。Chromeは1280x800のスクリーンショットを求め、Edgeは640x480または1280x800を受け付け、Appleはアルファチャンネルなしの16:10(1280x800、1440x900、2560x1600、2880x1800)を必須とし、AMOは1280x800または1.6:1の比率を推奨しています。
  • 文字数の上限も一致しません。マニフェストのdescriptionはChromeで132文字、Edgeのストア説明は250〜10,000文字、AMOの概要は250文字、App Store Connectのアプリ名は30文字です。
  • そしてプライバシーの申告は4回必要です。ChromeのPrivacyタブ、Partner CenterのPrivacyページ、AMO向けのマニフェストのdata_collection_permissions、App Store Connectのプライバシーポリシーです。
1つのコードブロックから4本の光のリボンが伸び、拡張機能ストアごとに縦横比の異なる4つの空のフレームへつながっている
1つのコードブロックから4本の光のリボンが伸び、拡張機能ストアごとに縦横比の異なる4つの空のフレームへつながっている

長年、ChromeのExtensionをFirefox、Edge、Safariに移植する作業は、どのファイルの冒頭にも同じ見苦しい1行を書くところから始まっていました。chrome.*とbrowser.*のどちらを使うかを決めるエイリアスです。2026年には、その1行は不要になりました。それでも不要にならないのが、ストアの掲載情報を4回作り直すのに費やす時間です。そこで役立つのがaiChromeです。Chrome拡張機能を作る人、販売する人、競う人のためのAiToolsForAppsのツールで、検証済みのChrome Web Store掲載情報のサイズと上限のカタログを備えており、仕様に合わないものは納品されません。この記事では、コード側でもう必要なくなったことと、ストアごとの手作業として残るものを説明します。

2026年のbrowser名前空間で、正確には何が変わったのですか?

ChromeがFirefoxとSafariがすでに使っていたグローバルのbrowserを採用しました。公式ドキュメントのbrowser名前空間への移行には、「Chrome 148以降、Chromeのすべての拡張機能APIは、既存のchromeに加えてbrowser名前空間でも利用できる」とあります。chrome名前空間は廃止されません。両方が共存するので、壊れるものはありません。

実際の効果として、最新のブラウザだけを対象にする拡張機能は、browser.*とPromiseを使って1回書けば、中間層なしで4つのエンジンすべてで動作します。重要な点が2つあります。

  • runtime.onMessageがPromiseを受け付けます。 Chrome 148では、リスナーがチャンネルを開いたままにする従来のreturn trueの代わりに、Promiseを直接返して非同期に応答できます。
  • ポリフィルは不要になります。 Chromeのドキュメントによれば、webextension-polyfillは「Chrome 148以降では何もしません」。ブラウザがすでにネイティブ対応しているためです。
左は2本の絡まったケーブルをアダプターでつないだもの、右はアダプターのない1本の整った連続したケーブル
左は2本の絡まったケーブルをアダプターでつないだもの、右はアダプターのない1本の整った連続したケーブル

古いChromeを使うユーザーを壊さずにbrowserを使えますか?

はい。Chromeのドキュメント自体が2つの方法を示しています。対象ユーザーがすでにChrome 148以降なら、マニフェストに"minimum_chrome_version": "148"を宣言し、条件なしでbrowserを使います。それ以前のバージョンにも対応する必要があるなら、起動処理の冒頭にガードを入れます。

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

最も驚きが多いのはDevToolsです。以前のバージョンでは、devtools_pageを宣言すると、DevToolsのページだけでなく拡張機能全体でbrowser名前空間が無効になっていました。この制限はChrome 152でなくなり、あらゆる拡張機能が対象になりました。Promiseを返すonMessageリスナーは、DevToolsのページコンテキストでは引き続き利用できません。

コード側でまだ統一されていないもの

名前空間が同じだからといって、マニフェストも同じというわけではありません。MDNのクロスブラウザ拡張機能の作成ガイドによると、次のとおりです。

項目Chrome / EdgeFirefoxSafari
名前空間chromeとbrowser(148以降)browser(互換性のためchromeも)browser
MV3のバックグラウンド拡張機能のservice workerバックグラウンドページ両方に対応
browser_specific_settings非対応必須(geckoブロック)—
パッケージングルートにmanifest.jsonを置いたZIPZIPアプリ形式のパッケージ

つまり、名前空間は変数ではなくなりますが、backgroundブロックとbrowser_specific_settingsは、依然として配布先ごとにマニフェストを必要とします。現実的なのは、ベースのマニフェストを1つ維持し、ビルド時にバリアントを生成する方法で、4つのファイルを手作業で管理することではありません。

ChromeのI/O 2026のまとめで、ほかに何が発表されましたか?

名前空間のほかに、Chrome for DevelopersのI/O 2026のまとめには、プログラミングの方法ではなく公開の方法に影響する2つの変更があります。Developer Dashboardのチームロールと、企業向けの非公開公開です。

新しい3つのロールは次のとおりです。

  • Admin:全体の管理と新しいメンバーの追加。
  • Item Manager:アカウントの管理権限を与えずに、「拡張機能の更新をアップロードして送信」できます。
  • Viewer:パフォーマンス指標を見るだけでよい人向け。

また、メンバーを追加で招待でき、それぞれが開発者登録を行う必要はありません。クライアントの代わりに公開する代理店にとっては、まさに足りなかった部分が埋まります。これまで、更新のアップロードにはアカウントの共有が必要でした。

企業向けの非公開公開では、Chrome Web Storeから直接承認する外部組織に拡張機能を配布できます。同じまとめには、エコシステムに関する背景情報も添えられています。開発者登録は過去1年で倍増し、Chrome Web Storeの新しい拡張機能の17%がAIを組み込んでおり、開発者登録はさらに120以上の国に拡大されています。

画像サイズはストアごとに異なります:比較表

ここからは、なくならない作業です。各ストアは同じスクリーンショットを異なるトリミングで要求し、4つのうち1つは透明度を一切認めません。各ストアの公式ドキュメントに基づく比較は次のとおりです。

素材Chrome Web StoreMicrosoft Edge Add-onsAMO (Firefox)App Store Connect (Safari)
アイコン / ストアのロゴ128x128 PNG(96x96の絵柄+16 pxの透明な余白)1:1、推奨300x300、最小128x12832x32と64x64、PNGまたはJPEGコンテナアプリのアイコン
スクリーンショット1280x800(推奨)または640x400、角は直角で裁ち落とし640x480または1280x800、最大6枚1280x800推奨、または1.6:1の比率16:10:1280x800、1440x900、2560x1600、2880x1800
スクリーンショットの枚数最低1枚、最大5枚最大6枚主要機能の分だけ最低限サイズごとに1〜10枚
小タイル440x280(任意)440x280(任意)——
大タイル / マーキー1400x560(任意)1400x560 PNG(任意)——
透明度アイコンは余白に必要——禁止:アルファチャンネルも透明も不可

出典:Chrome Web Storeの掲載画像、Microsoft Edge拡張機能の公開(2026年に更新されたドキュメント)、AMOで魅力的な掲載情報を作る、App Store Connectのスクリーンショット仕様。

縦横比の異なる4つの空のパネルと、その下に測定用の定規、うち1枚にはトリミングのガイドが重なっている
縦横比の異なる4つの空のパネルと、その下に測定用の定規、うち1枚にはトリミングのガイドが重なっている

この表から導かれる実用上のポイントが3つあります。

  1. 1280x800が共通の最小公倍数です。 Chrome、Edge、AMOで使え、Appleの4つの有効サイズの1つでもあります。スクリーンショットを1セットしか作らないなら、このサイズにしてください。
  2. Appleでは平坦化が必要です。 App Store Connectはアルファも透明も受け付けないため、透明な背景で書き出したPNGは「きれいに見えて」も却下されます。画像を平坦化したうえで、ビューアではなくバイナリを測り直す必要があります。
  3. Chromeのアイコンは、塗りつぶされた正方形ではありません。 128x128のキャンバスに、96x96の絵柄と、各辺16 pxの透明な余白があります。ほかのストアのアイコンを流用するときに最も多い間違いです。

文字数の上限も一致しません

ストアごとにテキストを切る位置が異なり、そのうち2つでは、テキストはストアで書くのではなくマニフェストから取得されます。公式ドキュメントには次のように書かれています。

フィールド上限出典
マニフェストのname最大75文字Chromeのnameキー
マニフェストのdescription132文字以内、HTMLなしのプレーンテキストChromeのdescriptionキー
Edgeの掲載説明最小250、最大10,000文字Edge Add-onsでの公開
Edgeの検索用語最大7語、合計21語、1語あたり30文字Edge Add-onsでの公開
AMOの概要250文字AMOの掲載情報
App Storeのアプリ名2〜30文字App Store Connectのアプリ情報
App Storeのサブタイトル30文字App Store Connectのアプリ情報

審査のやり直しを1回省ける、2つのポイントがあります。

  • Edgeでは、拡張機能の名前と短い説明はPartner Centerでは読み取り専用で、マニフェストから取得されます。変更するには、manifest.jsonを編集し、再パッケージして再アップロードする必要があります。したがって、descriptionの132文字はChromeだけの問題ではなく、どこへでもついてきます。
  • Edgeで、パッケージが複数の言語を宣言しているのにPartner Centerにロケールが1つしか表示されない場合、多くはマニフェストがdefault_localeと_localesを使った__MSG_extensionName__のプレースホルダーではなく、固定の文字列を含んでいることが原因です。Partner Centerは、これらのi18n参照から言語を検出します。
  • Safariでは、名前とサブタイトルは拡張機能ではなくコンテナアプリのものです。75文字の名前から移ってきた場合、30文字はとても短いものです。

プライバシーの申告は4回行い、Firefoxではマニフェストに書きます

4つの審査のどれも他の申告を受け付けず、2025年末からFirefoxは、申告をフォームではなくマニフェストの中に書くよう求めるようになりました。マルチブラウザでのリリースを計画するときに、最も過小評価されがちな工程です。

Chrome Web Store。 ダッシュボードのプライバシータブでは、単一の目的、マニフェストで宣言したすべての権限ごとの正当性の説明、リモートコード使用の申告、データ利用慣行の証明、プライバシーポリシーのURLが必要です。

Microsoft Edge Add-ons。 Partner CenterのPrivacyページは、同じ内容を5つのセクション(Single Purpose、権限ごとの正当性、リモートコードの使用、データの使用、プライバシーポリシー)で求めます。ドキュメントは、不完全または誤解を招く申告は「開発者ポリシー違反とみなされる可能性がある」とし、追加審査、遅延、却下につながると警告しています。また、Manifest V3ではリモートコードは許可されていないことも思い出させます。

AMO (Firefox)。 2025年11月3日以降、すべての新しい拡張機能は、browser_specific_settings.gecko.data_collection_permissionsキーで、収集または送信するデータを宣言する必要があります。これはMozillaのデータ収集の同意に関する変更の発表(2025年10月23日)によるものです。何も収集しない場合は、明示的にそう宣言しなければなりません。

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

Firefoxの組み込み同意に関するドキュメントには、使用できる値(personallyIdentifyingInfo、healthInfo、financialAndPaymentInfo、authenticationInfo、personalCommunications、locationInfo、browsingActivity、websiteContent、websiteActivity、searchTerms、bookmarksInfo、さらに任意としてのみ使えるtechnicalAndInteraction)と対象範囲(デスクトップはFirefox 140、AndroidはFirefox 142)が詳しく書かれています。キーが正しく設定されていないと、拡張機能を署名に送ることはできません。その日付より前から存在していた拡張機能については、Mozillaは「後日」対応が必要になるとしていますが、具体的な日付は公表されていません。

App Store Connect (Safari)。 プライバシーポリシーのURLはiOSとmacOSのアプリで必須で、プライバシーの申告はコンテナアプリのレベルで行います。参考になるのはApp Store Connectの仕様です。

パッケージング:ZIP3つとXcodeプロジェクト1つ

4つのうち3つのストアは同じ成果物を使いますが、残りの1つは違います。Chrome、Edge、Firefox、Operaは、ルートにmanifest.jsonを置いたZIPを使います。Safariにはアプリ形式のパッケージが必要で、拡張機能はApp Storeで配布されるネイティブアプリの中に入って届けられます。

同一の圧縮パッケージが3つ並び、線で区切られた先に、その1つを中に収めた別形式のコンテナがある
同一の圧縮パッケージが3つ並び、線で区切られた先に、その1つを中に収めた別形式のコンテナがある

Safariへの移行には、Appleがコマンドラインツールxcrun safari-web-extension-converterを用意しており、既存のWebエクステンションからXcodeプロジェクトを生成します。Safari向けWebエクステンションのパッケージングに記載されています。大きなハードルは技術的なものではなく、手続き上のものです。App Storeでの公開にはApp Store Connectが必要で、これはApple Developer Programのメンバーだけが使えます。会員費は年間99 USDです(要件を満たす非営利団体、認定教育機関、政府機関には免除があります)。一方、Chrome Web Storeは、登録ページによると、開発者アカウントの作成時に1回限りの登録料が必要です。Edge Add-onsは、開発者登録ガイドにあるとおり、登録料がかかりません。

カレンダーに入れておきたい審査期間

ストア公式ドキュメントの記載
Chrome Web Store「ほとんどの拡張機能では審査は数日で完了しますが、数週間かかることもあります」。変更なしで3週間以上経過した場合は、サポートに連絡する必要があります(審査プロセス)
Microsoft Edge Add-ons送信後、「認証プロセスには最大7営業日かかることがあります」(Edgeでの公開)

Chromeは、権限を申請する前に読んでおく価値のある補足を加えています。広範なホスト権限や、機密性の高い実行権限を要求する拡張機能、コード量が多い、または審査しにくいコードを含む拡張機能は、審査に時間がかかります。

4つすべてに公開する価値はありますか?市場シェアが示すこと

各掲載にかかる手間によって変わります。デスクトップのシェアは非常に偏っているからです。2026年10月の世界のデスクトップに関するStatcounter Global Statsのデータによると、次のとおりです。

ブラウザデスクトップシェア(2026年10月)
Chrome66.98 %
Edge13.24 %
Safari7.83 %
Firefox5.72 %
Opera2.65 %

冷静に見ると、Edgeは第2の市場であり、仕様のほとんどをChromeと共有しています(同じZIP、同じ1280x800のスクリーンショット、同じ440x280と1400x560、同じ5つのプライバシーセクション)。かけた時間あたりのリターンが最も高い選択です。すでにあるパッケージと新しい画像2枚で、潜在的なリーチが倍になります。Firefoxでは別のマニフェストとデータキーが必要です。本当に手間がかかるのはSafariで、Xcodeプロジェクト、年会費、名前が30文字の掲載情報が必要です。

チェックリスト:一度公開して、4回掲載する

ここまでの内容をふまえて、手戻りが最も少ない順番は次のとおりです。

  1. コードはbrowser.*とPromiseで書き、Chrome 148より前に対応する場合はglobalThis.browser = chromeのガードを追加します。
  2. ベースのマニフェストを1つ維持し、ビルド時にバリアントを生成します。ChromeとEdgeにはbackground.service_worker、Firefoxにはbackground.scriptsを使い、browser_specific_settings.geckoブロックはFirefox用のバリアントにだけ入れます。
  3. パッケージングの前に、nameを75文字、descriptionを132文字に収めます。この2つのフィールドはChromeの掲載情報に使われ、Edgeでは読み取り専用です。
  4. Edgeで多言語の掲載情報にしたい場合は、default_localeと_localesを使い、__MSG_extensionName__と__MSG_extensionDescription__を使います。
  5. スクリーンショットは1280x800で作成し、最初からアルファチャンネルなしで保存します。4つすべてで使える唯一のバージョンです。
  6. Chromeのアイコンは、96x96の絵柄と16 pxの余白を持つ128x128で用意し、Edgeのロゴは1:1の300x300で用意します。
  7. 440x280のタイルと1400x560のマーキーは一度だけ作成します。ChromeでもEdgeでもそのまま使えます。
  8. 単一の目的と、マニフェストの権限ごとの正当性の説明を作成し、そのテキストをChromeとEdgeで再利用します。
  9. Firefoxのマニフェストに、たとえ["none"]でもdata_collection_permissionsを追加します。さもないと、署名に送ることができません。
  10. Safariは最後に回し、別枠で予算を組みます。safari-web-extension-converterによる変換、Apple Developer Program、透明度のない16:10のスクリーンショットが必要です。

よくある質問

拡張機能のchrome名前空間は削除されますか?

いいえ。Chromeの公式ドキュメントは明確で、browser名前空間は「既存のchromeに加えて」追加されるもので、chromeが廃止されるわけではありません。都合のよいときに、急がず、何も壊さずに移行できます。

Chromeのどのバージョンから、条件なしでbrowserを使えますか?

通常の拡張機能はChrome 148から、拡張機能がdevtools_pageを宣言している場合はChrome 152からです。152より前は、devtools_pageを宣言すると、そのページだけでなく拡張機能全体でbrowser名前空間が無効になっていました。

2026年でも、webextension-polyfillは必要ですか?

Chrome 147以前をサポートする場合だけです。Chrome 148以降では、Chrome自身のドキュメントが、ネイティブ対応済みのためポリフィルは「何もしない」と述べています。

同じスクリーンショットを、Chrome、Edge、Firefox、Safariにアップロードできますか?

ほぼ可能です。アルファチャンネルなしの1280x800で作成すれば、4つすべてで使えます。Chromeの推奨サイズであり、Edgeが認める2つのうちの1つ、AMOの推奨サイズ、App Store Connectの4つの16:10サイズのうちの1つです。違うのは最大枚数(Chromeは5、Edgeは6、Appleはサイズごとに10)で、アイコンとタイルは作り直す必要があります。

App Store Connectでスクリーンショットのパネルが却下されるのはなぜですか?

最も多い原因は透明度です。Appleの仕様では、画像にアルファチャンネルや透明を含めてはならないとされています。背景が白く見えても、アルファのあるPNGは通りません。画像を平坦化し、ビューアではなく書き出されたバイナリを確認する必要があります。

Firefoxでdata_collection_permissionsを宣言しないとどうなりますか?

新しい拡張機能なら、署名のためにaddons.mozilla.orgへ送信できません。2025年11月3日以降、新しい拡張機能では必須です。データを収集も送信もしない場合は、{"required": ["none"]}で宣言する必要があります。

各ストアの審査にはどのくらいかかりますか?

Chromeはほとんどの拡張機能で「数日」とし、場合によっては数週間かかることもあります。Edgeは、認証に最大7営業日かかる場合があるとしています。さらにChromeは、広範なホスト権限や審査しにくいコードがあると、プロセスが長引くと警告しています。

4つのストアすべてに公開するには、お金を払う必要がありますか?

Chrome Web Storeは、開発者アカウントの開設時に1回限りの登録料がかかります。Edge Add-onsは登録料がかかりません。AMOも同様です。Safariは、App Storeが配布チャネルであるため、年間99 USDのApple Developer Programが必要です。

Chromeダッシュボードの「Item Manager」ロールとは何ですか?

I/O 2026のまとめで発表された3つのチームロールの1つで、メンバーに、アカウントの管理権限を与えずに、拡張機能の更新をアップロードして送信させることができます。アカウント管理はAdminロールに残ります。3つ目のViewerは、指標を見るだけです。

ストアごとに掲載し、サイズの確認は一度だけ

browser名前空間がなくしてくれた作業は、最も目立つものでしたが、最も手間のかかるものではありませんでした。手間がかかったのは、そして今もかかるのは掲載情報です。4セットのサイズ、4つの文字数上限、ストア間で引き継がれない4つのプライバシー申告があります。夕方のうちに終えるか、3回の却下サイクルを経るかの違いは、サイズを場当たりで決めないことと、アップロード前に各画像のバイナリを確認することにあります。

まさにそれを自動化するのが、AiToolsForAppsのaiChromeです。権限ごとにユーザーが目にする警告文をそのまま表示するMV3マニフェストビルダー、単一の目的と権限ごとの正当性を含めて作成する掲載文ライター、128x128のアイコン、アルファなしの1280x800のスクリーンショット、440x280のタイル、1400x560のマーキーを出力するアセットジェネレーター、そしてブラウザ内で画像を測定し、ピクセル単位で実際の透明度を検出し、各仕様へのトリミングを提案するバリデーターです。4つのストアすべてを目指すなら、まずChromeの掲載情報を完璧にしておきましょう。Manifest V3拡張機能向けの、サイズ、上限、プライバシー申告の検証済み一覧が出発点であり、公式の要件と推奨事項は常に区別して示されています。

Chromeの掲載情報を4つのストアに複製する前に、まずChromeの分をピクセル単位で整えましょう。aiChromeを無料・登録不要で試して、マニフェスト、プライバシーの申告、画像パックを生成し、スクリーンショットをその場で検証できます。

Chromeの掲載情報を4つのストアに複製する前に、まずChromeの分をピクセル単位で整えましょう。aiChromeを無料・登録不要で試して、マニフェスト、プライバシーの申告、画像パックを生成し、スクリーンショットをその場で検証できます。

↑ トップへ戻る