Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Yet another SystemConfiguration Reachability Wrapper

branch: develop

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 RAReachability.xcodeproj
Octocat-spinner-32 RAReachability
Octocat-spinner-32 .gitignore
Octocat-spinner-32 README.md
README.md

RAReachability

Yet another SystemConfiguration Reachability Wrapper.

What’s Inside

The project gives you RAReachabilityDetector which is a very lightweight abstraction around SCNetworkReachabilityRef provided by SystemConfiguration. You can monitor anything a SCNetworkReachabilityRef already monitors, and use Cocoa-style delegation to handle changes in network configuration.

If you just want to see if WiFi works, for example, do this:

self.wifiDetector = [RAReachabilityDetector newDetectorForLocalWiFi];

then implement the delegate method:

- (void) reachabilityDetectorDidUpdateState:(RAReachabilityDetector *)detector {

    if (detector == _wifiDetector) {

        BOOL wifiReachableDirectly = WASCNetworkReachableDirectly(detector.networkStateFlags);

        //  …

    }

}

You can invoke -initWithAddress: and pass a socket address, or -initWithURL: and pass an NSURL. Or, you can simply pass a SCNetworkReachabilityRef to -initWithReachabilityRef:, in all cases the class does the right thing and lets you know about the changes.

Since merely knowing if the networking layer works is only half the battle, there is also RAPulseCheckingReachabilityDetector. If you subclass it, and override -executePulseCheckingBlockWithCallback:, you have a chance to do additional work (networking, for example) and communicate with the application layer to see if it is suitable for processing more requests.

The class supports -compare: fully, so you can also hold several detectors in an NSArray, and sort them by availability.

Licensing

This project is in the public domain. You can use it and embed it in whatever application you sell, and you can use it for evil. However, it is appreciated if you provide attribution, by linking to the project page (https://github.com/evadne/RAReachability) from your application.

Credits

Something went wrong with that request. Please try again.