NetworkCallback: bu nima, qo'llash va Androidda tarmoqni boshqarish

NetworkCallback nima?

NetworkCallback — android.net paketidan olingan, Android SDK tarkibiga kiruvchi abstrakt sinf. U ConnectivityManager tizim xizmati orqali tarmoq ulanish holatidagi o'zgarishlar haqida bildirishnomalar olish uchun mo'ljallangan.

NetworkCallback paydo bo'lgunga qadar dasturchilar tarmoqni kuzatish uchun BroadcastReceiver eshittirish qabul qilgichlaridan foydalanardilar. Bunday yondashuv manifestda doimiy ro'yxatdan o'tkazishni talab qilar, kechikish bilan ishlar va ulanish xususiyatlari haqida batafsil ma'lumot bermas edi. Android 5.0 (API 21) NetworkCallback-ni yanada moslashuvchan va samarali alternativ sifatida taqdim etdi.

Callback asinxron ishlaydi: ilova ConnectivityManager orqali hodisalarga obuna bo'ladi va tarmoq holati o'zgarganda tizim callback metodlarini chaqiradi. Bu tarmoq holatini davriy so'roq qilish (polling) zaruriyatini bartaraf etib, batareya va protsessor resurslarini tejaydi.

Android-da callback qanday ishlaydi

ConnectivityManager qurilmaning barcha tarmoq interfeyslarini boshqaradi — Wi-Fi, mobil ma'lumotlar, Ethernet, VPN. Ushbu interfeyslardan birortasi o'zgarganda tizim Network obyektini yaratadi va uni ro'yxatdan o'tkazilgan callback-ning tegishli metodiga uzatadi. Har bir Network qayta ulanishda o'zgaradigan noyob identifikatorga ega.

