HTTP Toolkit 桌面版

这个仓库包含了 HTTP Toolkit 的桌面版构建设置，HTTP Toolkit 是一个美观、跨平台且开源的 HTTP(S) 调试代理、分析器和客户端。

想要报告错误、请求功能或发送反馈？请在 github.com/httptoolkit/httptoolkit 提交问题或对现有问题进行投票。

这是什么？

这个仓库负责将 HTTP Toolkit 构建成独立的桌面安装程序和可执行文件，用户可以在 Windows、Linux 和 Mac 上直接运行。

HTTP Toolkit 由两个运行时部分组成：UI，作为单页 Web 应用程序编写，以及 服务器，作为 Node.js CLI 应用程序编写。

这个仓库构建了一个单一的可执行文件，它：

• 包含最新版本的 httptoolkit-server
• 运行时：
  • 在后台启动服务器
  • 在 Electron 窗口中打开 UI
  • 关闭时终止服务器

这意味着这主要是 Electron 配置和设置，以及可执行文件和各种安装程序的构建配置。它使用 Electron Builder 构建。

这不是运行 HTTP Toolkit 的唯一方式！对大多数用户来说，这是最方便的选择，但也完全可以将服务器作为独立工具运行，并在任何你喜欢的浏览器中打开 UI（托管在 https://app.httptoolkit.tech）。

请注意，生成的可执行文件（目前）不会自动更新。相反，服务器（作为 oclif 应用）和 Web UI（通过 Service Workers）包含了自己的自动更新功能。

构建本身在 GitHub Actions 上完成，标记为 main 的构建会自动发布为 GitHub 发布版本。

贡献

如果你想改变 HTTP Toolkit 桌面 Shell 的行为（但不是其内容），改变其构建方式，或添加新的目标平台或格式，那么你来对地方了 :+1:。

入门步骤：

• 克隆这个仓库。
• npm install
• 要在本地构建和运行 Electron 应用：
  • npm start - 运行桌面应用，下载最新的实时服务器并使用 app.httptoolkit.tech 的实时 UI。
    • 如果你只在桌面应用上工作，并想在真实的实时环境中查看你的更改，这很有用。
  • npm run start:dev - 运行桌面应用，不使用内置服务器，而是使用 localhost:8080 的 UI。
    • 这实际上假设你已经有了可工作的 UI 和服务器，对于这方面的工作很有用。
    • 你可以从 UI 项目 中使用 npm start 启动两者，以在桌面应用中开发 UI。
    • 或者，你可以在 服务器项目 中运行 npm start，在 UI 项目中运行 npm run start:web，以开发服务器或两者。
• 要构建可分发的软件包：
  • npm run build - 这将尝试为你当前的平台构建和打包桌面应用

一些提示：

• Electron 开发行为与生产构建行为不完全相同，请确保在真正构建的版本中检查你的更改。
• 大多数可分发构建配置位于 package.json 中的 build 字段下。
• 要完全构建软件包，你可能会发现某些平台要求签名证书。你可能需要取消设置 forceCodeSigning 等字段来禁用它。
• 在 CI 中，拉取请求不会收到秘密环境变量，因此构建可能会失败。确认这是否是正在发生的情况，如果是，那也没关系 - 团队将手动构建和评估 PR 更改以解决这个问题。

许可证

HTTP Toolkit 桌面应用的源代码根据 AGPL-3.0 许可，如本仓库中所记录。

然而，从本仓库或 httptoolkit.tech 下载的二进制文件可以根据两种许可之一使用：

• AGPL-3.0，适用于那些希望在该许可的约束内修改和重新分发它们的人。
• 知识共享署名-禁止演绎 4.0 国际许可协议，适用于那些不需要这些权利并希望避免任何关于 AGPL 许可的担忧的人。