Stetho — bu nima, Android-ni Chrome DevTools orqali debug qilish

Stetho nima va u qanday ishlaydi

Stetho — Android ilovasining ichida lokal WebSocket serverini ishga tushiradigan Java kutubxonasi. Chrome DevTools bu serverga adb porti orqali ulanadi va ilovaning ichki komponentlariga kirish oladi: ma'lumotlar bazalari, tarmoq so'rovlari, preferences va view iyerarxiyasi. Barcha aloqa Chrome DevTools Protocol protokoli orqali ketadi, bu qo'shimcha dastur o'rnatmasdan brauzerning standart vositalaridan foydalanish imkonini beradi.

Arxitektura va komponentlar

Kutubxona modullardan iborat: stetho (yadro), stetho-okhttp (OkHttp orqali trafikni ushlash), stetho-urlconnection (HttpURLConnection orqali ushlash) va stetho-js-rhino (JavaScript plaginlarini qo'llab-quvvatlash). Yadro UNIX soketini ochadi, unga Chrome adb forward orqali ulanadi. Har bir inspektor Stetho-ni ishga tushirishda ro'yxatdan o'tadigan alohida plagin sifatida amalga oshirilgan.

Talablar va cheklovlar

Stetho Android 4.4+ (API 19) qo'llab-quvvatlaydi va faqat debug qurilmalarida ishlaydi. Android 11+ bo'lgan qurilmalarda manifestda aniq INTERNET ruxsati talab qilinadi. Kutubxona 2020-yildan beri Facebook tomonidan rasman qo'llab-quvvatlanmaydi, ammo kod ochiq qoladi va legacy loyihalarida ishlatiladi. Yangi loyihalar uchun Google Android Studio Profiler va Network Inspector-ni tavsiya qiladi.

Android loyihasida Stetho-ni ulash va sozlash

Ulash debugImplementation bayrog'i bilan Gradle bog'liqligi orqali bajariladi, shunda Stetho faqat debug qurilmasida ishlaydi. Ishga tushirish Application.onCreate() metodida bitta Stetho.initializeWithDefaults(this) chaqiruvi bilan amalga oshiriladi. Network Inspector uchun OkHttp bilan Interceptor orqali integratsiya talab qilinadi.

// build.gradle (ilova) — Stetho-ni ulash
dependencies {
    debugImplementation 'com.facebook.stetho:stetho:1.6.0'
    debugImplementation 'com.facebook.stetho:stetho-okhttp3:1.6.0'
}

// Application sinfida ishga tushirish
public class App extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        Stetho.initializeWithDefaults(this);
    }
}

Network Interceptor-ni sozlash

OkHttp orqali tarmoq so'rovlarini ushlash uchun StethoInterceptor-ni interceptors zanjiriga qo'shing. Stetho avtomatik ravishda URL, so'rov va javob sarlavhalari, holat kodi va bajarilish vaqtini qayd qiladi. Ma'lumotlar qurilmaga chrome://inspect orqali ulangandan so'ng Chrome DevTools-dagi Network yorlig'ida ko'rsatiladi.

Network Inspector: HTTP trafigini ushlash

Stetho-nun Network Inspector-i ilovaning barcha HTTP so'rovlarini xronologik tartibda ko'rsatadi. Har bir so'rov uchun mavjud: metod, URL, holat kodi, so'rov va javob sarlavhalari, so'rov va javob tanasi (shu jumladan JSON va ikkilik ma'lumotlar). Preview yorlig'i javob tanasini formatlangan ko'rinishda ko'rsatadi.

So'rovlarni filtrlash va qidirish

Chrome DevTools so'rovlarni turi (XHR, JS, CSS, Doc), holat kodi va domeni bo'yicha filtrlashni qo'llab-quvvatlaydi. Qidiruv maydoni URL va tarkib bo'yicha filtrlaydi. Mobil ishlab chiqish uchun so'rovlarni API domeni bo'yicha guruhlash va ilova ekranlarini test qilishda chaqiruvlar ketma-ketligini tekshirish foydali.

// Stetho interceptor bilan OkHttp klient
OkHttpClient client = new OkHttpClient.Builder()
    .addNetworkInterceptor(new StethoInterceptor())
    .build();

// So'rovni bajarish
Request request = new Request.Builder()
    .url("https://api.example.com/users")
    .build();
client.newCall(request).enqueue(callback);

Database Inspector: SQLite bilan ishlash

Stetho-nun Database Inspector-i Chrome DevTools orqali ilovaning SQLite ma'lumotlar bazalariga ulanadi. Resources → Web SQL yorlig'ida barcha ochiq ma'lumotlar bazalari, ularning jadvallari va tarkibi ko'rsatiladi. Jadval tuzilmalarini, indekslarni ko'rish va ixtiyoriy SQL so'rovlarini bajarish mumkin.

DevTools orqali SQL so'rovlarini bajarish

Chrome DevTools konsolida to'g'ridan-to'g'ri ilova bazasiga SQL so'rovlarini bajarish mumkin: SELECT, INSERT, UPDATE, DELETE. Bu testdan oldin ma'lumotlarni tozalash, migratsiyalarning to'g'riligini tekshirish va ilovani qayta qurmasdan noto'g'ri yozuvlarni qo'lda tuzatish uchun foydali. Barcha o'zgarishlar darhol qurilmada ko'rinadi.

Dumpapp va maxsus plaginlar

Dumpapp — adb orqali maxsus buyruqlarni bajarish imkonini beruvchi Stetho shell interfeysi. Dumpapp plaginlari Stetho ishga tushirilganda ro'yxatdan o'tadi va ilovaning istalgan holatini eksport qilishi mumkin: keshlash, sozlamalar, DI konteyner holati. Buyruqlar adb forward tcp:12345 localabstract:stetho_dumpapp kabi bajariladi.

