WebTorrent 桌面版
流式种子应用程序。适用于 Mac、Windows 和 Linux。
安装
推荐安装
从 官方网站 下载最新版本的 WebTorrent 桌面版:
✨ 下载 WebTorrent 桌面版 ✨
高级安装
-
从 GitHub 发布页面 下载特定的安装程序文件。
-
使用 Homebrew-Cask 从命令行安装:
$ brew install --cask webtorrent
-
通过克隆 Git 仓库尝试(不稳定的)开发版本。请参考"如何贡献"部分。
屏幕截图
如何贡献
获取代码
$ git clone https://github.com/webtorrent/webtorrent-desktop.git
$ cd webtorrent-desktop
$ npm install
运行应用程序
$ npm start
监视代码
每次代码更改都会自动重新启动应用程序。在开发期间很有用。
$ npm run watch
运行linter
$ npm test
运行集成测试
$ npm run test-integration
集成测试使用Spectron和Tape。它们会点击应用程序,拍摄屏幕截图并将每个截图与参考截图进行比较。为什么要使用屏幕截图?
- 即时检查会让测试编写更加困难
- 即使对整个HTML进行差分也不如屏幕截图差分全面。例如,它无法捕捉到从视频中按下ESC不能正确还原窗口大小的错误。
- Chrome自己的集成测试也使用了屏幕截图差分
- 小的UI更改会破坏几个测试,但修复起来很简单,只需删除有问题的屏幕截图并运行测试即可,这样就会生成新的屏幕截图。
- 生成的GitHub PR将逐像素地显示所做的确切UI更改!见 https://github.com/blog/817-behold-image-view-modes
对于macOS,你需要一个视网膜屏幕才能通过集成测试。你的屏幕分辨率应该与2018年MacBook Pro 13英寸相同。
对于Windows,你需要 Windows 10 和 1366x768 屏幕分辨率。
运行集成测试时,请将鼠标保持在屏幕边缘,并且在测试运行时不要触碰鼠标或键盘。
打包应用程序
为Mac、Linux和Windows构建应用程序二进制文件。
$ npm run package
只编译一个平台:
$ npm run package -- [platform] [options]
其中[platform]
是darwin
、linux
、win32
或all
(默认)。
可用的可选参数如下:
--sign
- 签署应用程序(Mac、Windows)--package=[type]
- 打包单个输出类型。deb
- Debian软件包rpm
- RedHat软件包zip
- Linux压缩包dmg
- Mac磁盘映像exe
- Windows安装程序portable
- Windows便携式应用程序all
- 所有平台(默认)
注意:即使使用--package
选项,自动更新文件(.nupkg用于Windows,-.darwin.zip用于Mac)也将始终生成。
Windows构建注意事项
Windows应用程序可以从任何平台打包。
注意:Windows代码签名仅在Windows上工作,目前为止。
注意:要从非Windows平台打包Windows应用程序,需要安装Wine和Mono。例如在Mac上,先安装XQuartz,然后运行:
$ brew install wine mono
(需要使用Homebrew包管理器。)
Mac构建注意事项
Mac应用程序只能在macOS上打包。
Linux构建注意事项
Linux应用程序可以从任何平台打包。
如果从Mac打包,请使用Homebrew安装系统依赖项,运行:
npm run install-system-deps
开始使用该应用程序的推荐读物
Electron (一个使用JavaScript开发原生Windows、OSX和Linux应用的框架): https://electronjs.org/docs/tutorial/quick-start
React.js (一个用于构建用户界面的前端框架): https://reactjs.org/docs/getting-started.html
Material UI (一个实现谷歌材料设计的React组件库): https://material-ui.com/getting-started/installation
隐私
WebTorrent桌面版会收集一些基本的使用统计数据,以帮助我们改进应用程序。例如,我们会跟踪播放按钮的工作情况,例如成功率、超时次数、缺失编解码器错误等。
该应用程序从未发送任何个人身份信息,也不会跟踪你添加的种子。
许可证
MIT。版权所有 (c) WebTorrent, LLC。