Stetho: New Android Debugging Platform (Droidcon MTL 2015)

Stetho is a powerful debug bridge that connects the popular Chrome DevTools UI to native Android apps. With a few lines of simple initialization code most users are up and running with network traffic visualizations, a SQLite console, and SharedPreferences support. We'll also be looking at a brand new feature still in the works which will let developers inspect and manipulate the View hierarchy from within the DevTools UI.

To help developers get started, we'll talk through common integration issues and how to go beyond the DevTools UI with the dumpapp tool.

(Video to be uploaded soon)

Transcript

1. Stetho Stetho New Android debugging platform New Android debugging platform https://github.com/facebook/stetho Josh Guilfoyle @devjasta Austin Longino @longinoa
3. public class MyDebugApplication extends MyApplication { @Override public void onCreate() { Stetho.initialize( Stetho.newInitializerBuilder(context) .enableDumpapp( Stetho.defaultDumperPluginsProvider(context)) .enableWebKitInspector( Stetho.defaultInspectorModulesProvider(context)) .build()); } } Initialization
4. Initialization (cont.) OkHttpClient client = new OkHttpClient(); client.networkInterceptors().add(new StethoInterceptor());
5. Stetho In Action
6. Known to work with: * - Some assembly required. Picasso, Fresco, Glide, ... Retrofit Ion okhttp HttpURLConnection* AndroidAsync HttpClient* Volley
7. HttpURLConnection stethoMgr = new StethoURLConnectionManager(requestName); conn = url.openConnection(); stethoMgr.preConnect(conn, ...); try { conn.connect(); stethoMgr.postConnect(); } catch (IOException e) { stethoMgr.httpExchangedFailed(e); throw e; } InputStream response = stethoMgr.interpretResponseStream( conn.getInputStream()); // read response...
8. ▪ Adds ~60KB to an APK ▪ Initializes in ~1ms ▪ Safe in release builds, but not required Overhead
9. Debug only builds dependencies { debugCompile 'com.facebook.stetho:stetho:1.1.0' compile 'com.facebook.stetho:stetho-urlconnection:1.1.0' // or debugCompile '...stetho-okhttp...' }
10. Debug only builds (cont.) <manifest ...> <application tools:replace="android:name" android:name=".MyDebugApplication" /> </manifest>
11. Now the fun stuf
12. dumpapp ▪ Think many main(String[]) methods ▪ Built like a true CLI ▪ Simplicity as a feature
13. Example: crash $ dumpapp crash kill $ dumpapp crash throw
14. Example: hprof $ ./scripts/hprof_gen.sh
15. Example: custom plugin
16. Q & A https://github.com/facebook/stetho Josh Guilfoyle @devjasta Austin Longino @longinoa