Network Connection Detection in iOS and macOS: From Basic Implementation to Best Practices

The Importance of Network Connection Detection

In modern mobile and desktop software development, real-time detection of network connection status is crucial for ensuring application stability and user experience. Whether for social applications requiring real-time data synchronization or office software relying on cloud services, accurate network status judgment helps developers make informed business decisions.

Limitations of Traditional Methods

Many developers might initially attempt to detect network connections using simple URL requests, such as:

- (BOOL)connectedToInternet {
    NSString *URLString = [NSString stringWithContentsOfURL:[NSURL URLWithString:@"http://www.google.com"]];
    return ( URLString != NULL ) ? YES : NO;
}

This approach suffers from several critical issues: first, the stringWithContentsOfURL method has been deprecated since iOS 3.0 and macOS 10.4; second, it executes synchronously, freezing the application interface; and finally, reliance on specific third-party services (like Google) introduces single points of failure.

Asynchronous Solutions with the Reachability Framework

Apple's recommended solution involves using the Reachability functionality within the SystemConfiguration framework. Below are implementations for both Swift and Objective-C.

Swift Implementation

First, install the Reachability.swift library via CocoaPods or Carthage:

let reachability = Reachability()!

reachability.whenReachable = { reachability in
    if reachability.connection == .wifi {
        print("Reachable via WiFi")
    } else {
        print("Reachable via Cellular")
    }
}

reachability.whenUnreachable = { _ in
    print("Not reachable")
}

do {
    try reachability.startNotifier()
} catch {
    print("Unable to start notifier")
}

Objective-C Implementation

Add the SystemConfiguration framework to your project and import Tony Million's Reachability library:

#import "Reachability.h"

@interface MyViewController ()
{
    Reachability *internetReachableFoo;
}
@end

- (void)testInternetConnection
{
    internetReachableFoo = [Reachability reachabilityWithHostname:@"www.google.com"];

    internetReachableFoo.reachableBlock = ^(Reachability*reach)
    {
        dispatch_async(dispatch_get_main_queue(), ^{
            NSLog(@"Yayyy, we have the interwebs!");
        });
    };

    internetReachableFoo.unreachableBlock = ^(Reachability*reach)
    {
        dispatch_async(dispatch_get_main_queue(), ^{
            NSLog(@quot;Someone broke the internet :(");
        });
    };

    [internetReachableFoo startNotifier];
}

Analysis of Practical Application Scenarios

Referencing the network issue case in macOS Sequoia, we can see the importance of network detection in real-world environments. In this case, iMacs running Sequoia 15.0.1 on Intel chips experienced random network disconnections, email failures, and DNS resolution problems. Although the root cause was ultimately resolved through a system update, the network interface restart script used during troubleshooting:

#!/bin/bash
for interface in $(networksetup -listallhardwareports | awk '/Device:/{print $2}')
do
    ip=$(ifconfig $interface | awk '/inet /{print $2}')
    if [ -n "$ip" ]; then
        echo "Ethernet Interface: $interface"
        echo "IP Address: $ip"
        sudo ifconfig $interface down
        sleep 10
        sudo ifconfig $interface up
    fi
done

This temporary solution, while not elegant, effectively addressed the immediate problem, demonstrating the necessity of emergency measures during network anomalies.

Summary of Best Practices

Based on the above analysis, we summarize best practices for network connection detection: first, always use asynchronous methods to avoid blocking the main thread; second, utilize the system-provided Reachability framework instead of custom URL detection; third, promptly handle network status changes and update the UI appropriately; finally, consider network anomalies in deployment environments and design corresponding fault-tolerant mechanisms.

Technical Points Analysis

The core advantage of the Reachability framework lies in its ability to accurately reflect the device's underlying network connection status, rather than simply testing the reachability of a specific service. By monitoring system-level information such as network interface status and routing table changes, the framework provides reliable network status judgments. Developers should note that the Reachability class may cause naming conflicts in large projects, requiring file renaming for resolution.

Performance Optimization Recommendations

Performance optimization is equally important in network detection implementations. It is advisable to set reasonable detection frequencies to avoid excessive system resource consumption from frequent network status queries. Additionally, when network status changes, appropriate strategies should be employed to update the application state, such as using notification centers or delegate patterns to distribute network status change events.