Repolode
ChuckerTeam

ChuckerTeam/chucker

CharlesのようにOkHttpのリクエストとレスポンスを記録し、アプリ内で確認できるAndroid向けHTTPインスペクター。

代替できる製品:Charles Proxy

スター
4,588
フォーク
468
未解決の Issue
83
最終コミット
16 日前

これは何?

Chuckerは、Androidアプリが送信するHTTP(S)通信を調査するためのライブラリです。OkHttpのInterceptorとして組み込み、各リクエストとレスポンスをアプリ内に保存し、その内容を閲覧・検索・共有できるUIをアプリ内に提供します。端末上で動作するため、デスクトッププロキシの設定は不要です。

記録中は、進行中のHTTP通信の概要を通知に表示し、通知をタップするとChuckerのUIが開きます。アプリ側で通知を非表示にし、独自の画面からUIを開くこともできます。保存期間、最大ボディ長、機密ヘッダーのマスキング、alwaysReadResponseBody、ProtobufやThriftなどのバイナリ形式向けカスタムボディデコーダーを設定できます。

release variantにはno-op artifactが含まれるため、本番ビルドにChuckerのコードは入りません。このプロジェクトはChuckのフォークで、保存データに認証情報やボディが含まれる可能性があるため、開発用途を想定しています。

主な機能

  • 01OkHttpのリクエストとレスポンスをインターセプトし、アプリ内に保存します。
  • 02ボディテキストの検索とハイライトに対応したアプリ内UIを提供します。
  • 03HTTPレスポンス内の画像を表示します。
  • 04バイナリ形式向けのカスタムボディデコーダーに対応します。
  • 05機密ヘッダーをマスキングし、保存するボディの長さを制限します。
  • 06release buildにChuckerのコードが含まれないよう、no-op artifactを提供します。

ユースケース

  • 開発中にAndroidアプリが行うAPI呼び出しをデバッグする。
  • プロキシを使わず、実機上でRetrofitまたはOkHttpの通信を調査する。
  • バグ報告のため、キャプチャしたリクエストとレスポンスのデータをチームメンバーと共有する。

クイックスタート

  1. 1

    Androidアプリモジュールのbuild.gradleにdebugライブラリの依存関係を追加します

    debugImplementation "com.github.chuckerteam.chucker:library:4.2.0"
  2. 2

    releaseビルド用にno-opライブラリの依存関係を追加します

    releaseImplementation "com.github.chuckerteam.chucker:library-no-op:4.2.0"
  3. 3

    OkHttpクライアントビルダーにChuckerInterceptorを追加します

使う前に知っておきたいこと

  • 開発用途専用です。保存されたデータには機密性の高いヘッダーや本文が含まれる場合があります。
  • OkHttpが必要です。また、Android API 21以上が必要で、21未満のバージョンはサポートされていません。

収録されている特集

トピック

よくある質問

chucker とは?
CharlesのようにOkHttpのリクエストとレスポンスを記録し、アプリ内で確認できるAndroid向けHTTPインスペクター。 Chuckerは、Androidアプリが送信するHTTP(S)通信を調査するためのライブラリです。OkHttpのInterceptorとして組み込み、各リクエストとレスポンスをアプリ内に保存し、その内容を閲覧・検索・共有できるUIをアプリ内に提供します。端末上で動作するため、デスクトッププロキシの設定は不要です。
chucker は無料で使えますか?ライセンスは?
chucker は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
chucker は今もメンテナンスされていますか?
活発にメンテナンス中。chucker の最終コミットは 2026年10月22日 です。
chucker は何に使えますか?
開発中にAndroidアプリが行うAPI呼び出しをデバッグする。 プロキシを使わず、実機上でRetrofitまたはOkHttpの通信を調査する。 バグ報告のため、キャプチャしたリクエストとレスポンスのデータをチームメンバーと共有する。
chucker のインストール方法は?
Androidアプリモジュールのbuild.gradleにdebugライブラリの依存関係を追加します: debugImplementation "com.github.chuckerteam.chucker:library:4.2.0" releaseビルド用にno-opライブラリの依存関係を追加します: releaseImplementation "com.github.chuckerteam.chucker:library-no-op:4.2.0" OkHttpクライアントビルダーにChuckerInterceptorを追加します
chucker はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/ChuckerTeam/chucker

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト