HN 日本語サマリー

← 一覧へ戻る
Web開発

ローカル画面ストリームでの0.5秒周期的な引っかかりはmacOSのAWDLが原因だった

A 0.5s periodic hitch in my local screen stream turned out to be macOS AWDL (github.com)

12 pointsby duchanjo4 コメント

要約

tapflowは、モバイルQAチーム向けのセルフホスト型Appetize/BrowserStack代替ツールです。iOSシミュレーターとAndroidエミュレーターをブラウザで実行でき、ツールチェーンのセットアップやデバイスプールの管理、クラウドへのアップロードなしで、ビルド、ストリーム、録画を自社インフラ内で完結させることができます。モバイル開発者以外のチームメンバーも、Macを共有してモバイルアプリのQAをブラウザから簡単に行えるように設計されています。

全文翻訳

tapflow — 全ての人に品質を。

モバイルQAチームのためのセルフホスト型Appetize / BrowserStack代替

iOSシミュレーターとAndroidエミュレーターを任意のブラウザで実行 — ツールチェーンのセットアップ不要、デバイスプール不要、クラウドへのアップロード不要。
あなたのビルド、ストリーム、録画は、あなたが管理するインフラストラクチャ上に保持されます。

WebDriverAgent不要  ·  2行のセットアップ  ·  MIT

[画像: GitHubスター数] [画像: Dockerプル数] [画像: 最新リリース] [画像: 前回のコミット] [画像: OpenSSFベストプラクティス] [画像: macOSエージェント]

📖 ドキュメント  ·  🚀 クイックスタート  ·  🎥 デモ  ·  🎬 セットアップ

tapflow-demo.mp4[動画]

H.264 over H.264でストリーミング、ゼロバッファデコーダー(MSEなし) — 遅延測定 ↗

v0.x、活発に開発中 — デフォルトで後方互換性あり。破壊的な変更は稀で、常に変更履歴に記載されます。ロードマップ →


なぜtapflowか?

モバイルQAは通常、シミュレーター、エミュレーター、または物理デバイスへのアクセスに依存しますが、チーム全体でのそのアクセスは均一ではありません。

モバイル開発者にとっては、MacでXcodeやAndroid Studioを開くことを意味します。それ以外の全員にとっては、毎回モバイル開発者に尋ねることを意味することがよくあります。

バックエンド開発者 — 「デプロイされたものを確認するために、サンドボックスビルドをどのようにインストールすればよいですか?」

プロダクトマネージャー — 「動作を比較するためだけに、バージョンをインストールしたり削除したりし続けています。」

デザイナー — 「画面サイズごとのレイアウトを確認する必要がありますが、適切なデバイスを持っていません。」

物理デバイスは、OSバージョンのカバレッジ、可用性、充電、ストレージ、ハンドオフといった独自のオーバーヘッドを追加します。クラウドシミュレーターサービスはアクセス問題を解決しますが、サードパーティサービスに内部ビルドをアップロードし、自分のMacがすでに同じシミュレーターを実行できるのにリモートデバイスに料金を支払う必要があります。

私たちはこの問題をまさに経験し、tapflowを構築しました。

ソリューション欠点
Appetize / BrowserStack継続的なコスト — そしてアプリビルドはサードパーティのクラウドにアップロードされる
物理デバイスコスト、可用性、OSカバレッジ、管理オーバーヘッド
Xcode / Android Studio各チームメンバーはMacと完全なモバイルツールチェーンを必要とする
tapflow自分のMacを再利用 — データはあなたが管理するインフラストラクチャ上に留まり、チーム全体がブラウザからQAを行う

仕組み

tapflowは3つの部分を接続します。

  1. セルフホスト型リレー (LinuxまたはMac) — 同じポートでダッシュボードも提供するため、別個のWebサーバーは不要です。
  2. macOSエージェント — iOSシミュレーターとAndroidエミュレーターを操作します。リレーにアウトバウンドで接続し(インバウンドファイアウォールルール不要)、WebDriverAgentなしでiOSタッチを直接注入します。
  3. ブラウザダッシュボード — チームの他のメンバー向け。利用可能なデバイスを選択し、シミュレーターがMac上で実行され続ける間、リアルタイムで操作します。
ブラウザ(あなたのチーム)  ←─ WebSocket ─→  リレーサーバー  ←─ WebSocket (アウトバウンド) ─→  Macエージェント
                                    (Linux / Mac)                           (iOS · Android)

tapflowではないもの

tapflowはネイティブモバイル開発ツールを置き換えるものではありません。モバイル開発者は引き続きXcode、Android Studio、およびそれらのビルドツールを使用します。tapflowは、実行中のシミュレーターとエミュレーターをブラウザ経由でチームの他のメンバーにアクセス可能にし、デバイスファームではありません。自動化されたQA軸(決定論的なフローランナーとLLMエージェント用のMCPサーバー)はありますが、WebDriverAgentやAppiumのような外部自動化フレームワークを接続することは範囲外です。tapflowは独自の最小限のランナーを提供します。

これがどこへ向かうかは、VISION.mdに概説されています。手動QAを、必要に応じて自動化へと成長させていきます。

