NWPathMonitor: 네트워크 모니터링 및 iOS에서의 작업

NWPathMonitor란?

NWPathMonitor는 Apple이 iOS 12 및 macOS 10.14 Mojave에서 도입한 Network 프레임워크의 클래스입니다. 기기의 네트워크 경로 변경을 추적하기 위한 현대적인 API를 제공합니다 — 애플리케이션 트래픽이 통과하는 네트워크 인터페이스의 조합입니다.

iOS 12 이전에는 C 기반 SystemConfiguration 프레임워크 위에 구축된 Reachability 라이브러리가 네트워크 모니터링에 사용되었습니다. NWPathMonitor는 더 풍부한 API, 현대적인 연결 유형(VPN, multipath, LTE, 5G) 지원 및 내장 GCD 통합을 갖춘 네이티브 Swift 대안입니다.

NWPathMonitor와 Reachability의 주요 차이점 — NWPath 객체는 이진 "사용 가능/사용 불가" 상태뿐만 아니라 경로의 완전한 그림을 제공합니다: 사용된 인터페이스, 우선순위, 비용, 로밍 상태 및 프록시 및 VPN 기능입니다. 개발자는 네트워크 요청에 대한 결정을 내리기 위한 포괄적인 정보를 얻습니다.

Network 프레임워크의 역사

Network 프레임워크는 저수준 C API — CFStream 및 BSD Sockets의 현대적인 대체재로 등장했습니다. watchOS 및 tvOS를 포함한 모든 Apple 플랫폼에서 네트워크 통신을 위한 통합 인터페이스를 제공합니다. NWPathMonitor는 NWConnection, NWListener 및 NWBrowser와 함께 이 프레임워크의 일부입니다.

Network 프레임워크는 Swift로 작성되었으며 비동기 처리를 위해 GCD를 사용합니다. 이는 NWPathMonitor 콜백이 지정된 dispatch queue에서 실행되어 수동 스레드 관리 없이 애플리케이션의 기존 멀티스레딩 아키텍처에 통합됨을 의미합니다.

애플리케이션에서 NWPathMonitor 사용 방법

NWPathMonitor 사용은 클래스 인스턴스를 생성하고 pathUpdateHandler 콜백을 구성하는 것부터 시작됩니다. 그런 다음 클로저가 실행될 dispatch queue와 함께 start 메서드가 호출됩니다. 모니터링은 cancel 메서드로 중지되며, 리소스도 함께 해제됩니다.

import Network

class NetworkMonitor {
    private let monitor = NWPathMonitor()
    private let queue = DispatchQueue("monitor")

    func startMonitoring() {
        monitor.pathUpdateHandler = { path in
            if path.status == .satisfied {
                print("네트워크 사용 가능")
            } else {
                print("네트워크 사용 불가")
            }
        }
        monitor.start(on: queue)
    }

    func stopMonitoring() {
        monitor.cancel()
    }
}

인터페이스 유형 작업

NWPathMonitor는 특정 인터페이스 유형만 모니터링하도록 구성할 수 있습니다. NWInterface.InterfaceType 매개변수(.wifi, .cellular, .wiredEthernet 또는 .loopback)와 함께 초기화자 NWPathMonitor(requiredInterfaceType:)를 사용합니다. 유형이 지정되지 않으면 모니터링이 모든 인터페이스를 포함합니다.

실용적인 예: 스트리밍 애플리케이션은 Wi-Fi만 모니터링하고 셀룰러 데이터로 전환할 때 사용자에게 경고할 수 있습니다. NWPath에서 isConstrained 및 isExpensive 확인을 통해 현재 연결이 요금제인지 또는 속도 제한이 있는지 확인할 수 있습니다.

모니터링 수명 주기

모니터링은 애플리케이션 시작 또는 포그라운드 진입 시 시작되고, 백그라운드 진입 시 중지되어야 합니다. 전체 애플리케이션에 대해 하나의 NWPathMonitor 인스턴스(싱글톤)를 만들고 프로토콜 또는 서비스 계층을 통해 다른 모듈에서 사용하는 것이 좋습니다.

NWPath의 속성 및 기능

NWPath는 pathUpdateHandler에 전달되는 객체로, 네트워크 경로의 현재 상태를 설명합니다. 대부분의 네트워크 모니터링 시나리오를 포괄하는 다섯 가지 주요 속성을 포함합니다. NWPath.Status — 세 가지 상태를 가진 열거형: satisfied(사용 가능), unsatisfied(사용 불가), requiresConnection(연결 필요).

