序言 網路連接狀態檢測對於我們的iOS app開發來說是一個非常通用的需求。為了更好的用戶體驗,我們會在無網路時展現本地或者緩存的內容,並對用戶進行合適的提示。對絕大部分iOS開發者來說,從蘋果示例代碼改變而來的各種Reachablity框架是實現這個需求的普遍選擇,比如這個庫。但事實上,基於此方案
序言
網路連接狀態檢測對於我們的iOS app開發來說是一個非常通用的需求。為了更好的用戶體驗,我們會在無網路時展現本地或者緩存的內容,並對用戶進行合適的提示。對絕大部分iOS開發者來說,從蘋果示例代碼改變而來的各種Reachablity框架是實現這個需求的普遍選擇,比如這個庫。但事實上,基於此方案的所有實現,都無法幫助我們檢測真正的網路連接狀態,它們能檢測的只是本地連接狀態;這種情況包括但不限於如下場景:
1.現在很流行的公用wifi,需要網頁鑒權,鑒權之前無法上網,但本地連接已經建立;
2.存在了本地網路連接,但信號很差,實際無法連接到伺服器;
3.iOS連接的路由設備本身沒有連接外網。
CocoaChina上已有很多網友對此進行提問和吐槽,比如:
蘋果的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非常相似,大家可以無縫上手,非常方便。 開啟網路監聽:
1 2 3 4 5 |
[GLobalRealReachability startNotifier];
[[NSNotificationCenter defaultCenter] addObserver:self
selector:@selector(networkChanged:)
name:kRealReachabilityChangedNotification
object:nil];
|
回調代碼示例:
1 2 3 4 5 6 |
- (void)networkChanged:(NSNotification *)notification
{
RealReachability *reachability = (RealReachability *)notification.object;
ReachabilityStatus status = [reachability currentReachabilityStatus];
NSLog(@ "currentStatus:%@" ,@(status));
}
|
觸發實時網路狀態查詢代碼示例:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 |
[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 ;
}
}];
|
查詢當前實際網路連接狀態:
1 |
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喔!
問啊-一鍵呼叫程式員答題神器,牛人一對一服務,開發者編程必備官方網站:www.wenaaa.com
QQ群290551701 聚集很多互聯網精英,技術總監,架構師,項目經理!開源技術研究,歡迎業內人士,大牛及新手有志於從事IT行業人員進入!