クイックスタート

1. インストール
npm install -g tapflow
# または: yarn global add tapflow  |  pnpm add -g tapflow
2. 環境設定

エージェントを実行するMacで、シミュレーター/エミュレーターの前提条件を一度にインストールします。

tapflow setup

リレー専用サーバー(Linux)ではこれをスキップしてください。環境設定を参照してください。

3. リレー + エージェントの起動
tapflow start
# ✓ Relay started on http://localhost:4000
# ✓ iOS Agent connected (3 simulators available)

これにより、同じMac上でリレーとエージェントの両方が起動します(ローカルモード)。

4. 最初の管理者アカウントの作成

ブラウザで http://localhost:4000 を開きます。tapflowは /setup にリダイレクトして管理者アカウントを作成させます。

ヘッドレスサーバーの場合? tapflow admin init を使用して、CLI経由で管理者アカウントを作成してください。

5. ダッシュボードを開く

http://localhost:4000 に移動し、作成したアカウントでサインインします。

問題がありますか? tapflow doctor を実行して、いつでも前提条件を再確認してください。

要件

コンポーネント要件
リレーサーバーNode.js ≥ 22、任意のOS(Linux/macOS)、約512MB RAM
iOSエージェントmacOS 26または27、Xcode 26または27 + iOSシミュレーターランタイム(または tapflow setup ios を実行)、Node.js ≥ 22
AndroidエージェントmacOS、Java + Android SDKとAVD(または tapflow setup android を実行)、Node.js ≥ 22
ブラウザ(QA)任意のモダンブラウザ — Chrome、Firefox、Safari、Edge

エージェントはmacOSのみで実行されます(Mac上のiOSシミュレーターとAndroidエミュレーターを操作するため)。リレーはどこでも実行できます。

特徴

  • QAユーザー向けのモバイルツールチェーン不要 — チームメンバーはXcode、Android Studio、またはローカルシミュレーターツールをインストールせずにブラウザからテストできます。
  • デフォルトでセルフホスト — サードパーティのクラウドや外部アカウントは不要。すべて既存のハードウェアで実行されます。
  • 既存のMac環境を活用 — iOSシミュレーターまたはAndroidエミュレーターがすでに利用可能なMacでエージェントを実行します。
  • APIファースト — RESTエンドポイントとパーソナルアクセストークンは、CI/CDおよびAIエージェントワークフローをサポートします。

含まれるもの:

  • ブラウザストリーミング — iOS & Androidを約30fpsで、デバイス上に特別なアプリは不要。どちらも2層デコーダー(セキュアコンテキストではWebCodecs、プレーンHTTPではWASM/tinyh264)を介してH.264でストリームするため、デコードパスからメディア要素バッファが削除されます。解像度は接続に合わせて適応します — セキュアコンテキストではネイティブ、プレーンHTTP LANではダウンサンプリングされます。1
  • コーデックフォールバック — ストリームはクライアントごとにコーデックをネゴシエートし、ハードウェアまたはWASMデコーダーが利用できない場合はJPEGにフォールバックするため、古いブラウザでも動作します。
  • タッチ、スワイプ、ピンチ — リアルタイム入力をシミュレーターまたはエミュレーターに転送します。
  • ディープリンクツールバー — サポートされているディープリンクをQAツールバーから直接開きます。
  • キーボードショートカット — キーボードからシミュレーターツールバーのアクションをトリガーします。
  • クリップボード同期 — Macとデバイス間で双方向にコピー&ペーストできます。デバイスからのコピーにはHTTPSまたはlocalhost上のダッシュボードが必要です。プレーンHTTPではテキストはデバイス自身のクリップボードにコピーされ、ダッシュボードにその旨が表示されます。
  • デバイスオーディオ — アプリのサウンドがブラウザタブに戻ります。
  • ネットワーク制御 — デバイスをネットワークから切断し、再度接続して、アプリがオフラインでどのように動作するかをテストします。iOSは一度ネットワークフィルターをインストールします。Androidは何も必要ありません。
  • App Center — .app.zip / .apk をアップロードし、ビルドをステータス(バックログ / 進行中 / 完了 / 却下)で追跡します。
  • セッション録画 — QAセッションを録画・共有できます。リレーに約72時間保存され、その後自動的にパージされます。
  • スクリーンショットRESTエンドポイント — CIおよびAIエージェント用の GET /api/v1/sessions/:sessionId/screenshot。
  • Macリソース監視 — エージェントごとのCPUとRAMを監視し、セッション割り当て前に過負荷のホストを特定します。
  • チーム管理 — 招待リンク、ロール(管理者/開発者/QA/ビューア)、およびパーソナルアクセストークン。
  • フローランナー — tapflow flow run は、条件付き待機とJUnitレポートを備えたYAMLフローをリプレイし、リプレイ時にはLLMを呼び出しません。実験的です。
  • MCPサーバー — @tapflowio/mcp-server を使用すると、Claude CodeなどのLLMエージェントがシミュレーターをネイティブツールとして制御できます。実験的です。