비용 및 제한 사항 확인

isExpensive 속성은 대량의 데이터를 다루는 애플리케이션에 중요한 플래그입니다. isExpensive = true인 경우, 애플리케이션은 스트리밍 품질을 낮추고, 업데이트 다운로드를 연기하거나 사용자에게 경고해야 합니다. isConstrained는 Low Data Mode가 활성화되었음을 나타냅니다.

인터넷 가용성(단순한 네트워크가 아닌)을 확인하려면 usesInterfaceType 메서드를 사용합니다. 기기가 인터넷 없이 Wi-Fi에 연결된 경우 — NWPath가 satisfied를 표시할 수 있지만 실제 액세스는 없습니다. 이러한 경우 NWConnection을 통한 추가 검증이 필요합니다.

NWPathMonitor 구현 예제

비용 처리, 인터페이스 유형 및 퍼블리셔를 통한 ViewModel 알림을 포함한 고급 NWPathMonitor 구현을 살펴보겠습니다. 이 예제는 네트워크 상태 변경 시 반응형 UI 업데이트를 위해 Combine 프레임워크를 사용합니다.

import Network
import Combine

final class NetworkManager: ObservableObject {
    static let shared = NetworkManager()
    @Published private(set) var isConnected = true
    @Published private(set) var isExpensive = false

    private let monitor = NWPathMonitor()
    private let queue = DispatchQueue("NetworkMonitor")

    private init() {
        monitor.pathUpdateHandler = { [weak self] path in
            DispatchQueue.main.async {
                self?.isConnected = path.status == .satisfied
                self?.isExpensive = path.isExpensive
            }
        }
        monitor.start(on: queue)
    }

    func checkInterface() -> NWInterface.InterfaceType {
        let path = monitor.currentPath
        if path.usesInterfaceType(.wifi) { return .wifi }
        if path.usesInterfaceType(.cellular) { return .cellular }
        return .other
    }
}

지연 작업으로 네트워크 손실 처리

연결이 끊어졌을 때 UI에 알릴 뿐만 아니라 지연된 작업을 수행해야 할 수도 있습니다 — 예를 들어, 나중에 보내기 위해 요청 초안을 저장하는 것입니다. unsatisfied 상태 동안 작업을 축적하고 satisfied가 복원될 때 전송하는 지연 요청 큐를 구현하세요.

이 작업에는 델리게이트가 있는 ReachabilityManager 패턴이 이상적입니다: NWPathMonitor가 관리자에게 알리고, 관리자가 큐와 UI를 업데이트합니다. 상태가 satisfied로 변경되면 큐가 자동으로 비워지고 UI에 연결 복원 표시가 나타납니다.

NWPathMonitor vs Reachability

NWPathMonitor 이전에는 iOS에서 네트워크 모니터링의 표준 솔루션이 SystemConfiguration 위에 구축된 Apple의 Reachability 라이브러리(문서 예제)였습니다. 주요 차이점: Reachability는 C의 SCNetworkReachability를 통해 작동하며, 현대적인 네트워크 유형을 지원하지 않고 이진 가용성 응답만 제공합니다.

NWPathMonitor는 이러한 제한을 해결합니다: Swift로 작성되었으며, VPN, multipath, 5G 및 LTE를 지원하고, 각 인터페이스에 대한 자세한 정보를 제공하며 GCD를 통해 비동기적으로 작동합니다. Reachability는 여전히 최소 iOS 11 이하를 지원하는 프로젝트에서 사용됩니다.

Reachability를 사용해야 하는 경우

애플리케이션이 iOS 11 이하를 지원하는 경우, Reachability가 유일한 옵션입니다. iOS 12+ 프로젝트의 경우, NWPathMonitor를 직접 사용하는 것이 좋습니다 — 최신 Swift 코드, Combine 및 SwiftUI와 더 잘 통합됩니다.

Reachability에서 NWPathMonitor로의 마이그레이션은 간단합니다: SCNetworkReachability 호출을 NWPathMonitor로 대체하고 동일한 처리 로직을 유지하면 됩니다. 추상화 계층(NetworkMonitorProtocol)을 통해 애플리케이션의 비즈니스 로직을 변경하지 않고 구현 간에 전환할 수 있습니다.