NWPathMonitor: ce este, urmărirea rețelei și lucrul în iOS

Ce este NWPathMonitor?

NWPathMonitor — este o clasă din framework-ul Network, introdusă de Apple în iOS 12 și macOS 10.14 Mojave. Oferă un API modern pentru urmărirea modificărilor căii de rețea a dispozitivului — combinația de interfețe de rețea prin care trece traficul aplicației.

Înainte de iOS 12, pentru monitorizarea rețelei se folosea biblioteca Reachability, construită pe framework-ul C SystemConfiguration. NWPathMonitor este o alternativă nativă Swift cu un API mai bogat, suport pentru tipuri moderne de conexiuni (VPN, multipath, LTE, 5G) și lucru integrat cu GCD.

Diferența cheie dintre NWPathMonitor și Reachability — obiectul NWPath oferă nu doar un status binar „disponibil/nedisponibil", ci o imagine completă a căii: interfețele utilizate, prioritatea lor, costurile, statusul roaming-ului și posibilitatea proxy și VPN. Dezvoltatorul primește informații exhaustive pentru a lua decizii privind cererile de rețea.

Istoria apariției framework-ului Network

Framework-ul Network a apărut ca un înlocuitor modern pentru API-urile C de nivel scăzut — CFStream și BSD Sockets. Oferă o interfață unificată pentru comunicarea în rețea pe toate platformele Apple, inclusiv watchOS și tvOS. NWPathMonitor face parte din acest framework alături de NWConnection, NWListener și NWBrowser.

Framework-ul Network este scris în Swift și utilizează GCD pentru procesarea asincronă. Aceasta înseamnă că callback-urile NWPathMonitor sunt executate pe coada dispatch queue specificată, integrându-se cu arhitectura existentă de multi-threading a aplicației fără gestionarea manuală a firelor de execuție.

Cum să utilizați NWPathMonitor în aplicație

Utilizarea NWPathMonitor începe cu crearea unei instanțe a clasei și configurarea handler-ului pathUpdateHandler. Apoi se apelează metoda start cu specificarea cozii dispatch queue pe care se va executa closure. Oprirea monitorizării se face prin metoda cancel, care eliberează și resursele.

import Network

class NetworkMonitor {
    private let monitor = NWPathMonitor()
    private let queue = DispatchQueue("monitor")

    func startMonitoring() {
        monitor.pathUpdateHandler = { path in
            if path.status == .satisfied {
                print("Rețea disponibilă")
            } else {
                print("Rețea indisponibilă")
            }
        }
        monitor.start(on: queue)
    }

    func stopMonitoring() {
        monitor.cancel()
    }
}

Lucrul cu tipul de interfață

NWPathMonitor poate fi configurat să urmărească doar un anumit tip de interfață. Pentru aceasta se utilizează inițializatorul NWPathMonitor(requiredInterfaceType:) cu parametrul NWInterface.InterfaceType — .wifi, .cellular, .wiredEthernet sau .loopback. Dacă tipul nu este specificat, monitorizarea se face pentru toate interfețele.

Exemplu practic: o aplicație de streaming poate urmări doar Wi-Fi-ul și poate avertiza utilizatorul la trecerea pe date mobile. Verificarea isConstrained și isExpensive în NWPath permite determinarea dacă conexiunea curentă este tarifată sau limitată ca viteză.

Ciclul de viață al monitorizării

Monitorizarea trebuie pornită la lansarea aplicației sau la ieșirea în prim-plan și oprită la trecerea în fundal. Se recomandă crearea unei singure instanțe NWPathMonitor pentru întreaga aplicație (singleton) și utilizarea acesteia din diferite module printr-un protocol sau un strat de servicii.

Proprietăți și capacități ale NWPath

NWPath — obiectul transmis în pathUpdateHandler, care descrie starea curentă a căii de rețea. Conține cinci proprietăți cheie care acoperă majoritatea scenariilor de monitorizare a rețelei. NWPath.Status — o enumerare cu trei stări: satisfied (disponibil), unsatisfied (indisponibil) și requiresConnection (necesită conexiune).

