stetho README

The project's README from github.com/facebook/stetho. As one markdown file: README.md.

Stetho Build Status

Stetho is a sophisticated debug bridge for Android applications. When enabled, developers have access to the Chrome Developer Tools feature natively part of the Chrome desktop browser. Developers can also choose to enable the optional dumpapp tool which offers a powerful command-line interface to application internals.

Once you complete the set-up instructions below, just start your app and point your laptop browser to chrome://inspect. Click the "Inspect" button to begin.

Set-up

Download

Download the latest JARs or grab via Gradle:

implementation 'com.facebook.stetho:stetho:1.6.0'

or Maven:

<dependency>
  <groupId>com.facebook.stetho</groupId>
  <artifactId>stetho</artifactId>
  <version>1.6.0</version>
</dependency>

Only the main stetho dependency is strictly required; however, you may also wish to use one of the network helpers:

implementation 'com.facebook.stetho:stetho-okhttp3:1.6.0'

or:

implementation 'com.facebook.stetho:stetho-urlconnection:1.6.0'

You can also enable a JavaScript console with:

implementation 'com.facebook.stetho:stetho-js-rhino:1.6.0'

For more details on how to customize the JavaScript runtime see stetho-js-rhino.

Putting it together

Integrating with Stetho is intended to be seamless and straightforward for most existing Android applications. There is a simple initialization step which occurs in your Application class:

public class MyApplication extends Application {
  public void onCreate() {
    super.onCreate();
    Stetho.initializeWithDefaults(this);
  }
}

Also ensure that your MyApplication Java class is registered in your AndroidManifest.xml file, otherwise you will not see an "Inspect" button in chrome://inspect/#devices :

<manifest
        xmlns:android="http://schemas.android.com/apk/res/android"
        ...>
        <application
                android:name="MyApplication"
                ...>
         </application>
</manifest>

This brings up most of the default configuration but does not enable some additional hooks (most notably, network inspection). See below for specific details on individual subsystems.

Enable network inspection

If you are using the popular OkHttp library at the 3.x release, you can use the Interceptors system to automatically hook into your existing stack. This is currently the simplest and most straightforward way to enable network inspection:

new OkHttpClient.Builder()
    .addNetworkInterceptor(new StethoInterceptor())
    .build()

Note that okhttp 2.x will work as well, but with slightly different syntax and you must use the stetho-okhttp artifact (not stetho-okhttp3).

As interceptors can modify the request and response, add the Stetho interceptor after all others to get an accurate view of the network traffic.

If you are using HttpURLConnection, you can use StethoURLConnectionManager to assist with integration though you should be aware that there are some caveats with this approach. In particular, you must explicitly add Accept-Encoding: gzip to the request headers and manually handle compressed responses in order for Stetho to report compressed payload sizes.

See the stetho-sample project for more details.

Going further

Custom dumpapp plugins

Custom plugins are the preferred means of extending the dumpapp system and can be added easily during configuration. Simply replace your configuration step as such:

Stetho.initialize(Stetho.newInitializerBuilder(context)
    .enableDumpapp(new DumperPluginsProvider() {
      @Override
      public Iterable<DumperPlugin> get() {
        return new Stetho.DefaultDumperPluginsBuilder(context)
            .provide(new MyDumperPlugin())
            .finish();
      }
    })
    .enableWebKitInspector(Stetho.defaultInspectorModulesProvider(context))
    .build())

See the stetho-sample project for more details.

Improve Stetho!

See the CONTRIBUTING.md file for how to help out.

License

Stetho is MIT-licensed. See LICENSE file for more details.

stetho (facebook/stetho)

Searching Database…

12.6K ·GitHub
Stetho
archived
Что это такое?Stetho — это отладочный мост для Android-приложений, который позволяет просматривать работающее приложение с помощью инструментов разработчика Chrome, а также необязательный инструмент командной строки dumpapp для изучения внутренних компонентов приложения.
Это библиотека, которую я добавляю в приложение, или отдельный инструмент?Это Java-библиотека, которую вы встраиваете в Android-приложение через Gradle или Maven; после подключения работающее приложение просматривается в браузере Chrome на вашем ноутбуке.
Как добавить это в мой Android-проект?Добавьте зависимость stetho через Gradle или Maven, вызовите шаг инициализации в классе Application, зарегистрируйте этот класс в AndroidManifest.xml, затем запустите приложение, откройте chrome://inspect на ноутбуке и нажмите Inspect.
Нужны ли мне дополнительные библиотеки для просмотра сетевых запросов?Нужна только основная зависимость stetho; для просмотра сетевых запросов дополнительно понадобится один из сетевых вспомогательных артефактов, например stetho-okhttp3 для OkHttp 3.x (или stetho-okhttp для 2.x), либо можно использовать StethoURLConnectionManager с HttpURLConnection.
Есть ли подводные камни при подключении просмотра сетевых запросов?При работе с HttpURLConnection нужно явно добавить заголовок Accept-Encoding: gzip и самостоятельно обрабатывать сжатые ответы, чтобы Stetho правильно показывал размеры данных; при использовании OkHttp важен порядок перехватчиков.
Для кого это и поддерживается ли это до сих пор?Это для Android-разработчиков, которые хотят отлаживать своё приложение через браузер; репозиторий архивирован, поэтому он больше не поддерживается активно.
Можно ли мне расширить CLI dumpapp своими командами?Да, собственные плагины dumpapp можно легко добавить на этапе настройки Stetho, чтобы расширить интерфейс командной строки своими возможностями.
Можно ли мне настроить встроенную JavaScript-консоль?Да, Stetho поддерживает включение необязательной JavaScript-консоли, а среду выполнения JS можно дополнительно настроить через модуль stetho-js-rhino.
Поддерживаются ли более старые версии OkHttp?Да, поддерживаются OkHttp 2.x и 3.x для автоматического просмотра сетевых запросов, но для 2.x требуется отдельный артефакт stetho-okhttp и немного другой синтаксис, чем у stetho-okhttp3.
What are similar projects?Apktool, android-async-http, chrome-devtools-mcp, ndb, web-source-inspect, AndroidSwipeLayout, proxypin, MVPArms
Which topics is it in?gradle, chrome, devtools, debugging, java, networking, command-line-tool, android, library, developer-tools, mit
Creator
facebook
Size
2.3 MB
Stars
12.6K
Updated
CommitOct 26Releasev1.6.0Mar 20
Age
11y
Commits · 90 Days