浏览器端
最后更新于
最后更新于
在开始之前，您必须先完成。
1、构建并运行扩展：
2、使用下一节中的说明在浏览器中加载已解压的浏览器扩展。
默认情况下，浏览器扩展将运行指向生产服务器的端点。要覆盖此设置以进行本地开发和测试，有多种选项。
managedEnvironment浏览器扩展具有「代管式环境」的概念，它是存储在 devFlags 对象内的 中的 JSON 配置。
managedEnvironment 设置允许贡献者覆盖服务器的任何或所有 URL。 managedEnvironment 在 中被读取，并为任何提供的 URL 覆盖默认的（生产）设置。
有两种使用 managedEnvironment 的方法，具体取决于您是否同时运行 Web Vault。
managedEnvironment如果您还同时运行 Web Vault，则只需在 managedEnvironment 中设置 base URL：
这意味着当 Web Vault 运行时，浏览器 managedEnvironment 无需逐个覆盖每一个 URL。浏览器会将每个 URL 格式化为 {base}/{endpoint}，例如 http://localhost:8080/api，但 webpack DevServer 会将该 URL 代理到正确的端口，例如 http://localhost:4000。
managedEnvironment如果您在没有运行 Web Vault 的情况下测试浏览器扩展，您将无法利用 webpack DevServer 来代理 URL。这意味着您的 managedEnvironment 设置必须显式覆盖您要在本地进行通信的所有 URL。
配置完成后，您的本地自定义环境看上去应该像这样：
要加载浏览器扩展构建：
在地址栏中导航到 chrome://extensions，这将打开扩展页面
开启「开发者模式」（切换开关）
点击「加载已解压的扩展程序」按钮
打开您本地存储库的 build 文件夹然后确认您的选择
现在您已拥有了已安装的浏览器扩展程序的本地构建。
您可以通过点击 chrome://extensions 中 Bitwarden 标题下方的「background.html」来调试浏览器扩展的背景页面。您可以在弹出窗口打开时右键点击它并点击「检查」来调试它。
要加载浏览器扩展构建：
在地址栏中导航到 about:debugging，这将打开附加组件页面
点击「此 Firefox」
点击「载入临时附加组件」
打开您本地存储库的 build 文件夹然后打开 manifest.json 文件
现在您已拥有了已安装的浏览器扩展程序的本地构建。
临时附加组件仅安装在当前会话中。如果您关闭然后重新打开 Firefox，您必须再次加载临时附加组件。
您可以通过点击临时附加组件页面中 Bitwarden 标题旁边的「检查」按钮来调试浏览器扩展的背景页面。要调试弹出窗口：
使用上面的说明检查背景页面
点击调试器右上角的「三点」，然后点击「禁用弹出式自动隐藏」
打开扩展弹出窗口
点击「iframe」按钮（「三点」旁边）然后选择「/popup/index.html」
Safari WebExtensions 必须通过 Mac App Store 分发，并与常规 Mac App Store 应用程序捆绑在一起。因此，与其他浏览器相比，构建和调试过程略有不同。
如果您已构建、已安装或运行过桌面客户端（包括官方版本），Safari 很可能会继续加载官方浏览器扩展，而不是加载从源代码构建的版本。
要避免这种情况，请按照以下说明卸载 Safari 扩展：
打开 Safari
点击「设置」，然后点击「扩展程序」选项卡
点击 Bitwarden 扩展旁边的「卸载」
使用扩展删除此应用程序
重新打开 Safari 并检查「设置」以确认没有安装 Bitwarden 浏览器扩展。如果仍有 Bitwarden 扩展，请重复步骤 3-4
退出并完全关闭 Safari 浏览器
如果您要从不同来源加载浏览器扩展（例如，在本地构建和官方版本之间切换），您可能需要定期执行此操作。
开发扩展的最简单方法是使用 Xcode 构建和调试它。
1、构建扩展：
2、编辑 build/manifest.json。将 nativeMessaging 权限从 optional_permissions 部分移至 permissions 部分。
3、编辑 build/index.html 文件，将 <html class="__BROWSER__"> 替换为 <html class="browser_safari">。
3、在 Xcode 中打开 src/safari/desktop.xcodeproj
4、运行「桌面」目标。
另一种方法是通过 gulp 使用「正确的」构建流程。这种方法不需要对输出进行任何手动处理，因为 gulp 会为我们完成这些工作。不过，我们必须为每次更改完全重建扩展，这会比较慢。
要构建并加载浏览器扩展：
1、为 Safari 构建扩展
2、打开 Safari 并检「设置」以确认扩展已安装且已启用
要启用调试：
点击「设置」，然后点击「高级」选项卡
启用「在菜单栏中显示开发菜单」
您可以通过点击 Develop -> Web Extension Background Pages，然后选择 Bitwarden 来调试浏览器扩展的背景页面。您可以在弹出窗口打开时右键点击它并点击「检查元素」来调试它。
对于大多数调试和测试来说，这应该足够了，除非您使用的是本机代码。
这是因为 Web Vault 在其 中包含了 webpack-dev-server 软件包。当它运行时，它根据自己的 配置文件中的配置设置代理每一个端点：
加载扩展后，您可能需要调整服务器 URL 以指向本地服务器，而不是在 managedEnvironment 中覆盖它们。您可以通过浏览器设置更改。有关如何配置 URL 的说明，请点击。
您可能需要。