Google Chrome一個擴充功能,四間商店:用同一份程式碼在 Chrome、Edge、Firefox 和 Safari 發布
团队: AiToolsForApps在 AI 协助下撰写14 分鐘閱讀重點摘要
- 從 Chrome 148 開始,所有擴充功能 API 都可在
browser命名空間下使用,同時保留傳統的chrome,依據 Chrome for Developers 的 Transition to browser namespace 指南。I/O 2026 網頁擴充功能回顧(2026年11月)是這樣總結的:共用的全域物件「減少了對相容性別名的需求」。 - 宣告了
devtools_page的擴充功能一開始並未涵蓋:在這種情況下,browser的支援於 Chrome 152 才到位。 - 沒有統一的是商店頁面:Chrome 要求 1280x800 的螢幕截圖,Edge 接受 640x480 或 1280x800,Apple 要求 16:10 且無 Alpha 色版(1280x800、1440x900、2560x1600 或 2880x1800),AMO 建議 1280x800 或 1.6:1 的比例。
- 文字長度限制也不一致:Chrome 的 manifest
description為 132 個字元,Edge 的商店說明為 250 到 10,000,AMO 的摘要為 250,App Store Connect 的 App 名稱為 30。 - 而隱私權聲明要宣告四次:Chrome 的 Privacy 分頁、Partner Center 的 Privacy 頁面、AMO 的 manifest 中的
data_collection_permissions,以及 App Store Connect 的隱私權政策。

多年來,要把 Chrome 擴充功能移植到 Firefox、Edge 和 Safari,總是從每個檔案開頭同樣難看的一行開始:一個決定要用 chrome.* 還是 browser.* 的別名。到了 2026 年,這一行已經多餘。仍然多餘的,是把商店頁面重做四次所耗掉的時間,而 aiChrome 正是為此而來,這是 AiToolsForApps 為開發、銷售或競爭 Chrome 擴充功能的人打造的工具:它有附驗證標章的 Chrome Web Store 商店頁面尺寸與限制題庫,不符合規格的內容就不會交付。本文將說明程式碼中哪些事情不必再做,哪些仍然需要逐一商店手動處理。
2026 年的 browser 命名空間究竟改變了什麼?
Chrome 採用了 Firefox 和 Safari 早已使用的 browser 全域物件。根據官方文件的 browser 命名空間轉換說明,「從 Chrome 148 開始,所有 Chrome 擴充功能 API 都可在 browser 命名空間下使用,同時保留現有的 chrome」。chrome 命名空間不會被移除:兩者並存,所以沒有任何東西會壞掉。
實際的效果是,只針對現代瀏覽器的擴充功能,可以只寫一次,使用 browser.* 和 Promise,就能在四種瀏覽器引擎上運作,不需要中間層。有兩個重要的細節:
runtime.onMessage接受 Promise。在 Chrome 148 中,監聽器可以直接回傳Promise來進行非同步回應,而不必使用傳統的return true來保持通道開啟。- Polyfill 變得不再需要。Chrome 的文件指出,webextension-polyfill「在 Chrome 148 及之後的版本中不做任何事」,因為瀏覽器已經原生支援。

