webtorrent desktop

WebTorrent-Desktop

Die Streaming-Torrent-App. Für Mac, Windows und Linux.

Installieren

Empfohlene Installation

Laden Sie die neueste Version von WebTorrent Desktop von der offiziellen Website herunter:

Laden Sie WebTorrent Desktop herunter

Erweiterte Installation

• Laden Sie bestimmte Installationsdateien von der GitHub-Release-Seite herunter.

• Verwenden Sie Homebrew-Cask zur Installation über die Befehlszeile:

   $ brew install --cask webtorrent
  

• Probieren Sie die (instabile) Entwicklungsversion aus, indem Sie das Git-Repository klonen. Sehen Sie sich die Anleitung „So leisten Sie einen Beitrag“ an.

Screenshots

So können Sie einen Beitrag leisten

Holen Sie sich den Code

 $ git clone https://github.com/webtorrent/webtorrent-desktop.git
$ cd webtorrent-desktop
$ npm install

Führen Sie die App aus

 $ npm start

Achten Sie auf den Code

Starten Sie die App jedes Mal automatisch neu, wenn sich der Code ändert. Nützlich während der Entwicklung.

 $ npm run watch

Linters ausführen

 $ npm test

Führen Sie Integrationstests durch

 $ npm run test-integration

Die Integrationstests verwenden Spectron und Tape. Sie klicken sich durch die App, machen Screenshots und vergleichen jeden einzelnen mit einer Referenz. Warum Screenshots?

• Durch die Ad-hoc-Überprüfung wird das Schreiben der Tests deutlich aufwändiger
• Selbst die Differenzierung des gesamten HTML-Codes ist nicht so gründlich wie die Differenzierung von Screenshots. Es würde beispielsweise keinen Fehler erkennen, bei dem das Drücken von ESC in einem Video die Fenstergröße nicht korrekt wiederherstellt.
• Die eigenen Integrationstests von Chrome verwenden Screenshot-Diffing-IIRC
• Kleine Änderungen an der Benutzeroberfläche führen dazu, dass einige Tests kaputt gehen, aber die Lösung ist so einfach wie das Löschen der fehlerhaften Screenshots und das Ausführen der Tests, die sie mit dem neuen Aussehen wiederherstellen.
• Die resultierende Github-PR zeigt dann Pixel für Pixel die genauen UI-Änderungen an, die vorgenommen wurden! Siehe https://github.com/blog/817-behold-image-view-modes

Für MacOS benötigen Sie einen Retina-Bildschirm, damit die Integrationstests bestehen. Ihr Bildschirm sollte die gleiche Auflösung wie ein 2018 MacBook Pro 13" haben.

Für Windows benötigen Sie Windows 10 mit einem 1366x768-Bildschirm.

Halten Sie beim Ausführen von Integrationstests die Maus am Rand des Bildschirms und berühren Sie weder die Maus noch die Tastatur, während die Tests ausgeführt werden.

Verpacken Sie die App

Erstellt App-Binärdateien für Mac, Linux und Windows.

 $ npm run package

So bauen Sie für eine Plattform:

 $ npm run package -- [platform] [options]

Wobei [platform] darwin , linux , win32 oder all (Standard) ist.

Die folgenden optionalen Argumente sind verfügbar:

• --sign – Signieren Sie die Anwendung (Mac, Windows)
• --package=[type] – Einzelausgabetyp des Pakets.
  • deb – Debian-Paket
  • rpm – RedHat-Paket
  • zip – Linux-Zip-Datei
  • dmg – Mac-Disk-Image
  • exe – Windows-Installer
  • portable – tragbare Windows-App
  • all – Alle Plattformen (Standard)

Hinweis: Auch mit der Option --package werden die Auto-Update-Dateien (.nupkg für Windows, -darwin.zip für Mac) immer erstellt.

Hinweise zum Windows-Build

Die Windows-App kann von jeder Plattform aus gepackt werden.

Hinweis: Die Windows-Codesignatur funktioniert derzeit nur unter Windows .

Hinweis: Um die Windows-App von Nicht-Windows-Plattformen zu packen, müssen Wine und Mono installiert sein. Installieren Sie beispielsweise auf einem Mac zuerst XQuartz und führen Sie dann Folgendes aus:

 $ brew install wine mono

(Erfordert den Homebrew-Paketmanager.)

Hinweise zum Mac-Build

Die Mac-App kann nur von macOS aus gepackt werden.

Hinweise zum Linux-Build

Die Linux-App kann von jeder Plattform aus gepackt werden.

Wenn Sie vom Mac aus packen, installieren Sie Systemabhängigkeiten mit Homebrew, indem Sie Folgendes ausführen:

 npm run install-system-deps

Empfohlene Lektüre, um mit der Arbeit in der App zu beginnen

Electron (Framework zum Erstellen nativer Apps für Windows, OSX und Linux in Javascript): https://electronjs.org/docs/tutorial/quick-start

React.js (Framework für die Arbeit mit der Frontend-Benutzeroberfläche): https://reactjs.org/docs/getting-started.html

Material-Benutzeroberfläche (React-Komponenten, die Googles Material Design implementieren.): https://material-ui.com/getting-started/installation

Privatsphäre

WebTorrent Desktop sammelt einige grundlegende Nutzungsstatistiken, um uns dabei zu helfen, die App zu verbessern. Wir verfolgen beispielsweise, wie gut der Play-Button funktioniert. Wie oft gelingt es? Auszeit? Einen fehlenden Codec-Fehler anzeigen?

Die App sendet niemals personenbezogene Daten und verfolgt auch nicht, welche Torrents Sie hinzufügen.

Lizenz

MIT. Urheberrecht (c) WebTorrent, LLC.