檢測手機的網路連線狀態,對 iOS App 開發來說是再基礎不過的需求。在前一篇《蘋果範例源碼導讀:Reachability》中,我們介紹了如何透過 SCNetworkReachability 提供的一系列 C 函式 API,來監聽網路連線狀態的變化。但事實上,這個方案能取得的只是設備的本地連線狀態,有時候它很難真正判斷網路是否暢通,例如以下幾種場景:
如今許多公共場所的 WiFi 需要網頁登入授權,授權前無法上網,但本地連線其實已經建立;
本地網路連線存在,但訊號很差,實際上無法連到伺服器;
iOS 連接的路由設備本身並沒有接入外網等。
ping 是 Windows、Unix、Linux 和 macOS 等系統下常用的指令,利用它可以測試資料包(ICMP)能否透過 IP 協議抵達特定主機並收到回應,從而檢查網路是否連通以及連線速度,幫助我們分析並判定網路故障。
幸運的是,蘋果提供了範例源碼 SimplePing,示範了在 iOS 或 Mac 上如何用 Objective-C / Swift 實現 ping 操作。因此我們同樣可以透過 ping 來檢查手機網路的真實連線狀態。事實上,GitHub 上著名的第三方開源庫 RealReachability 也是這麼做的。
對於 SimplePing 源碼的閱讀,我們將分為兩部分來介紹。第一部分結合 SimplePing.h 頭檔裡宣告的方法,介紹如何使用 SimplePing 類封裝的方法進行 ping 操作;第二部分(下一篇)則詳細介紹 SimplePing.m 裡各方法的具體實現細節。
透過 SimplePing.h 頭檔中的宣告,我們整理出 SimplePing 的類結構如下圖所示:

?
下面我們逐一介紹 SimplePing 類的各個屬性、方法以及 delegate 回呼方法的含義與作用。
12- (instancetype)init NS_UNAVAILABLE;- (instancetype)initWithHostName:(NSString *)hostName NS_DESIGNATED_INITIALIZER;在 SimplePing 中,init 方法被禁用,只提供 initWithHostName: 一個方法,它可以初始化一個用於 ping 指定主機的實例物件。其中 hostName 參數可以是主機的 DNS 網域名稱,也可以是 IPv4、IPv6 位址的字串形式。
1@property (nonatomic, copy, readonly) NSString * hostName;hostName:唯讀,保存由初始化方法 initWithHostName: 傳入的、要進行 ping 操作的主機網域名稱或 IP 位址。
1@property (nonatomic, assign, readwrite) SimplePingAddressStyle addressStyle;addressStyle:主機的 IP 位址類型,如 IPv4 或 IPv6 等,其中 SimplePingAddressStyle 列舉類型的定義如下:
12345typedef NS_ENUM(NSInteger, SimplePingAddressStyle) {SimplePingAddressStyleAny, // IPv4 或 IPv6SimplePingAddressStyleICMPv4, // IPv4SimplePingAddressStyleICMPv6 // IPv6};1@property (nonatomic, copy, readonly, nullable) NSData * hostAddress;hostAddress:唯讀,在 start 方法呼叫之後,根據 hostName 得到的、要 ping 的主機 IP 位址,它是 struct sockaddr 形式的 NSData 資料。當 SimplePing 實例處於 stopped 狀態,或實例呼叫了 start 方法但 simplePing:didStartWithAddress: 方法被呼叫之前,hostAddress 的值都是 nil。
1@property (nonatomic, assign, readonly) sa_family_t hostAddressFamily;hostAddressFamily:唯讀,hostAddress 的位址族,如果 hostAddress 為 nil,則其值為 AF_UNSPEC。
1@property (nonatomic, assign, readonly) uint16_t identifier;identifier:唯讀,當建立一個 SimplePing 實例物件時,會自動產生一個隨機標識符,用來唯一標識當前的 ping 物件。
1@property (nonatomic, assign, readonly) uint16_t nextSequenceNumber;nextSequenceNumber:唯讀,ping 每發送一次資料包都會有一個對應的序列號(sequence number),此值為下一次 ping 操作要發送資料時的序列號,從 0 開始遞增,當 ping 成功發送一次資料到主機並收到應答時,該值 +1。而對於本次 ping 的 sequence number,在成功發送資料(request)與成功接收到響應(response)的 delegate 回呼方法裡都會以方法參數返回,以便進行 ping 操作耗時的計算等。
1@property (nonatomic, weak, readwrite, nullable) id delegate; delegate:當前物件的回呼,delegate 中的回呼方法將在物件呼叫 start 方法所在的執行緒對應的 run loop 中,以默認的 run loop model 執行。
1- (void)start;start 方法:開始一個 ping 操作。在呼叫此方法前,必須給 SimplePing 實例物件的 delegate 以及其他參數賦值。當 start 方法成功執行時,會回呼 delegate 中的 simplePing:didStartWithAddress: 方法,在該回呼方法裡,就可以透過 sendPingWithData: 開始發送 ICMP 資料包,並等待接收主機應答的資料包。另外需要注意,當一個實例已經 started,再次呼叫此 start 方法會出錯。
1- (void)sendPingWithData:(nullable NSData *)data;sendPingWithData: 方法:向主機發送特定格式的 ICMP 資料包,呼叫此方法前必須保證實例已經 started,並且要等待 simplePing:didStartWithAddress: 回呼執行才能開始發送資料。參數 data 為要向主機發送的 ICMP 資料包,可以為 nil,默認會發一個標準的 64 byte 資料包。
1- (void)stop;stop 方法:當結束要 ping 操作時呼叫此方法。與 start 方法不同的是,當一個實例已經 stopped,再次呼叫此方法也沒問題。
start 方法執行結果的回呼:
12345// start 方法成功執行,可在此開始發送資料,其中 address 為主機的 IP 位址;- (void)simplePing:(SimplePing *)pinger didStartWithAddress:(NSData *)address;// start 方法執行失敗,返回錯誤資訊;- (void)simplePing:(SimplePing *)pinger didFailWithError:(NSError *)error;sendPingWithData: 方法執行結果的回呼,每發送一次資料,都會同步地回呼以下兩個方法其中一個(除非你在發送途中呼叫了 stop 方法):
12345// 成功發送 ICMP 資料包到指定主機,在此傳回已發送的資料包以及本次 ping 對應的序列號;- (void)simplePing:(SimplePing *)pinger didSendPacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber;// 發送資料失敗,並返回錯誤資訊,絕大部分原因由於 hostName 解析失敗。另,當此方法呼叫時,ping 實例狀態會自動轉為 `stopped`,不用再顯示呼叫 `stop` 方法;- (void)simplePing:(SimplePing *)pinger didFailToSendPacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber error:(NSError *)error;接收到主機返回應答資料的回呼:
12345// 成功接收到主機回傳的、與之前發送相匹配的 ICMP 資料包;- (void)simplePing:(SimplePing *)pinger didReceivePingResponsePacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber;// 收到的未知的資料包。- (void)simplePing:(SimplePing *)pinger didReceiveUnexpectedPacket:(NSData *)packet;注:以上回呼方法中的 packet 資料包只包含了 ICMP header 和 sendPingWithData: 中傳入的資料,但不包含任何 IP 層的 header。
根據蘋果提供的 Demo,我們梳理出使用 SimplePing 類進行 ping 操作的流程如下圖所示:

?
根據上圖,我們寫了一個簡單的使用範例,詳見下方程式碼及註釋,不再贅述。
1#import "ViewController.h"#import "SimplePing.h"@interface ViewController () @property (nonatomic, strong) SimplePing *pinger;@end@implementation ViewController- (void)viewDidLoad {[super viewDidLoad];// (1)// 初始化一個 SimplePing 實例,// 注意,這個 pinger 實例不能為臨時變量,不然當前函式執行完畢後,pinger 實例就會被釋放,那麼它的 delegate 將不會執行。self.pinger = [[SimplePing alloc] initWithHostName:@"www.apple.com"];// (2)// 指定 pinger 的 delegateself.pinger.delegate = self;// 指定要 ping 的 IP 位址的類型self.pinger.addressStyle = SimplePingAddressStyleICMPv4;// (3)// 呼叫 start 方法開始 ping[self.pinger start];}#pragma mark - SimplePingDelegate// (4) start 方法成功執行,可開始發送資料- (void)simplePing:(SimplePing *)pinger didStartWithAddress:(NSData *)address {NSLog(@"address: %@", address);// (5) 呼叫 sendPingWithData: 方法發送資料[pinger sendPingWithData:nil]; // data 可傳入 nil,此時 ping 發送的資料會有一個默認值。}// (4) start 方法執行失敗,返回錯誤資訊- (void)simplePing:(SimplePing *)pinger didFailWithError:(NSError *)error {NSLog(@"%@", error.localizedDescription);}#pragma mark -// (6) 成功發送資料- (void)simplePing:(SimplePing *)pinger didSendPacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber {NSLog(@"didSendPacket: %@", packet);NSLog(@"identifier: %d", pinger.identifier);NSLog(@"sequenceNumber: %d", sequenceNumber);NSLog(@"nextSequenceNumber: %d", pinger.nextSequenceNumber);}// (6) 發送資料失敗- (void)simplePing:(SimplePing *)pinger didFailToSendPacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber error:(NSError *)error {NSLog(@"didFailToSendPacket: %@", error.localizedDescription);}#pragma mark -// (7) 成功接收到之前 pinger 發送的資料- (void)simplePing:(SimplePing *)pinger didReceivePingResponsePacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber {NSLog(@"didReceivePingResponsePacket: %@", packet);NSLog(@"identifier: %d", pinger.identifier);NSLog(@"sequenceNumber: %d", sequenceNumber);NSLog(@"nextSequenceNumber: %d", pinger.nextSequenceNumber);}// (7) 接收到到未知的資料- (void)simplePing:(SimplePing *)pinger didReceiveUnexpectedPacket:(NSData *)packet {NSLog(@"didReceiveUnexpectedPacket: %@", packet);} 本篇文章只介紹了如何使用蘋果提供的範例源碼 SimplePing 類,初始化一個實例在 iOS 設備上進行 ping 操作,以判斷網路的真實連線狀態。在下一篇文章《蘋果實例源碼導讀:SimplePing(二)》中,我們將介紹 SimplePing 類各個方法的具體內部實現。
Apple Sample Code: SimplePing
iOS 下的實際網路連線狀態檢測:RealReachability