Callback muayyan tarmoq turiga bog'liq emas — bir vaqtning o'zida barcha mavjud interfeyslarni kuzatishi mumkin. Ulanish turlarini filtrlash uchun talab qilinadigan transport protokollari (Wi-Fi, mobil ma'lumotlar, Ethernet) va tarmoq imkoniyatlari ko'rsatilgan NetworkRequest sinfidan foydalaniladi.

NetworkCallback-ni ilovada qanday ro'yxatdan o'tkazish

NetworkCallback-ni ro'yxatdan o'tkazish ConnectivityManager.registerNetworkCallback metodi orqali amalga oshiriladi. Birinchi parametr sifatida tarmoq talablarini tavsiflovchi NetworkRequest.Builder, ikkinchi sifatida callback namunasi uzatiladi. Ishlash uchun manifestda ACCESS_NETWORK_STATE ruxsati talab qilinadi.

class NetworkMonitor(private val context: Context) {

    private val connectivityManager =
        context.getSystemService(Context.CONNECTIVITY_SERVICE)
            as ConnectivityManager

    private val callback =
        object : ConnectivityManager.NetworkCallback() {

        override fun onAvailable(network: Network) {
            Log.d("Network", "Mavjud: ${network}")
        }

        override fun onLost(network: Network) {
            Log.d("Network", "Yo'qolgan: ${network}")
        }
    }

    fun register() {
        connectivityManager.registerNetworkCallback(
            NetworkRequest.Builder().build(), callback
        )
    }

    fun unregister() {
        connectivityManager.unregisterNetworkCallback(callback)
    }
}

Activity va Fragment da ro'yxatdan o'tkazish

Tavsiya etiladiki, NetworkCallback ilova oldingi planda bo'lganda ro'yxatdan o'tkazilsin va fonda ketganda bekor qilinsin. Activity da callback ning hayot aylanishini boshqarish uchun onStart va onStop dan foydalanish qulay. Fragment da — onResume va onPause.

Ro'yxatdan o'tkazishni boshqarishni soddalashtirish uchun Lifecycle-aware komponentlaridan foydalanish mumkin. AndroidX Lifecycle kutubxonasi hayot aylanishi holati o'zgarganda avtomatik ravishda callback-ni ro'yxatdan o'tkazadigan va bekor qiladigan maxsus LifecycleObserver yaratish imkonini beradi.

Xizmatda ro'yxatdan o'tkazish

Fon vazifalari uchun ro'yxatdan o'tkazish Service yoki WorkManager da amalga oshiriladi. Shuni hisobga olish kerakki, Android 8+ da fon xizmatlari ishga tushirishda cheklovlarga ega. NetworkType bilan WorkManager — muayyan tarmoq holatida vazifalarni bajarish uchun ishonchli usul, chunki u moslik API bilan integratsiyalangan va Doze rejimini hisobga oladi.

NetworkCallback-ning asosiy metodlari

NetworkCallback tarmoq holati o'zgarganda chaqiriladigan metodlar to'plamini taqdim etadi. Barcha metodlarni qayta belgilash shart emas — faqat ilovaning muayyan vazifasi uchun zarur bo'lganlarini amalga oshirish kifoya. onAvailable va onLost asosiy ulanish monitoringi uchun minimal talab qilinadi.

onCapabilitiesChanged metodi

Bu metod tarmoq haqida batafsil ma'lumot olish uchun kalit hisoblanadi. NetworkCapabilities parametri bayroqlarni o'z ichiga oladi: NET_CAPABILITY_INTERNET — internetga kirish mavjudligi, NET_CAPABILITY_NOT_METERED — cheklanmagan ulanish, NET_CAPABILITY_NOT_ROAMING — rouming yo'qligi. Shuningdek signal kechikishi va o'tkazish qobiliyatini bilish mumkin.

Captive portallar (captive portals) — alohida holat: jamoat Wi-Fi tarmog'iga portal orqali ulanganda onCapabilitiesChanged metodi darhol INTERNET ko'rsatmaydi. Avval tarmoq mavjud, lekin internetsiz — brauzer orqali avtorizatsiya talab qilinadi. Dasturchi ilova mantiqida bu kechikishni hisobga olishi kerak.

onBlockedStatusChanged metodi

Tizim ilova uchun tarmoq trafigini bloklaganda chaqiriladi — masalan, ma'lumotlarni tejash rejimi yoki fon ma'lumotlarini cheklashda. onBlockedStatusChanged ilovaga uning tarmoq so'rovlari vaqtincha taqiqlanganligini bilishga va mahalliy ishlov berishga o'tishga imkon beradi.

NetworkCallback-ni qo'llash misollari

Internetga kirishni kuzatish va captive portallarni boshqarish uchun NetworkCallback-ni amaliy qo'llashni ko'rib chiqamiz. Quyidagi misolda NET_CAPABILITY_INTERNET tekshiruvi va Google serveriga HTTP so'rovi orqali ulanishni tasdiqlash ko'rsatilgan.

val networkCallback = object : ConnectivityManager.NetworkCallback() {

    override fun onCapabilitiesChanged(
        network: Network,
        caps: NetworkCapabilities
    ) {
        val hasInternet = caps.hasCapability(
            NetworkCapabilities.NET_CAPABILITY_INTERNET
        )
        val isMetered = caps.hasCapability(
            NetworkCapabilities.NET_CAPABILITY_NOT_METERED
        ).not()

        when {
            hasInternet && isMetered ->
                Log.d("Network", "Mobil ma'lumot ulandi")
            hasInternet ->
                Log.d("Network", "Wi-Fi ulandi")
            else ->
                Log.d("Network", "Internetga kirish yo'q")
        }
    }

    override fun onLost(network: Network) {
        Log.d("Network", "Ulanish yo'qoldi: ${network}")
        // Tarmoq so'rovlarini to'xtatish
    }
}

Captive portallarni boshqarish

Avtorizatsiya talab qiladigan jamoat tarmog'iga (kafe, aeroport) ulanganda tizim avval onAvailable haqida xabar beradi, lekin onCapabilitiesChanged INTERNET ko'rsatmasligi mumkin. Bunday hollarda barqaror endpoint-ga, masalan https://www.google.com/generate_204 manziliga HTTP so'rovi orqali qo'shimcha tekshirish talab qilinadi.

Agar so'rov 204 kodini qaytarsa — internet mavjud. Agar qayta yo'naltirish (301, 302, 307) bo'lsa — brauzer orqali avtorizatsiya talab qilinadi. Bu holda portaldan autentifikatsiyadan o'tish uchun WebView yoki Intent-ni qayta yo'naltirish URL-iga ochish mumkin.

fun Context.validateInternet(network: Network) {
    CoroutineScope(Dispatchers.IO).launch {
        try {
            val url = URL("https://www.google.com/generate_204")
            val connection =
                network.openConnection(url) as HttpURLConnection
            connection.instanceFollowRedirects = false
            connection.connect()
            when (connection.responseCode) {
                HttpURLConnection.HTTP_NO_CONTENT ->
                    Log.d("Network", "Internet mavjud")
                in HttpURLConnection.HTTP_MOVED_PERM
                        ..HttpURLConnection.HTTP_TEMP_REDIRECT ->
                    Log.d("Network", "Captive portal aniqlandi")
            }
            connection.disconnect()
        } catch (e: Exception) {
            Log.e("Network", "Tasdiqlash muvaffaqiyatsiz: ${e.message}")
        }
    }
}

Tarmoq monitoringining boshqa usullaridan farqlari

NetworkCallback dan oldin tarmoq monitoringining asosiy usuli android.net.conn.CONNECTIVITY_CHANGE filtri bilan BroadcastReceiver edi. Bu yondashuv muhim kamchiliklarga ega edi: bir necha soniya kechikish, interfeys turi haqida ma'lumot yo'qligi, qurilmaning doimiy uyg'onishi tufayli yuqori energiya sarfi.

Zamonaviy alternativ — NetworkCallback bilan birgalikda LiveData yoki StateFlow. Naqsh callback-ni reaktiv oqimga o'rashdan iborat bo'lib, u avtomatik ravishda UI-ga holat o'zgarishi haqida xabar beradi. Masalan, NetworkStatus tipidagi MutableStateFlow callback metodlari ichida yangilanadi, ViewCollector esa o'zgarishlarga obuna bo'ladi.

Fon rejimi bilan ishlash

Android 10 dan boshlab fon cheklovlari darajasi qattiqlashtirilgan va ilova fonda bo'lganda NetworkCallback chaqirilmasligi mumkin. Kritik muhim vazifalar uchun — masalan, tarmoq paydo bo'lganda ma'lumotlarni yuklash — NetworkType.CONNECTED cheklovi bilan WorkManager dan foydalaning. WorkManager tarmoq shartlari bajarilganda vazifaning bajarilishini kafolatlaydi.

Android 12+ da CONNECTIVITY_ACTION uchun BroadcastReceiver ning manifest ro'yxatdan o'tkazish cheklovi paydo bo'ldi. Dasturchilar NetworkCallback ga yoki WorkManager ga o'tishlari shart. Google Play siyosati 2022 yil avgustidan boshlab bu harakat uchun manifest ro'yxatdan o'tkazishni olib tashlashni talab qiladi.