1 実際のLANでは、デコードから表示までの測定値は数十ミリ秒(WASMソフトウェアデコーダーでp50 ~11–17 ms、HTTPS上のWebCodecsでさらに高速)です。エンドツーエンドの「ガラスからガラスまで」の遅延は、それにネットワークのラウンドトリップが加わります。ストリーミング遅延ログで完全な測定値、条件、既知の制限事項を確認してください。

セキュリティとプライバシー

tapflowは設計上セルフホスト型です — ビルドファイル、デバイスストリーム、セッション録画は、あなたが管理するインフラストラクチャ上に留まり、サードパーティサービスに送信されることはありません。

データどこに留まるか
アプリバイナリ(.app.zip / .apk)リレーのストレージ
デバイスストリーム(ビデオ・タッチ)あなたがホストするリレー↔ブラウザパス
セッション録画リレーのストレージ。72時間後に期限切れ、その後パージ
アカウントとチームデータリレーのSQLite DB
サードパーティシミュレータークラウド不要
  • LAN優先 — エージェント↔リレー間の通信は内部トラフィックです。デバイスストリームはサードパーティを経由しません。
  • リレーが信頼の境界線 — アカウント、ビルド、ライブデバイス制御を保持するため、それにアクセスできるものが公開される対象となります。エージェントはアウトバウンド接続のみを行います。
  • デフォルトでオフホスト認証 — リレーは、自身のマシン(localhost)からの認証されていない接続のみを受け入れます。それ以外の場所からアクセスするブラウザはサインインします。別マシン上のエージェントはagentスコープのトークンを提示します。トンネルを介したトラフィックは、トンネルクライアントがリレーのマシン上で実行されていても、オフホストと見なされます。
  • PAT + ロール — パーソナルアクセストークンはスコープ(CIアップロード用のbuilds:write、リモートエージェント用のagent)を持ち、チームロール(管理者/開発者/QA/ビューア)はダッシュボードへのアクセスを制御します。

脆弱性を発見しましたか? SECURITY.md を参照してください。完全なモデルについては、セキュリティとプライバシーをお読みください。

セルフホスティング

単一のMacでは、tapflow start(クイックスタートを参照)以外に何も必要ありません。チームの場合は、リレーを別のLinuxサーバーまたは専用Macで実行し、各Macエージェントをそれに接続します。

リレーサーバー:

# 推奨:PM2で自動再起動
npm install -g pm2 tapflow
JWT_SECRET=$(openssl rand -hex 32) pm2 start tapflow --name relay -- relay start
pm2 save && pm2 startup

またはDockerでリレーを実行:

docker run -d -p 4000:4000 -v "$PWD/data:/app/.tapflow/data" tapflow/tapflow:latest

イメージはリレーのみです — エージェントはあなたのMac上に残ります。ボリュームは必須です(サインインシークレットを保持するため)、招待リンクにはTAPFLOW_RELAY_URLが必要です。Docker Composeで完全なセットアップを参照してください。

各Macエージェント:

tapflow agent start --relay wss://your-relay-url --token <agent-token>

別のマシン上のリレーは、agentスコープのトークンがないとエージェントを受け入れません — 設定 → トークン(管理者のみ)で作成します。リレー自身のマシン上のエージェント(tapflow start)はトークンを必要としません。リモートリレー認証を参照してください。

nginx / Caddyリバースプロキシ設定と外部アクセスについては、外部アクセスを参照してください。

CLIリファレンス

コマンド説明
tapflow startリレーとエージェントを一緒に起動(ローカルモード)
tapflow relay startリレーのみを起動
tapflow agent start --relay <url> [--token <pat>]エージェントを起動し、リレーに接続(リモートリレーにはagentスコープのトークンが必要)
tapflow initこのマシンのtapflowを設定(デフォルトは~/.tapflow)
tapflow admin init最初の管理者アカウントを作成(CLIフォールバック)
tapflow doctor [platform]前提条件を診断(Node、iOS、Android)
tapflow setup [platform]ローカル環境をインストール・設定
tapflow devices利用可能なシミュレーターとエミュレーターを一覧表示
`tapflow boot <nameudid>`
tapflow status接続されているエージェント、デバイス、アクティブなセッションを表示
tapflow resetすべてのシミュレーターとエミュレーターをシャットダウン
tapflow logs最近のリレーログエントリを表示(リレーホストで実行)

完全なリファレンス → CLIドキュメント

ドキュメント

完全なドキュメント:www.tapflow.dev

貢献

tapflowは活発に開発されており、PRを歓迎します — ブランチ戦略、コミット規約、アーキテクチャ概要については、CONTRIBUTING.mdを参照してください。詳細については、コントリビューターノートでSimulatorKitのリバースエンジニアリングとストリーミングレンダリングパイプラインをカバーしています。参加するすべての人に、行動規範に従うことが期待されます。

要件: Node.js ≥ 22、pnpm ≥ 9

git clone https://github.com/jo-duchan/tapflow.git
cd tapflow
pnpm install
pnpm dev

ライセンス

MIT — Copyright © 2026-present tapflow contributors

tapflowはAndroid画面ストリーミングのためにscrcpy-server(Apache-2.0)をバンドルしています。完全な帰属表示についてはNOTICEを参照してください。