PageSpy

English | 中文 | 日本語

はじめに

PageSpy は、Web、React Native、ミニプログラム、HarmonyOS アプリなど、複数プラットフォーム上のプロジェクトをデバッグするためのツールです。

ネイティブ API をラップし、メソッド実行時の引数をフィルタ・変換したうえで標準形式にシリアライズし、デバッグ用クライアントへ送ります。クライアント側では、ローカルの開発者ツールのコンソールに近い UI でデータを直感的に表示します。

PageSpy を選ぶ理由

百聞は一見にしかず。

使用する場面

ローカルのコンソールではデバッグできない場面こそ、PageSpy が力を発揮します！ 代表的な例をいくつか挙げます。

• H5 / WebView アプリのローカルデバッグ：画面が小さく、従来のデバッグパネルは操作しづらく表示も窮屈で、ログが途中で切れやすい。
• リモートワークや越境の共同作業：メール・電話・会議の往復は遅く、エラー情報が欠けて誤解や誤判断につながりやすい。
• ユーザー端末での白画面などの調査：ダッシュボードやログ基盤は業務とスタックへの理解が求められ、ユーザーの端末上で原因を絞り込むのに時間がかかりがち。

上記のような状況にあるチームのために PageSpy を提供しています。

使い方

データを自社で保持しつつセルフホストを簡単にするため、すぐ使える複数のデプロイ手段を用意しています。環境に合わせて選んでください。

オプション 1: Node.js でデプロイ

ビデオチュートリアル:

yarn global add @huolala-tech/page-spy-api@latest

# npm を使用する場合

npm install -g @huolala-tech/page-spy-api@latest

インストール後、ターミナルで page-spy-api を実行してサービスを起動します。起動できたらブラウザで http://localhost:6752 を開きます。ローカルで確認したら、同じ構成をサーバーへデプロイできます。

オプション 2: Docker でデプロイ

ビデオチュートリアル:

docker run -d --restart=always -v ./log:/app/log -v ./data:/app/data -p 6752:6752 --name="pageSpy" ghcr.io/huolalatech/page-spy-web:latest

コンテナが動いたらブラウザで http://localhost:6752 を開きます。ローカルで確認したら、同じ構成をサーバーへデプロイできます。

コントリビューション

詳しくは Contributing を参照してください。

FAQ

FAQ を参照してください。