Reachability: τι είναι, βιβλιοθήκη ελέγχου διαθεσιμότητας δικτύου

Τι είναι το Reachability;

Το Reachability — είναι μια βιβλιοθήκη παράδειγμα από την Apple που επιδεικνύει τη χρήση του framework SystemConfiguration για παρακολούθηση δικτύου. Ο πηγαίος κώδικας δημοσιεύτηκε στο Apple Developer Documentation ως παράδειγμα, αλλά η κοινότητα το υιοθέτησε ως πρότυπο εργαλείο ελέγχου σύνδεσης σε έργα iOS.

Η βιβλιοθήκη λειτουργεί βάσει του SCNetworkReachability — μιας συνάρτησης C από το SystemConfiguration που αξιολογεί την προσεγγισιμότητα ενός απομακρυσμένου κοσμικού υπολογιστή ή διεύθυνσης IP. Κατά τη δημιουργία του Reachability καθορίζετε είτε όνομα κοσμικού υπολογιστή (π.χ. google.com) είτε διεύθυνση IP, και η βιβλιοθήκη ελέχει ασύγχρονα εάν αυτός ο κοσμικός υπολογιστής είναι προσβάσιμος μέσω των τρεχουσών διεπαφών δικτύου της συσκευής.

Η δημοφιλία του Reachability οφείλεται στην απλότητά του: αρκεί να δημιουργήσετε μια περίπτωση, να εγγραφείτε σε ειδοποιήσεις μέσω NotificationCenter και να ακούτε το kReachabilityChangedNotification. Ως απάντηση, η εφαρμογή λαμβάνει κατάσταση: NotReachable, ReachableViaWiFi ή ReachableViaWWAN (κινητά δεδομένα).

Ιστορία και κατάσταση της βιβλιοθήκης

Το Reachability εμφανίστηκε για πρώτη φορά στο iPhone OS 2 (2008) μαζί με το framework SystemConfiguration. Για δέκα χρόνια ήταν ο μοναδικός εγγενής τρόπος παρακολούθησης δικτύου στο iOS. Με την κυκλοφορία iOS 12 και του framework Network, η Apple συνιστά το NWPathMonitor ως αντικατάσταση, αλλά το Reachability εξακολουθεί να υποστηρίζεται.

Πολλά περιτυλίγματα τρίτων μερών — AFNetworking, Alamofire, AshleyDodd/Reachability.swift — χρησιμοποιούν τον εσωτερικό μηχανισμό SCNetworkReachability. Αυτές οι βιβλιοθήκες προσθέτουν βολική διεπαφή Swift/Objective-C, μεμοποίηση κατάστασης και thread-safe callbacks, διατηρώντας την ίδια βάση SystemConfiguration.

Πώς λειτουργεί το Reachability κάτω από το καπό

Ο κύριος μηχανισμός του Reachability — η συνάρτηση SCNetworkReachabilityCreateWithName, η οποία δημιουργεί ένα αντικείμενο παρακολούθησης για τον καθορισμένο κοσμικό υπολογιστή. Στη συνέχεια καλείται η SCNetworkReachabilityGetFlags — ένας σύγχρονος έλεγχος που επιστρέφει μια διαδικαστική μάσκα SCNetworkReachabilityFlags με την τρέχουσα κατάσταση δικτύου.

Για ασύγχρονη παρακολούθηση χρησιμοποιείται η SCNetworkReachabilitySetCallback, η οποία καταχωρίζει μια συνάρτηση callback C. Το callback εκτελείται στο τρέχον RunLoop όταν αλλάξει η κατάσταση προσβασιμότητας του κοσμικού υπολογιστή. Το Reachability τυλίγει αυτό το C-callback σε μα θέτοδο Objective-C και στέλνει ειδοποίηση μέσω NotificationCenter.

import SystemConfiguration

class Reachability {
    private var reachabilityRef: SCNetworkReachability?

    init?(hostname: String) {
        reachabilityRef = SCNetworkReachabilityCreateWithName(
            nil, hostname
        )
    }

