NetworkCallback: nedir, uygulaması ve Android'de ağ yönetimi

NetworkCallback Nedir?

NetworkCallback, android.net paketinden gelen ve Android SDK'nın bir parçası olan soyut bir sınıftır. ConnectivityManager sistem hizmeti aracılığıyla ağ bağlantı durumu değişiklikleri hakkında bildirim almak üzere tasarlanmıştır.

NetworkCallback'ten önce, geliştiriciler ağ değişikliklerini izlemek için BroadcastReceiver kullanıyordu. Bu yaklaşım, manifest dosyasında sürekli kayıt gerektiriyor, gecikmeli çalışıyor ve bağlantı özellikleri hakkında ayrıntılı bilgi sağlamıyordu. Android 5.0 (API 21), NetworkCallback'i daha esnek ve performanslı bir alternatif olarak tanıttı.

Geri çağırma asenkron çalışır: uygulama ConnectivityManager aracılığıyla olaylara abone olur ve ağ durumu değiştiğinde sistem geri çağırma metotlarını çağırır. Bu, ağ durumunun periyodik olarak yoklanması ihtiyacını ortadan kaldırarak pil ve CPU kaynaklarından tasarruf sağlar.

Android'de geri çağırma nasıl çalışır

ConnectivityManager, cihazdaki tüm ağ arayüzlerini (Wi-Fi, mobil veri, Ethernet, VPN) yönetir. Bu arayüzlerden herhangi biri değiştiğinde, sistem bir Network nesnesi oluşturur ve bunu kayıtlı geri çağırmanın ilgili metoduna iletir. Her Network, yeniden bağlanmada değişen benzersiz bir tanımlayıcıya sahiptir.

Geri çağırma belirli bir ağ türüne bağlı değildir — tüm kullanılabilir arayüzleri aynı anda izleyebilir. Bağlantı türlerini filtrelemek için, gerekli taşıma protokollerini (Wi-Fi, hücresel veri, Ethernet) ve ağ yeteneklerini belirten NetworkRequest sınıfı kullanılır.

Uygulamanızda NetworkCallback Nasıl Kaydedilir

NetworkCallback kaydı, ConnectivityManager.registerNetworkCallback metodu aracılığıyla yapılır. İlk parametre, ağ gereksinimlerini tanımlayan bir NetworkRequest.Builder, ikincisi bir geri çağırma örneğidir. Manifest'te ACCESS_NETWORK_STATE izni gereklidir.

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", "Available: ${network}")
        }

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

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

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

Activity ve Fragment'te Kayıt

NetworkCallback'in uygulama ön plandayken kaydedilmesi ve arka plana geçerken iptal edilmesi önerilir. Activity'de, geri çağırma yaşam döngüsünü yönetmek için onStart ve onStop kullanın. Fragment'te, onResume ve onPause kullanın.

Kayıt yönetimini basitleştirmek için Lifecycle duyarlı bileşenler kullanabilirsiniz. AndroidX Lifecycle kütüphanesi, yaşam döngüsü durumu değiştiğinde geri çağırmayı otomatik olarak kaydeden ve iptal eden özel bir LifecycleObserver oluşturmanıza olanak tanır.

Service'te Kayıt

Arka plan görevleri için kayıt, Service veya WorkManager'da yapılır. Android 8+'da, arka plan hizmetlerinin başlatma kısıtlamaları olduğunu unutmayın. NetworkType ile WorkManager, belirli bir ağ durumu altında görevleri yürütmenin daha güvenilir bir yoludur, çünkü uyumluluk API'si ile entegredir ve Doze moduna saygı duyar.

NetworkCallback'in Temel Metotları

NetworkCallback, ağ durumu değiştiğinde çağrılan bir dizi metot sağlar. Tüm metotların geçersiz kılınması gerekmez — yalnızca uygulamanızın belirli görevi için gerekenleri uygulayın. onAvailable ve onLost, temel bağlantı izlemesi için minimum gereklidir.

onCapabilitiesChanged Metodu

Bu metot, ağ hakkında ayrıntılı bilgi almak için anahtardır. NetworkCapabilities parametresi şu bayrakları içerir: NET_CAPABILITY_INTERNET — internet erişimi mevcut, NET_CAPABILITY_NOT_METERED — sınırsız bağlantı, NET_CAPABILITY_NOT_ROAMING — dolaşım yok. Sinyal gecikmesi ve bant genişliği de öğrenilebilir.

