webtorrent desktop

WebTorrent デスクトップ

ストリーミング トレント アプリ。 Mac、Windows、Linux 用。

インストール

推奨されるインストール

公式 Web サイトから 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 の差分スクリーンショットを使用します
• UI を少し変更するといくつかのテストが中断されますが、修正は問題のあるスクリーンショットを削除してテストを実行するだけで簡単で、新しい外観で再作成されます。
• 結果として得られる Github PR には、行われた UI の正確な変更がピクセルごとに表示されます。 https://github.com/blog/817-behold-image-view-modes を参照してください。

MacOS の場合、統合テストに合格するには Retina スクリーンが必要です。画面の解像度は 2018 MacBook Pro 13 インチと同じである必要があります。

Windows の場合は、1366x768 画面の Windows 10 が必要です。

統合テストを実行するときは、マウスを画面の端に置いて、テストの実行中にマウスやキーボードに触れないでください。

アプリをパッケージ化する

Mac、Linux、Windows 用のアプリ バイナリをビルドします。

 $ npm run package

1 つのプラットフォーム用にビルドするには:

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

[platform]は、 darwin 、 linux 、 win32 、またはall (デフォルト) です。

次のオプションの引数を使用できます。

• --sign - アプリケーションに署名します (Mac、Windows)
• --package=[type] - 単一の出力タイプをパッケージ化します。
  • deb - Debian パッケージ
  • rpm - RedHat パッケージ
  • zip - Linux zip ファイル
  • dmg - Mac ディスクイメージ
  • exe - Windows インストーラー
  • portable - Windows ポータブル アプリ
  • all - すべてのプラットフォーム (デフォルト)

注: --packageオプションを使用した場合でも、自動更新ファイル (Windows の場合は .nupkg、Mac の場合は -darwin.zip) が常に生成されます。

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 (フロントエンド UI と連携するフレームワーク): https://reactjs.org/docs/getting-started.html

マテリアル UI (Google のマテリアル デザインを実装する React コンポーネント): https://material-ui.com/getting-started/installation

プライバシー

WebTorrent Desktop は、アプリの改善に役立ついくつかの基本的な使用状況の統計を収集します。たとえば、再生ボタンがどの程度機能するかを追跡します。どのくらいの頻度で成功しますか?タイムアウト？コーデックが見つからないエラーを表示しますか?

このアプリは個人を特定する情報を送信したり、追加したトレントを追跡したりすることはありません。

ライセンス

マサチューセッツ工科大学著作権 (c) WebTorrent, LLC.