    func checkReachability() -> Bool {
        var flags = SCNetworkReachabilityFlags()
        SCNetworkReachabilityGetFlags(
            reachabilityRef!, &flags
        )
        return isReachable(with: flags)
    }

    private func isReachable(with flags: SCNetworkReachabilityFlags) -> Bool {
        let reachable = flags.contains(.reachable)
        let connectionRequired = flags.contains(.connectionRequired)
        return reachable && !connectionRequired
    }
}

Σημαίες προσβασιμότητας δικτύου

SCNetworkReachabilityFlags — μια διαδικαστική μάσκα που κωδικοποιεί την κατάσταση δικτύου. Η σημαία kSCNetworkReachabilityFlagsReachable υποδεικνύει ότι ο κοσμικός υπολογιστής είναι προσβάσιμος. kSCNetworkReachabilityFlagsConnectionRequired — για σύνδεση απαιτείται η δημιουργία επικοινωνίας. Ο συνδυασμός σημαιών καθορίζει εάν η εφαρμογή μπορεί να στείλει δεδομένα.

Επιπλέον σημαίες: kSCNetworkReachabilityFlagsIsWWAN — σύνδεση μέσω κινητού δικτύου (iOS), kSCNetworkReachabilityFlagsInterventionRequired — απαιτείται παρέμβαση χρήστη (π.χ. για VPN). Το Reachability λαμβάνει υπόψη αυτές τις σημαίες για τον προσδιορισμό του τύπου διεπαφής.

Παραδείγματα χρήσης Reachability

Το τυπικό μοτίβο χρήσης του Reachability σε μια εφαρμογή iOS περιλαμβάνει τη δημιουργία μιας περίπτωσης, την εγγραφή σε ειδοποιήσεις και την αντίδραση σε αλλαγή κατάστασης. Το παρακάτω παράδειγμα δείχνει την ενσωματώσει με το NotificationCenter για ενημέρωση UI όταν αλλάζει το δίκτυο.

import Reachability
import UIKit

class ViewController: UIViewController {
    var reachability: Reachability?

    override func viewDidLoad() {
        super.viewDidLoad()
        reachability = Reachability(hostname: "google.com")
        NotificationCenter.default.addObserver(
            self,
            selector: #selector(reachabilityChanged),
            name: .reachabilityChanged,
            object: nil
        )
        reachability?.startNotifier()
    }

    @objc func reachabilityChanged(notification: Notification) {
        if let reachability = notification.object as? Reachability {
            switch reachability.connection {
            case .wifi:
                print("Συνδεδεμένο μέσω Wi-Fi")
            case .cellular:
                print("Συνδεδεμένο μέσω κινητής")
            case .unavailable:
                print("Καμία σύνδεση")
            }
        }
    }
}

Έλεγχος δικτύου πριν από αίτημα

Πριν από την εκτέλεση ενός HTTP αιτήματος, μπορείτε να ελέγξετε σύγχρονα τη διαθεσιμότητα δικτύου: reachability.connection != .unavailable. Αυτό δεν εγγυάται την επιτυχία του αιτήματος (ο διακομιστής μπορεί να μην είναι διαθέσιμος), αλλά αποτρέπει εξ αρχής αποτυχημένα αιτήματα και βελτιώνει την UX — η εφαρμογή δεν εμφανίζει spinner σε λειτουργία offline.

Για ακριβέστερο έλεγχο, συνδυάστε το Reachability με χρονική ανοχή URLSession. Εάν το Reachability εμφανίζει reachable, αλλά το αίτημα δεν εκτελείται μέσα στο χρονικό περιθώριο — το πρόβλημα είναι πιθανώς από την πλευρά του διακομιστή ή πύλη captive. Σε αυτήν την περίπτωση, μπορείτε να εμφανίσετε ένα μήνυμα στον χρήστη σχετικά με την μη διαθεσιμότητα του διακομιστή.

Τύποι συνδέσεων στο Reachability

