通过二进制路径运行其他浏览器

​

按名称运行分支

extension dev --browser=brave

extension dev --browser=waterfox

​

运行自定义二进制

• --chromium-binary <path>
• --gecko-binary <path>（别名：--firefox-binary <path>）

​

二进制能力

​

CLI 示例

extension dev --browser=chromium-based --chromium-binary="/path/to/brave"

extension dev --browser=firefox --gecko-binary="/path/to/firefox-developer-edition"

​

在 extension.config.* 中配置

export default {
  browser: {
    "chromium-based": {
      chromiumBinary: "/path/to/custom-chromium-browser",
    },
    "gecko-based": {
      geckoBinary: "/path/to/custom-gecko-browser",
    },
  },
};

export default {
  commands: {
    dev: {
      chromiumBinary: "/path/to/custom-chromium-browser",
    },
    preview: {
      geckoBinary: "/path/to/custom-gecko-browser",
    },
  },
};

​

目标映射行为

• chromiumBinary → chromium-based
• geckoBinary / firefoxBinary → gecko-based

​

可用浏览器

​

重要约束

• chromium-based 需要一个有效的 chromiumBinary 路径。
• gecko-based / firefox-based 需要一个有效的 geckoBinary 路径。
• 无效路径会以清晰的 CLI / 运行时错误立即失败。
• build 不接受二进制 flag。基于二进制的启动只能配合 dev、start 与 preview 使用。

​

最佳实践

• 二进制与显式浏览器目标搭配：使用 --browser=chromium-based 或 --browser=gecko-based，让意图更可预期。
• 使用绝对路径：避免与 shell 相关的路径解析问题。
• 在 CI runner 上锁定版本：让浏览器二进制路径在自动化检查中保持确定性。
• 谨慎与 profile / flag 组合：复用与具名浏览器目标相同的 profile 与 flag 策略。

​

下一步

• 进一步了解 浏览器 preferences。
• 进一步了解 浏览器 profile。