Close Menu

chtreachability

Overview

This documentation provides a comprehensive guide on using the chtreachability library in your iOS app. The chtreachability library allows you to easily determine the reachability status of a device to a specific host or network via WiFi or cellular data connection. It provides a simple yet powerful interface to monitor network changes and adapt your app’s behavior accordingly.

Installation

To use the chtreachability library in your iOS project, follow these simple steps:

  1. Navigate to your Xcode project
  2. Open the Podfile
  3. Add the following line: pod 'chtreachability'
  4. Save the Podfile and run pod install from the terminal
  5. Open your Xcode workspace
  6. Import chtreachability by adding the following line in your source code: #import <chtreachability/CHTReachability.h>

Usage

Using chtreachability in your app is straightforward. Follow the steps below to integrate network reachability monitoring into your project:

1. Checking Reachability

In order to check the reachability of a specific host, use the following code snippet:


CHTReachability *reachability = [CHTReachability reachabilityWithHostName:@"example.com"];

if ([reachability isReachable]) {
    NSLog(@"Host is reachable");
} else {
    NSLog(@"Host is not reachable");
}

2. Monitoring Reachability

To continuously monitor reachability changes, you need to observe the reachability notifications. Follow the code snippet below to get started:


[[NSNotificationCenter defaultCenter] addObserver:self 
                                         selector:@selector(reachabilityChanged:) 
                                             name:kCHTReachabilityChangedNotification 
                                           object:nil];

CHTReachability *reachability = [CHTReachability reachabilityWithHostName:@"example.com"];
[reachability startMonitoring];

3. Reachability Notification Handler

To handle reachability changes, implement the reachabilityChanged: method in your code and perform the necessary actions based on the reachability status. See the code snippet below for an example implementation:


- (void)reachabilityChanged:(NSNotification *)notification {
    CHTReachability *reachability = [notification object];

    if ([reachability isReachable]) {
        NSLog(@"Host is reachable");
    } else {
        NSLog(@"Host is not reachable");
    }
}

Conclusion

By utilizing the chtreachability library, you can easily determine the network reachability status in your iOS app and customize its behavior accordingly. The provided guide should help you integrate and use the library effectively, enabling your app to handle different network scenarios with ease.