Το Reachability διαφοροποιεί τρεις κύριες καταστάσεις σύνδεσης: Wi-Fi, κινητά δεδομένα (WWAN) και μη διαθεσιμότητα. Το WWAN περιλαμβάνει όλους τους τύπους κινητής επικοινωνίας — 2G, 3G, 4G/LTE, 5G. Η βιβλιοθήκη δεν παρέχει λεπτομέρειες εντός WWAN, επομένως για διαφοροποίηση 4G και 5G απαιτείται CoreTelephony.

Περιορισμοί του Reachability ανά τύπο δικτύου

Το Reachability δεν διαφοροποιεί Ethernet, VPN tunnels ή multipath συνδέσεις — όλες οι μη-WWAN διεπαφές ταξινομούνται ως Wi-Fi. Αυτός ο περιορισμός σχετίζεται με την αρχιτεκτονική του SystemConfiguration, η οποία δεν παρέχει λεπτομερή πληροφορία για διεπαφές δικτύου πέρα από την βασική ταξινόμηση.

Για τον προσδιορισμό του συγκεκριμένου τύπου κινητής επικοινωνίας (4G vs 5G) απαιτείται CTTelephonyNetworkInfo από το CoreTelephony. Ο συνδυασμός του Reachability με το CoreTelephony επιτρέπει στην εφαρμογή να επιλέξει ποιότητα περιεχομένου: σε 5G — streaming 4K, σε 4G/LTE — HD, σε 3G — SD ή μόνο ήχος.

Μετανάστευση από Reachability σε NWPathMonitor

Η Apple συνιστά την αντικατάσταση του Reachability με NWPathMonitor σε όλα τα νέα έργα, ξεκινώντας από iOS 12. Ο κύριος λόγος είναι ότι το NWPathMonitor αποτελεί μέρος του σύγχρονου framework Network, είναι γραμμένο σε Swift, υποστηρίζει Combine και παρέχει λεπτομερή πληροφορία για τη διαδρομή δικτύου χωρίς χρήση συμβατότητας C.

Η διαδικασία μετανάστευσης περιλαμβάνει την αντικατάσταση του SCNetworkReachability με NWPathMonitor, μετάβαση από NotificationCenter σε pathUpdateHandler closure ή Combine publisher. Ο αλγόριθμος και η λογική επεξεργασίας κατάστασης δικτύου παραμένουν ίδια — αλλάζει μόνο το API παρακολούθησης.

protocol NetworkMonitorProtocol {
    var isReachable: Bool { get }
    var connectionType: ConnectionType { get }
    func startMonitoring()
    func stopMonitoring()
}

enum ConnectionType {
    case wifi, cellular, ethernet, unavailable
}

// Σύγχρονη υλοποίηση με χρήση NWPathMonitor
class ModernNetworkMonitor: NetworkMonitorProtocol {
    private let monitor = NWPathMonitor()
    private let queue = DispatchQueue("Network")
    private var currentPath: NWPath?

    var isReachable: Bool {
        currentPath?.status == .satisfied
    }

    func startMonitoring() {
        monitor.pathUpdateHandler = { [weak self] path in
            self?.currentPath = path
        }
        monitor.start(on: queue)
    }

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

Συστάσεις για μετανάστευση

Για έργα με βασική υποστήριξη iOS 12+, αντικαταστήστε πλήρως το Reachability με NWPathMonitor. Για έργα που υποστηρίζουν iOS 11, χρησιμοποιήστε συνθήκη μεταγλώττισης #available(iOS 12, *) με NWPathMonitor και Reachability ως fallback. Αυτό επιτρέπει σταδιακή μετανάστευση χωρίς απώλεια υποστήριξης παλιών συσκευών.

Το κύριο πλεονέκτημα της μετανάστευσης είναι η λεπτομέρεια της διαδρομής δικτύου. Το NWPathMonitor δεν αναφέρει μόνο „διαθέσιμο/μη διαθέσιμο”, αλλά και τον τύπο κάθε διεπαφής, το κόστος τους, προτεραιότητα, υποστήριξη proxy και VPN. Αυτό δίνει στον πραγματοποιητή περισσότερα δεδομένα για την προσαρμογή της συμπεριφοράς της εφαρμογής στις τρέχουσες συνθήκες δικτύου.