Verificarea costurilor și limitărilor

Proprietatea isExpensive — un flag critic pentru aplicațiile care lucrează cu volume mari de date. Dacă isExpensive = true, aplicația trebuie să reducă calitatea streamingului, să amâne descărcarea actualizărilor sau să avertizeze utilizatorul. isConstrained indică activarea modului Low Data Mode.

Pentru verificarea disponibilității internetului (nu doar a rețelei) se utilizează metoda usesInterfaceType. Dacă dispozitivul este conectat la Wi-Fi fără internet — NWPath poate afișa satisfied, dar accesul real lipsește. În astfel de cazuri este necesară o validare suplimentară prin NWConnection.

Exemple de implementare NWPathMonitor

Să analizăm o implementare avansată a NWPathMonitor cu gestionarea costurilor, tipurilor de interfață și notificarea ViewModel-ului printr-un publisher. În exemplu se utilizează framework-ul Combine pentru actualizarea reactivă a UI la modificarea stării rețelei.

import Network
import Combine

final class NetworkManager: ObservableObject {
    static let shared = NetworkManager()
    @Published private(set) var isConnected = true
    @Published private(set) var isExpensive = false

    private let monitor = NWPathMonitor()
    private let queue = DispatchQueue("NetworkMonitor")

    private init() {
        monitor.pathUpdateHandler = { [weak self] path in
            DispatchQueue.main.async {
                self?.isConnected = path.status == .satisfied
                self?.isExpensive = path.isExpensive
            }
        }
        monitor.start(on: queue)
    }

    func checkInterface() -> NWInterface.InterfaceType {
        let path = monitor.currentPath
        if path.usesInterfaceType(.wifi) { return .wifi }
        if path.usesInterfaceType(.cellular) { return .cellular }
        return .other
    }
}

Gestionarea pierderii rețelei cu acțiune întârziată

La pierderea conexiunii poate fi necesară nu doar notificarea UI-ului, ci și executarea unor acțiuni întârziate — de exemplu, salvarea unei ciorne de cerere pentru trimiterea ulterioară. Implementați o coadă de cereri întârziate care acumulează operațiile la statusul unsatisfied și le trimite la restabilirea satisfied.

Pentru această sarcină se potrivește perfect modelul ReachabilityManager cu delegat: NWPathMonitor notifică managerul, managerul actualizează coada și UI-ul. La schimbarea statusului în satisfied, coada se golește automat, iar UI-ul primește indicația restabilirii conexiunii.

NWPathMonitor vs Reachability

Înainte de apariția NWPathMonitor, soluția standard pentru monitorizarea rețelei în iOS era biblioteca Reachability de la Apple (exemplu din documentație), construită pe SystemConfiguration. Diferențele principale: Reachability funcționează prin SCNetworkReachability în C, nu suportă tipurile moderne de rețele și oferă doar un răspuns binar despre disponibilitate.

NWPathMonitor rezolvă aceste limitări: este scris în Swift, suportă VPN, multipath, 5G și LTE, oferă informații detaliate despre fiecare interfață și funcționează asincron prin GCD. Reachability este încă utilizat în proiecte cu suport minim pentru iOS 11 și versiuni inferioare.

Când să utilizați Reachability

Dacă aplicația dvs. suportă iOS 11 și versiuni inferioare, Reachability rămâne singura opțiune. Pentru proiectele iOS 12+ se recomandă utilizarea directă a NWPathMonitor — se integrează mai bine cu codul Swift modern, Combine și SwiftUI.

Migrarea de la Reachability la NWPathMonitor este simplă: este suficient să înlocuiți apelurile SCNetworkReachability cu NWPathMonitor, păstrând aceeași logică de procesare. Stratul de abstractizare (protocolul NetworkMonitorProtocol) va permite comutarea între implementări fără modificarea logicii de business a aplicației.