使用 browser 會不會讓使用舊版 Chrome 的使用者出問題?
不會,Chrome 的官方文件也提供了兩種做法。如果你的使用者已經在 Chrome 148 或更新版本,請在 manifest 中宣告 "minimum_chrome_version": "148",然後無條件使用 browser。如果需要涵蓋較舊的版本,請在啟動一開始放一個防護:
if (!globalThis.browser) {
globalThis.browser = chrome;
}
最容易出意外的情況是 DevTools。在較早的版本中,宣告 devtools_page 會讓 browser 命名空間在整個擴充功能中停用,而不只是 DevTools 頁面。這項限制在 Chrome 152 消失,現在已涵蓋任何擴充功能。回傳 Promise 的 onMessage 監聽器,在 DevTools 頁面環境中仍然無法使用。
程式碼中仍然沒有統一的部分
命名空間相同,並不代表 manifest 也相同。根據 MDN 的建置跨瀏覽器擴充功能指南:
| 項目 | Chrome / Edge | Firefox | Safari |
|---|---|---|---|
| 命名空間 | chrome 與 browser(148+) | browser(並為相容性保留 chrome) | browser |
| MV3 中的背景 | 擴充功能 service worker | 背景頁面 | 兩者皆支援 |
browser_specific_settings | 不支援 | 需要(gecko 區塊) | — |
| 封裝 | 根目錄含 manifest.json 的 ZIP | ZIP | App 式封裝 |
也就是說:命名空間不再是變數,但 background 區塊與 browser_specific_settings 仍然需要為每個目標準備各自的 manifest。合理的做法是維護一份基礎 manifest,並在建置時產生各個變體,而不是手動維護四個檔案。
Chrome 在 I/O 2026 回顧中還宣布了什麼?
除了命名空間之外,Chrome for Developers 的 I/O 2026 回顧還帶來兩項影響發布方式(而不是寫程式方式)的變動:Developer Dashboard 中的團隊角色,以及企業的私人發布。
三個新角色是:
- Admin:整體管理與新增成員。
- Item Manager:允許「上傳並提交擴充功能的更新」,但不給予帳號的控制權。
- Viewer:給只需要查看效能指標的人。
而且可以邀請額外的成員,不必每個人都經過開發人員註冊。對於代表客戶發布的代理商來說,這正是原本缺少的缺口:以前,上傳更新就代表要分享帳號。
企業的私人發布讓你能將擴充功能部署給外部組織,這些組織可以直接從 Chrome Web Store 核准它。同一份回顧還補充了生態系的一些背景資料:開發人員註冊數在過去一年增加了一倍,Chrome Web Store 上17% 的新擴充功能整合了 AI,而開發人員註冊正在擴大到另外超過 120 個國家。
各商店的圖片尺寸不同:比較表
這就是不會消失的工作。每間商店都要求同一張螢幕截圖以不同的裁切,而且四間之中有一間直接拒絕透明度。以下是根據各商店官方文件整理的比較:
| 素材 | Chrome Web Store | Microsoft Edge Add-ons | AMO(Firefox) | App Store Connect(Safari) |
|---|---|---|---|---|
| 圖示/商店頁面標誌 | 128x128 PNG(96x96 的圖案 + 16 px 透明邊距) | 1:1,建議 300x300,最小 128x128 | 32x32 與 64x64,PNG 或 JPEG | 容器 App 的圖示 |
| 螢幕截圖 | 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(選填) | — | — |
| 透明度 | 圖示在邊距中需要透明 | — | — | 禁止:不可有 Alpha 色版或透明 |
來源:Chrome Web Store 商店頁面圖片、發布 Microsoft Edge 擴充功能(2026 年更新的文件)、在 AMO 建立吸引人的商店頁面,以及 App Store Connect 螢幕截圖規格。

從這張表可以得出三個實用的結論:
- 1280x800 是最大公約數。它適用於 Chrome、Edge 和 AMO,也是 Apple 四種有效尺寸之一。如果你只打算製作一組螢幕截圖,就選這個。
- Apple 強迫你合併圖層。App Store Connect 不接受 Alpha 或透明度,所以匯出為透明背景的 PNG 即使「看起來沒問題」也會被拒絕。必須合併圖層並重新量測二進位檔,不要相信檢視器。
- Chrome 的圖示不是填滿的正方形。畫布為 128x128,圖案 96x96,每邊 16 px 的透明邊距。這是重複使用其他商店圖示時最常見的錯誤。
文字長度限制也不一致
每間商店在不同的地方截斷文字,其中兩間的文字不是在商店中撰寫,而是來自 manifest。以下是官方文件所述:
| 欄位 | 限制 | 來源 |
|---|---|---|
manifest 的 name | 最多 75 個字元 | Chrome 的 name 鍵 |
manifest 的 description | 不超過 132 個字元,純文字,不含 HTML | Chrome 的 description 鍵 |
| Edge 商店頁面說明 | 最少 250,最多 10,000 個字元 | 在 Edge Add-ons 發布 |
| Edge 搜尋字詞 | 最多 7 個字詞,總共 21 個單字,每個字詞 30 個字元 | 在 Edge Add-ons 發布 |
| AMO 摘要 | 250 個字元 | AMO 商店頁面 |
| App Store 的 App 名稱 | 2 到 30 個字元 | App Store Connect 的 App 資訊 |
| App Store 的副標題 | 30 個字元 | App Store Connect 的 App 資訊 |
兩個能省下一輪審核的細節:
- 在 Edge 中,擴充功能名稱與簡短說明在 Partner Center 中是唯讀的:它們來自 manifest。要更改就必須編輯
manifest.json、重新封裝並重新上傳。所以description的那 132 個字元不只是 Chrome 的事:它會跟著你走。 - 在 Edge 中,如果套件宣告了多種語言,但 Partner Center 中只出現一個語系,通常是因為 manifest 使用固定字串,而不是搭配
default_locale和_locales的__MSG_extensionName__預留位置。Partner Center 是根據這些 i18n 參照來偵測語言的。 - 在 Safari 中,名稱和副標題是容器 App 的,而不是擴充功能的:如果你原本的名稱有 75 個字元,那麼 30 個字元就太少了。
隱私權聲明要宣告四次,而在 Firefox 中則是寫在 manifest 裡
四個審核流程都不接受其他商店的聲明,而從 2025 年底起,Firefox 不再用表單要求,而是要求寫在 manifest 之內。這是規劃多瀏覽器發布時最容易被低估的流程部分。
Chrome Web Store。開發人員資訊主頁的隱私權分頁要求填寫單一用途、manifest 中宣告的每一項權限的理由、遠端程式碼使用聲明、資料使用做法的認證,以及隱私權政策網址。
Microsoft Edge Add-ons。Partner Center 的 Privacy 頁面以五個部分要求相同的內容: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 版 142。沒有正確設定這個鍵,擴充功能就無法提交簽署。對於在該日期之前已存在的擴充功能,Mozilla 表示它們需要「稍後」採用,但並未公布具體日期。
App Store Connect(Safari)。iOS 與 macOS 的 App 都必須提供隱私權政策網址,而隱私權聲明是在容器 App 層級進行,並以 App Store Connect 規格為參考。
封裝:三個 ZIP 與一個 Xcode 專案
四間商店中有三間使用相同的產出檔;第四間則不是。Chrome、Edge、Firefox 和 Opera 使用根目錄含 manifest.json 的 ZIP。Safari 需要的是 App 式封裝:擴充功能包在透過 App Store 發行的原生 App 之內。