Maxsus Dumpapp plaginini yaratish

Plagin DumperContext interfeysini amalga oshiradi va maxsus InspectorModules bilan Stetho.initialize orqali ro'yxatdan o'tadi. Quyidagi misol SharedPreferences dumpi uchun plagin ko'rsatadi: ma'lumotlar JSON-ga seriyalanadi va adb buyrug'i orqali terminalda ko'rsatiladi.

// SharedPreferences uchun maxsus Dumpapp plagin
public class PrefsDumper implements DumperContext {
    @Override
    public String getName() {
        return "prefs";
    }
    @Override
    public void dump(DumperContext ctx) {
        SharedPreferences sp = ctx.getContext()
            .getSharedPreferences("app_prefs", Context.MODE_PRIVATE);
        ctx.getStdout().println(sp.getAll().toString());
    }
}

Stetho va Android Studio Inspector: taqqoslash

Android Studio o'rnatilgan profillash vositalarini taqdim etadi: Network Profiler, Database Inspector va View Inspector, ular Android Studio 4.1+ da paydo bo'lgan. Stetho bu vositalar joriy etilgunga qadar mashhur edi va OkHttp ishlatadigan hamda Chrome DevTools bilan integratsiya talab qiladigan loyihalar uchun dolzarb bo'lib qolmoqda.

Qachon Stetho-ni tanlash kerak

Stetho OkHttp allaqachon ishlatiladigan va jamoa Chrome DevTools-ga o'rganib qolgan legacy loyihalarida o'zini oqlaydi. Yangi loyihalar uchun Android Studio Inspector debug ssenariylarining ko'pchiligini qamrab oladi. Biroq Chrome DevTools hali ham SQLite so'rovlari uchun qulayroq: SQL avtoto'ldirishli o'rnatilgan konsol IDE-dagi ketma-ket bosishlardan tezroq.

View Hierarchy-ni Stetho orqali tekshirish

View Hierarchy Stetho-da Chrome DevTools-nun Elements yorlig'ida DOM-ga o'xshash daraxt sifatida ko'rsatiladi. Har bir View atributlari bilan HTML elementi sifatida taqdim etiladi: id, layout_width, layout_height, padding, margin, visibility va matn. Daraxtdagi o'zgarishlar ekran burilganda yoki UI yangilanganda real vaqtda sinxronlashtiriladi.

Xususiyatlarni ko'rish va o'zgartirish

Daraxtda elementni tanlab, uning xususiyatlarini Styles panelida ko'rish mumkin — veb-sahifalarni tekshirishga o'xshash. Stetho hisoblangan o'lchamlar, oralqlar, fon rangi va holatni (pressed, focused, enabled) ko'rsatadi. DevTools-da ba'zi xususiyatlarni o'zgartirish darhol ilovaga qo'llaniladi, bu qayta qurmasdan UI parametrlarini tanlashni tezlashtiradi.

View Inspector orqali xotira oqishini qidirish

Stetho View bilan bog'liq xotira oqishini aniqlashga yordam beradi: agar Activity finish() dan keyin yo'q qilinmasa, uning ildiz View-i daraxtda qoladi. Elements yorlig'ini muntazam tekshirish orqali fantom Activity-larni ko'rish va oqish manbasini topish mumkin — odatda bu Context-ga statik havolalar yoki yopilmagan dialoglar.

Amaliy debug usullari

Stetho serverga yuborishdan oldin JSON seriyalashni tekshirish uchun samarali. Network Inspector-ni oching, so'rovni toping va ma'lumotlar tuzilishi va maydonlarning to'g'riligini tekshirish uchun tanani Raw rejimida ko'ring.

SQLiteOpenHelper-ni debug qilish

Stetho SQLiteOpenHelper orqali yaratilgan barcha bazalarni ko'rsatadi. Agar baza Chrome DevTools-da ko'rinmasa — getWritableDatabase() ilova kodida kamida bir marta chaqirilganini tekshiring.

OkHttp-da Interceptor tartibi

Stetho o'zgartirilgan so'rovlarni ko'rish uchun OkHttp zanjirida oxirgi interceptor bo'lishi kerak. To'g'ri tartib: AuthInterceptor first, keyin LoggingInterceptor, so'ng oxirgi StethoInterceptor.

Stetho bilan amaliy debug usullari

Stetho serverga yuborishdan oldin JSON seriyalashning to'g'riligini tekshirish uchun samarali. Network Inspector-ni oching, so'rovni toping va maydonlar tuzilishi va ma'lumot turlarining to'g'riligiga ishonch hosil qilish uchun so'rov tanasini Raw rejimida ko'ring.

SQLiteOpenHelper va ContentProvider-ni debug qilish

Stetho SQLiteOpenHelper orqali yaratilgan barcha ma'lumotlar bazalarini ko'rsatadi. Agar baza Chrome DevTools-da ko'rinmasa — getWritableDatabase() metodi ilova kodida kamida bir marta chaqirilganini tekshiring. Migratsiyalar uchun SQL konsoli orqali ALTER TABLE bajaring va natijani SELECT so'rovi bilan tekshiring.

OkHttp zanjirida Interceptor tartibi

Stetho yakuniy o'zgartirilgan so'rovlarni ko'rsatish uchun OkHttp zanjirida oxirgi interceptor bo'lishi kerak. To'g'ri ketma-ketlik: AuthInterceptor birinchi, keyin LoggingInterceptor, to'g'ri qayd qilish uchun so'ng oxirgi StethoInterceptor.