Swift version of PushStarter iOS app is available here.

ObjC/Cocoapods of PushStarter iOS app is available here.

Author: Corinne Krych
Level: Intermediate
Technologies: Objective-C, iOS, RHMAP Summary: A demonstration of how to include basic push functionality with RHMAP. Community Project : Feed Henry Target Product: RHMAP
Product Versions: RHMAP 3.7.0+
Source: https://github.com/feedhenry-templates/pushstarter-ios-app
Prerequisites: fh-ios-sdk : 3.+, Xcode : 7.2+, iOS SDK : iOS7+

The PushStarter project demonstrates how to include basic push functionality using fh-ios-sdk and Red Hat Mobile Application Platform. The developer should:

• enable push notifications in the iOS app within RHMAP,
• enter required certificate,
• send test notification via RHMAP studio Push tab. The iOS app catches the notification and displays them as a list.

If you do not have access to a RHMAP instance, you can sign up for a free instance at https://openshift.feedhenry.com/.

This application and its cloud services are available as a project template in RHMAP as part of the "Push Notification Hello World" template.

If you wish to contribute to this template, the following information may be helpful; otherwise, RHMAP and its build facilities are the preferred solution.

1. Clone this project

2. Populate PushStarter/fhconfig.plist with your values as explained here.

3. Open PushStarter.xcodeproj

4. Run the project

In PushStarter/AppDelegate.m you register for notification as below:

- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
  [FH pushRegister:deviceToken andSuccess:^(FHResponse *success) {
    NSNotification *notification = [NSNotification notificationWithName:@"success_registered" object:nil];
    [[NSNotificationCenter defaultCenter] postNotification:notification];
    NSLog(@"Unified Push registration successful");
  } andFailure:^(FHResponse *failed) {
    NSNotification *notification = [NSNotification notificationWithName:@"error_register" object:nil];
    [[NSNotificationCenter defaultCenter] postNotification:notification];
    NSLog(@"Unified Push registration Error: %@", failed.error);
  }];
}

Register FH to receive remote push notification with success [1] and failure [2] callbacks.

To receive notification, in PushStarter/AppDelegate.m:

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo {
    NSLog(@"UPS message received: %@", userInfo);
}

If your RHMAP is depoyed without TLS1.2 support, open as source PushStarter/PushStarter-Info.plist add the exception lines:

  <key>NSAppTransportSecurity</key>
  <dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
  </dict>