要轉換到 Safari,Apple 提供命令列工具 xcrun safari-web-extension-converter,可從現有的網頁擴充功能產生 Xcode 專案;文件見為 Safari 封裝網頁擴充功能。真正的硬性要求不是技術上的,而是行政上的:在 App Store 發布需要 App Store Connect,而這只提供給 Apple Developer Program 的成員,費用為每年 99 USD 的會員費(符合資格的非營利組織、經認證的教育機構與政府單位可獲豁免)。至於 Chrome Web Store,建立開發人員帳號時要求一次性註冊費,依據其註冊頁面;Edge Add-ons 不收註冊費,如其開發人員註冊指南所述。
值得放進行事曆的審核時程
| 商店 | 官方文件的說法 |
|---|---|
| Chrome Web Store | 「大多數擴充功能的審核會在幾天內完成,但可能需要數週」;如果超過三週沒有變化,就必須聯絡支援(審核流程) |
| Microsoft Edge Add-ons | 提交後「認證流程最多可能需要七個工作天」(在 Edge 發布) |
Chrome 還補充了一點,值得在申請權限之前先讀:要求廣泛主機權限或敏感執行權限,或包含大量程式碼或難以審查的程式碼的擴充功能,審核時間會更長。
值得在四間商店都發布嗎?看市占率怎麼說
這取決於每個商店頁面的成本,因為桌面市占率的分配非常不均。根據 Statcounter Global Stats 在 2026年10月全球桌面的數據:
| 瀏覽器 | 桌面市占率(2026年10月) |
|---|---|
| Chrome | 66.98% |
| Edge | 13.24% |
| Safari | 7.83% |
| Firefox | 5.72% |
| Opera | 2.65% |
用腦袋想一下:Edge 是第二大市場,而且與 Chrome 共用幾乎整份規格(相同的 ZIP、相同的 1280x800 螢幕截圖、相同的 440x280 與 1400x560、相同的五個隱私權部分)。這是每小時投入報酬最高的選擇:用你現有的套件加上兩張新圖片,潛在觸及範圍就能加倍。Firefox 的成本是不同的 manifest 和資料鍵。Safari 才是真正花錢的:Xcode 專案、年度會員費,以及只有 30 個字元名稱的商店頁面。
檢查清單:發布一次,上架四次
這是依據上述內容,產生最少重工的順序:
- 使用
browser.*和 Promise 撰寫程式碼,如果你要涵蓋 148 之前的 Chrome,就加入globalThis.browser = chrome防護。 - 維護一份基礎 manifest,並在建置時產生變體:Chrome 與 Edge 使用
background.service_worker,Firefox 使用background.scripts,並且只在 Firefox 變體中加入browser_specific_settings.gecko區塊。 - 在封裝之前,將
name調整到 75 個字元、description調整到 132:這兩個欄位會供應 Chrome 的商店頁面,而且在 Edge 中是唯讀的。 - 如果你想在 Edge 提供多語言商店頁面,請使用
__MSG_extensionName__和__MSG_extensionDescription__,並搭配default_locale與_locales。 - 以 1280x800 製作螢幕截圖,並從一開始就不要含 Alpha 色版儲存:這是唯一適用於四間商店的版本。
- 將 Chrome 的圖示準備為 128x128,內含 96x96 的圖案與 16 px 的邊距,並將 Edge 的標誌準備為 1:1 的 300x300。
- 一次產生 440x280 的圖磚與 1400x560 的橫幅:它們在 Chrome 和 Edge 中通用。
- 撰寫單一用途,以及針對 manifest 中每項權限的理由,並在 Chrome 與 Edge 重複使用這段文字。
- 在 Firefox 的 manifest 中加入
data_collection_permissions,即使只是["none"],否則你將無法提交簽署。 - 把 Safari 留到最後並另外編列預算:使用
safari-web-extension-converter轉換、Apple Developer Program,以及不含透明度的 16:10 螢幕截圖。
常見問題
Chrome 擴充功能中的 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 自己的文件說 polyfill「不做任何事」,因為已經原生支援。
我可以把相同的螢幕截圖上傳到 Chrome、Edge、Firefox 和 Safari 嗎?
幾乎可以。如果你以 1280x800 且不含 Alpha 色版製作,四間商店都適用:那是 Chrome 的優先尺寸、Edge 接受的兩種之一、AMO 的建議尺寸,也是 App Store Connect 四種 16:10 尺寸之一。不同的是張數上限(Chrome 5 張、Edge 6 張、Apple 每種尺寸 10 張),以及圖示與圖磚,這些確實需要重做。
為什麼 App Store Connect 拒絕我的螢幕截圖 PNG?
最常見的原因是透明度:Apple 的規格說明圖片不能包含 Alpha 色版或透明度。帶有 Alpha 的 PNG,即使背景看起來是白色,也無法通過。必須合併圖層,並檢查輸出的二進位檔,而不是檢視器。
如果我在 Firefox 沒有宣告 data_collection_permissions 會怎麼樣?
如果是新擴充功能,你將無法把它提交到 addons.mozilla.org 進行簽署。自 2025年11月3日起,新擴充功能必須宣告;如果你沒有收集或傳輸資料,就必須以 {"required": ["none"]} 宣告。
每間商店的審核需要多久?
Chrome 說大多數擴充功能是「幾天」,個別情況可能長達數週。Edge 表示認證最多可能需要七個工作天。Chrome 還警告,廣泛的主機權限和難以審查的程式碼會延長流程。
我需要付費才能在四間商店發布嗎?
Chrome Web Store 在開設開發人員帳號時收取一次性註冊費。Edge Add-ons 不收註冊費,AMO 也不收。Safari 需要 Apple Developer Program,每年 99 USD 的會員費,因為 App Store 是發行管道。
Chrome 資訊主頁的 Item Manager 角色是什麼?
這是 I/O 2026 回顧中宣布的三個團隊角色之一:允許成員上傳並提交擴充功能的更新,而不給予帳號管理權,帳號管理權保留在 Admin 角色。第三個 Viewer 只能查看指標。
每間商店各一個商店頁面,但只量測一次
browser 命名空間所取代的工作是最顯眼的,卻不是最花錢的。最花錢的,過去是、現在仍然是商店頁面:四組尺寸、四種字元限制,以及四份不會在商店之間繼承的隱私權聲明。一個下午就完成,與經歷三輪被拒絕之間的差別,在於不要臨時猜測尺寸,並且在上傳前檢查每張圖片的二進位檔。
這正是 AiToolsForApps 的 aiChrome 所自動化的:MV3 manifest 建構器,會逐項權限顯示使用者將看到的原文提示;商店頁面撰寫工具,提供單一用途與逐項權限的理由;素材產生器,交付 128x128 的圖示、不含 Alpha 的 1280x800 螢幕截圖、440x280 的圖磚與 1400x560 的橫幅;以及驗證器,在瀏覽器中量測你的圖片,逐像素偵測真正的透明度,並提供符合各規格的裁切。如果你要上架四間商店,請先把 Chrome 的做到無可挑剔:Manifest V3 擴充功能尺寸、限制與隱私權聲明驗證表是起點,並且始終區分哪些是官方要求、哪些只是建議。
在把商店頁面複製到四間商店之前,先把 Chrome 的做到精準無誤:免費試用 aiChrome,不需註冊,產生 manifest、隱私權說明和圖片套件,並立即驗證你的螢幕截圖。
在把商店頁面複製到四間商店之前,先把 Chrome 的做到精準無誤:免費試用 aiChrome,不需註冊,產生 manifest、隱私權說明和圖片套件,並立即驗證你的螢幕截圖。


