dev、start 與 preview 中透過執行檔旗標與 extension.config.* 指向任何自訂執行檔。
依名稱執行分支
這些分支是一級的瀏覽器目標。把名稱傳給--browser,Extension.js 會自動在你的系統上找到已安裝的執行檔,並透過其引擎家族的啟動器執行:
chromium:/firefox: 前綴的欄位能正確解析(參見 瀏覽器專屬 manifest 欄位)。
執行自訂執行檔
若要執行沒有內建定位器的瀏覽器,或覆寫已定位的執行檔,使用下列其中一個旗標:--chromium-binary <path>--gecko-binary <path>(別名:--firefox-binary <path>)
執行檔功能
CLI 範例
start 與 preview 使用。
在 extension.config.* 中設定
目標對應行為
執行檔提示會對應到引擎目標:chromiumBinary→chromium-basedgeckoBinary/firefoxBinary→gecko-based
可用的瀏覽器
有內建定位器的分支可依名稱執行;其他則以執行檔旗標執行:重要限制
chromium-based需要有效的chromiumBinary路徑。gecko-based/firefox-based需要有效的geckoBinary路徑。- 無效路徑會立即失敗,並回報明確的 CLI/執行階段錯誤。
build不接受執行檔旗標。基於執行檔的啟動方式只能用在dev、start與preview。
最佳實務
- 執行檔搭配明確的瀏覽器目標:使用
--browser=chromium-based或--browser=gecko-based表達清楚意圖。 - 使用絕對路徑:避免 shell 路徑解析造成的問題。
- 在持續整合(CI)Runner 中固定版本:讓瀏覽器執行檔路徑在自動化檢查中保持確定性。
- 小心搭配設定檔/旗標:沿用具名瀏覽器目標所使用的設定檔與旗標策略。