Kablolu portallar özel bir durumdur: bir portal aracılığıyla halka açık Wi-Fi ağına bağlanırken, onCapabilitiesChanged metodu hemen INTERNET göstermez. Ağ başlangıçta kullanılabilir ancak internet olmadan — tarayıcı aracılığıyla yetkilendirme gereklidir. Geliştiricilerin uygulama mantığında bu gecikmeyi hesaba katması gerekir.

onBlockedStatusChanged Metodu

Sistem, uygulama için ağ trafiğini engellediğinde çağrılır — örneğin, veri tasarrufu modu etkinleştirildiğinde veya arka plan verileri kısıtlandığında. onBlockedStatusChanged, uygulamanın ağ isteklerinin geçici olarak yasaklandığını bilmesini ve yerel işlemeye geçmesini sağlar.

NetworkCallback Uygulama Örnekleri

İnternet erişimini izlemek ve kablolu portalları yönetmek için pratik bir NetworkCallback uygulamasına bakalım. Aşağıdaki örnek, NET_CAPABILITY_INTERNET kontrolünü ve Google sunucusuna HTTP isteği yoluyla bağlantı doğrulamasını göstermektedir.

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", "Mobile data connected")
            hasInternet ->
                Log.d("Network", "Wi-Fi connected")
            else ->
                Log.d("Network", "No internet access")
        }
    }

    override fun onLost(network: Network) {
        Log.d("Network", "Connection lost: ${network}")
        // Ağ isteklerini durdur
    }
}

Kablolu Portalları Yönetme

Yetkilendirme gerektiren halka açık bir ağa (kafe, havaalanı) bağlanırken, sistem önce onAvailable bildirir, ancak onCapabilitiesChanged INTERNET göstermeyebilir. Bu gibi durumlarda, https://www.google.com/generate_204 gibi kararlı bir uç noktaya HTTP isteği yoluyla ek doğrulama gereklidir.

İstek 204 kodunu döndürürse — internet mevcuttur. Yönlendirme varsa (301, 302, 307) — tarayıcı aracılığıyla yetkilendirme gereklidir. Bu durumda, portal kimlik doğrulamasını tamamlamak için yönlendirme URL'si ile bir WebView veya Intent açabilirsiniz.

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 is available")
                in HttpURLConnection.HTTP_MOVED_PERM
                        ..HttpURLConnection.HTTP_TEMP_REDIRECT ->
                    Log.d("Network", "Captive portal detected")
            }
            connection.disconnect()
        } catch (e: Exception) {
            Log.e("Network", "Validation failed: ${e.message}")
        }
    }
}

Diğer Ağ İzleme Yöntemlerinden Farkları

NetworkCallback'ten önce, ağ izlemenin birincil yöntemi android.net.conn.CONNECTIVITY_CHANGE filtresiyle BroadcastReceiver idi. Bu yaklaşımın önemli dezavantajları vardı: birkaç saniyelik gecikmeler, arayüz türü bilgisi eksikliği ve cihazın sürekli uyanması nedeniyle artan güç tüketimi.

Modern bir alternatif, LiveData veya StateFlow'un NetworkCallback ile birleştirilmesidir. Desen, geri çağırmayı, durum değişikliklerini otomatik olarak UI'ye bildiren reaktif bir akışa sarmayı içerir. Örneğin, NetworkStatus türünde bir MutableStateFlow, geri çağırma metotları içinde güncellenir ve bir ViewCollector değişikliklere abone olur.

Arka Plan Modunda Çalışma

Android 10'dan itibaren arka plan kısıtlamaları daha katı hale gelmiştir ve uygulama arka plandayken NetworkCallback çağrılmayabilir. Kritik görevler için — ağ kullanılabilir olduğunda veri yükleme gibi — NetworkType.CONNECTED kısıtlamasıyla WorkManager kullanın. WorkManager, ağ koşulları karşılandığında görev yürütmeyi garanti eder.

Android 12+'da, CONNECTIVITY_ACTION için BroadcastReceiver'ın manifest kaydı konusunda kısıtlama vardır. Geliştiricilerin NetworkCallback'e geçmesi veya WorkManager kullanması gerekir. Google Play politikası Ağustos 2022'den itibaren bu eylem için manifest kaydının kaldırılmasını gerektirmektedir.