/ HTTP

A simple in-app HTTP inspector for Android OkHttp clients

A simple in-app HTTP inspector for Android OkHttp clients

Gander

Gander is a simple in-app HTTP inspector for Android OkHttp clients. Gander intercepts and persists all HTTP requests and responses inside your application, and provides a UI for inspecting their content.

Gander

Features

  1. Apps using Gander will display a notification showing a summary of ongoing HTTP activity. Tapping on the notification launches the full Gander UI. Apps can optionally suppress the notification, and launch the Gander UI directly from within their own interface. HTTP interactions and their contents can be exported via a share intent.
  2. Search HTTP Activity and also request and response
  3. The main Gander activity is launched in its own task, allowing it to be displayed alongside the host app UI using Android 7.x multi-window support.

multiwindow

Gander requires Android 4.1+ and OkHttp 3.x.

Warning: The data generated and stored when using this interceptor may contain sensitive information such as Authorization or Cookie headers, and the contents of request and response bodies. It is intended for use during development, and not in release builds or other production deployments.

Setup

Download

Based on your IDE you can import library in one of the following ways

Gradle:

Add the dependency in your build.gradle file. Add it alongside the no-op variant to isolate Gander from release builds as follows:

debugCompile 'com.ashokvarma.android:gander:1.3.3'
releaseCompile 'com.ashokvarma.android:gander-no-op:1.3.3'

If you want this in library in both release and compile, then try this :

compile 'com.ashokvarma.android:gander:1.3.3'
or grab via Maven:
<dependency>
  <groupId>com.ashokvarma.android</groupId>
  <artifactId>gander</artifactId>
  <version>1.3.3</version>
  <type>pom</type>
</dependency>

Usage

In your application code, create an instance of GanderInterceptor (you'll need to provide it with a Context, because Android) and add it as an interceptor when building your OkHttp client:

OkHttpClient client = new OkHttpClient.Builder()
  .addInterceptor(new GanderInterceptor(context, true))
  .build();

That's it! Gander will now record all HTTP interactions made by your OkHttp client.
You can optionally disable the notification by passing false in constructor new GanderInterceptor(context, false)

Other Features

Launch the Gander UI directly within your app with the intent from Gander.getLaunchIntent().

startActivity(Gander.getLaunchIntent(this));

Add app shortcut to your app

Gander.addAppShortcut(this);

GitHub