webtorrent desktop

ВебТоррент Рабочий стол

Потоковое торрент-приложение. Для Mac, Windows и Linux.

Установить

Рекомендуемая установка

Загрузите последнюю версию WebTorrent Desktop с официального сайта:

Загрузите рабочий стол 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

Запуск линтеров

 $ npm test

Запустите интеграционные тесты

 $ npm run test-integration

В интеграционных тестах используются Spectron и Tape. Они просматривают приложение, делают снимки экрана и сравнивают каждый из них с эталоном. Зачем скриншоты?

• Специальная проверка усложняет написание тестов.
• Даже сравнение всего HTML не так тщательно, как сравнение скриншотов. Например, он не обнаружит ошибку, при которой нажатие ESC в видео не восстанавливает правильно размер окна.
• Собственные интеграционные тесты Chrome используют сравнение скриншотов iirc
• Небольшие изменения пользовательского интерфейса приведут к поломке некоторых тестов, но исправить это так же просто, как удалить некорректные скриншоты и запустить тесты, которые воссоздадут их в новом виде.
• Полученный в результате PR Github затем покажет, пиксель за пикселем, точные изменения пользовательского интерфейса, которые были внесены! См. https://github.com/blog/817-behold-image-view-modes.

Для MacOS вам понадобится экран Retina для прохождения интеграционных тестов. Ваш экран должен иметь такое же разрешение, как у MacBook Pro 13 дюймов 2018 года.

Для 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 — 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 (фреймворк для создания собственных приложений для Windows, OSX и Linux на Javascript): https://electronjs.org/docs/tutorial/quick-start

React.js (фреймворк для работы с пользовательским интерфейсом Frontend): https://reactjs.org/docs/getting-started.html

Material UI (компоненты React, реализующие Material Design от Google): https://material-ui.com/getting-started/installation.

Конфиденциальность

WebTorrent Desktop собирает базовую статистику использования, которая помогает нам улучшить приложение. Например, мы отслеживаем, насколько хорошо работает кнопка воспроизведения. Как часто это удается? Тайм-аут? Показать отсутствующую ошибку кодека?

Приложение никогда не отправляет никакой личной информации и не отслеживает, какие торренты вы добавляете.

Лицензия

Массачусетский технологический институт. Авторские права (c) WebTorrent, LLC.