作者：管振緯

---

序言

網絡連接狀態檢測對於我們的iOS app開發來說是一個非常通用的需求。為了更好的用戶體驗，我們會在無網絡時展現本地或者緩存的內容，並對用戶進行合適的提示。對絕大部分iOS開發者來說，從蘋果示例代碼改變而來的各種Reachablity框架是實現這個需求的普遍選擇,比如這個庫。但事實上，基於此方案的所有實現，都無法幫助我們檢測真正的網絡連接狀態，它們能檢測的只是本地連接狀態；這種情況包括但不限於如下場景：

1.現在很流行的公用wifi，需要網頁鑒權，鑒權之前無法上網，但本地連接已經建立；

2.存在了本地網絡連接，但信號很差，實際無法連接到服務器；

3.iOS連接的路由設備本身沒有連接外網。

CocoaChina上已有很多網友對此進行提問和吐槽，比如：

• 如何判斷設備是否真正連上互聯網？而不是只有網絡連接

• [Reachability reachabilityWithHostName:]完全沒用！

蘋果的Reachability示例中有如下說明，告訴我們其能力受限於此：

"Reachability cannot tell your application if you can connect to a particular host, only that an interface is available that might allow a connection, and whether that interface is the WWAN."

而蘋果的SCNetworkReachability API則告訴了我們更多： "Reachability does not guarantee that the data packet will actually be received by the host. "

Reachability相關的框架在底層都是通過SCNetworkReachability來實現網絡檢測的，所以無法檢測實際網絡連接情況。

有鑒於此，筆者希望打造一個通用、簡單、可靠的實際網絡連接狀態檢測框架，於是RealReachability誕生了。

RealReachability簡單介紹

RealReachability是筆者1個月之前發布到github的開源庫，項目地址如下： https://github.com/dustturtle/RealReachability。 短短1個月時間收獲了100多個star，其中主要來自於外國友人，最近還上了github的OC板塊趨勢排行榜，著實令筆者相當驚喜。 此框架開發的初衷來源於項目實際需求，離線模式對網絡連接狀態的要求比較苛刻，且實際場景經常會遇到“偽連接”的情況，Reachability面對此場景力不從心。多方研究後引入了ping能力（此方案流量開銷最小，也最簡單），實現了簡單的實際網絡連接監測；後面經過提煉和優化，就有了這個框架。可以告訴大家的是，這個框架在appstore上架應用中已經經受了考驗，且經過了長時間的測試，可以放心使用。

集成和使用介紹

• 集成

最簡便的集成方法當屬pod: pod 'RealReachability'。

手動集成：將RealReachability文件夾加入到工程即可。

依賴：Xcode5.0+，支持ARC, iOS6+.項目需要引入SystemConfiguration.framework. 

• 使用介紹

其接口的設計和調用方法和Reachability非常相似，大家可以無縫上手，非常方便。 開啟網絡監聽：

   [GLobalRealReachability startNotifier];
    [[NSNotificationCenter defaultCenter] addObserver:self
                                             selector:@selector(networkChanged:)
                                                 name:kRealReachabilityChangedNotification
                                               object:nil];

回調代碼示例：

- (void)networkChanged:(NSNotification *)notification
{
    RealReachability *reachability = (RealReachability *)notification.object;
    ReachabilityStatus status = [reachability currentReachabilityStatus];
    NSLog(@"currentStatus:%@",@(status));
}

觸發實時網絡狀態查詢代碼示例：

[GLobalRealReachability reachabilityWithBlock:^(ReachabilityStatus status) {
        switch (status)
        {
            case NotReachable:
            {
            //  case NotReachable handler
                break;
            }
            
            case ReachableViaWiFi:
            {
            //  case ReachableViaWiFi handler
                break;
            }
            
            case ReachableViaWWAN:
            {
            //  case ReachableViaWWAN handler
                break;
            }
            default:
                break;
        }
    }];

查詢當前實際網絡連接狀態：

ReachabilityStatus status = [reachability currentReachabilityStatus];

Demo:

我們在github的repository中已經包含了簡單的Demo工程，直接下載運行即可。相關的Api調用也可以參考demo中的實現。 demo截圖： 

RealReachability的實現原理

RealReachability架構圖：

realReachability架構概要圖RealReachability主要包含3大模塊：connection、ping、FSM； 其中Ping模塊通過對同樣是蘋果提供的ping樣例代碼進行了封裝，connection模塊實現了基於SCNetworkReachability的本地狀態檢測，FSM模塊是有限狀態機。通過FSM的狀態管理控制connection模塊和Ping模塊協同工作，並通過可配置的定時策略等業務邏輯優化，最終得到了我們的實現。

PS:其中connection模塊和ping模塊也可獨立使用，分別提供本地網絡檢測和ping的能力，感興趣的讀者也可以嘗試（調用方式請參考RealReachability開源代碼）。

結束語

希望這個框架能夠幫助到大家的iOS開發！ 遇到任何疑問或者使用上的問題，都可以聯系我。

對此框架我也會持續進行維護和優化，更希望感興趣的朋友可以到github上pull request! 開源有你更精彩！ https://github.com/dustturtle/RealReachability 覺得有用就點個star喔！