iOS网络类型识别,还在使用过时的Reachability?试试最新的NWPathMonitor!

##背景 网络识别能力是APP开发过程中不可或缺的重要能力,早期iOS识别网络类型,主要是通过Reachability实现,但是System Configuration相关的API在iOS 17.4及之后版本被Apple官方标记废弃了,取而代之的是NWPathMonitor,本文主要介绍相关的用法,并提供相关的代码封装供直接使用。

NWPathMonitor用法

NWPathMonitor来自Network Framework,使用方式如下:

scss 复制代码
import Network

/// 创建NWPathMonitor实例
let monitor = NWPathMonitor()
/// 设置path更新回调
monitor.pathUpdateHandler = { [weak self] newPath in
    /// 消费newPath可以获取当前网络状态
}
/// 创建回调队列,调用start启动网络监听
let queue = DispatchQueue(label: "com.queue.AANetworkMonitor")
monitor.start(queue: queue)

消费pathUpdateHandler回调的NWPath实例,可以获取当前的网络状态,代码如下:

javascript 复制代码
func handle(path: NWPath?) {
    guard let path = path else { return }
    guard path.status == .satisfied else {
	/// 离线状态
    }
    if path.usesInterfaceType(.other) {
        /// 未知的网络连接
    }
    if path.usesInterfaceType(.wifi) {
        /// wifi
    }
    if path.usesInterfaceType(.loopback) {
        /// 回环网络
    }
    if path.usesInterfaceType(.wiredEthernet) {
        /// 以太网
    }
    if path.usesInterfaceType(.cellular) {
        /// 蜂窝网络
    }
}

蜂窝类型,我们可以用CTTelephonyNetworkInfo细化为具体的4G、5G等,代码如下:

swift 复制代码
let ctNetworkInfo = CTTelephonyNetworkInfo()
/// 根据dataServiceIdentifier获取对应的radioAccess
let radioAccess: String
if #available(iOS 13.0, *) {
    guard let id = ctNetworkInfo.dataServiceIdentifier else { return .cellular }
    guard let ra = ctNetworkInfo.serviceCurrentRadioAccessTechnology?[id] else { return .cellular }
    radioAccess = ra
} else {
    guard let ra = self.ctNetworkInfo.serviceCurrentRadioAccessTechnology?.first?.value else { return .cellular }
    radioAccess = ra
}

/// 5G
if #available(iOS 14.1, *) {
    if radioAccess == CTRadioAccessTechnologyNRNSA
        || radioAccess == CTRadioAccessTechnologyNR {
        return .cellular5G
    }
}

switch radioAccess {
case CTRadioAccessTechnologyGPRS,
    CTRadioAccessTechnologyEdge,
CTRadioAccessTechnologyCDMA1x:
	/// 2G
	break
case CTRadioAccessTechnologyWCDMA,
    CTRadioAccessTechnologyHSDPA,
    CTRadioAccessTechnologyHSUPA,
    CTRadioAccessTechnologyCDMAEVDORev0,
    CTRadioAccessTechnologyCDMAEVDORevA,
    CTRadioAccessTechnologyCDMAEVDORevB,
CTRadioAccessTechnologyeHRPD:
	/// 3G
	break
case CTRadioAccessTechnologyLTE:
	/// 4G
	break
default:
	break
}

以上就是基本用法,可以自行封装成自己的网络识别工具,替换当前的Reachability。如果想要快速接入,可以考虑使用下文我封装好的工具。

AANetworkMonitor基于NWPathMonitor的网络类型识别工具

项目地址:AANetworkMonitor

集成方式,直接通过Cocoapods:

ruby 复制代码
pod 'AANetworkMonitor'

在工程尽量早的时期,初始化工具:

swift 复制代码
import AANetworkMonitor
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
	AANetworkMonitor.setup()
	return true
}

获取网络类型,直接调用相关接口;工具内还封装了通知,会在网络类型变化后主动发出,按需监听:

swift 复制代码
/// 网络类型枚举
public enum AANetworkType: String {
    case unknown = "unknown"
    case offline = "offline"
    case wifi = "wifi"
    case loopback = "loopback"
    case wiredEthernet = "wiredEthernet"
    case cellular = "cellular"
    case cellular2G = "cellular2G"
    case cellular3G = "cellular3G"
    case cellular4G = "cellular4G"
    case cellular5G = "cellular5G"
}
/// 获取当前实时的网络类型
let type = AANetworkMonitor.currentNetworkType()
 
///  监听网络类型更新通知
NotificationCenter.default.addObserver(forName: .AANetworkTypeDidChangedNotification, object: nil, queue: nil) { notification in
    guard let userinfo = notification.userInfo else { return }
    print("AANetwork did changed, newValue: \(userinfo["newValue"] ?? ""), oldValue: \(userinfo["oldValue"] ?? "")")
}

##写在最后

欢迎直接使用代码,欢迎留言沟通交流!

相关推荐
energy_DT21 小时前
2026海上钻井平台可视化运维:红外热成像、超声波、AI视频巡检、数字孪生
前端
ONLYOFFICE21 小时前
如何将 Word 集成到 Web 应用程序? 5 种方法详解与对比
前端·word·onlyoffice
533_21 小时前
[pinia] vue3中监听pinia值的变化
前端·javascript·vue.js
铁皮饭盒21 小时前
成为AI全栈 - 第1课:后端到底是干嘛的?一张图拆解登录
前端·后端·ai编程
tingting011921 小时前
dns域名信息收集
linux·服务器·前端
暗不需求21 小时前
用 Vue 3 搓一个 AI 冰球形象生成器:从源码到 Coze 工作流全解析
前端·vue.js·ai编程
Asmewill21 小时前
MCP学习笔记
前端
小小199221 小时前
vue 单页面请求
开发语言·前端·javascript
不会敲代码121 小时前
从 URL 到页面展示,还有哪些你忽略的底层细节?(DNS 与传输篇)
前端·面试
无心使然1 天前
Openlayers调用ArcGis要素服务之一 ——要素查询 (/query)
前端·javascript·数据可视化