This project shows how Catapush iOS SDK can be integrated to receive Catapush messages and display them with a customizable bubble layout. For more information about Catapush platform check out the official website: Catapush - reliable push notification service.
- sudo gem install cocoapods
- git clone https://github.com/Catapush/catapush-ios-sdk-example.git
- cd catapush-ios-sdk-example
- pod install
- open catapush-ios-sdk-example.xcworkspace
- Get your App Key from Catapush Dashboard from the left menu in "Your APP" -> App details
- Create the first user from "Your APP" -> User
- Insert the App Key and the user credentials into your application delegate (catapush-ios-sdk-example/catapush-ios-sdk-example/AppDelegate.m) :
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[Catapush setAppKey:@"YOUR_APP_KEY"];
[Catapush setIdentifier:@"test" andPassword:@"test"];
[Catapush setupCatapushStateDelegate:self andMessagesDispatcherDelegate:self];
[Catapush registerUserNotification:self];
NSError *error;
[Catapush start:&error];
if (error != nil) {
// Handle error...
}
[self setupUI];
[UNUserNotificationCenter currentNotificationCenter].delegate = self;
return YES;
}
- Set you Team under Signing & Capabilities and change the bundle it to a unique one.
- Configure the App Groups
- Create an Apple authentication key in order to be able to send push notifications and configure your Catapush application in the Catapush Dashboard
- Run the app
- Back to your Catapush Dashboard and send a test message from "Your APP" -> Send Push.
Note: Catapush DOES register user notification for you, so DO NOT register user notification by calling instance method of UIApplication.
- Make sure your app has an explicit app id and push entitlements in Apple's Developer Portal.
- Create an Apple Push Notification Authentication Key and configure your Catapush applicaton hosted on Catapush servers.
- Create a specific App Group for the iOS Application and the Notification Service Extension.
This section describes how to generate an authentication key for an App ID enabled for Push Notifications. If you have an existing key, you can use that key instead of generating a new one.
To create an authentication key:
- In your Apple Developer Member Center, go to Certificates, Identifiers & Profiles, and select Keys.
- Click the Add button (+) or click the "Create a key" button.
Once you have download it you have to configure your Catapush application.
- Go to https://www.catapush.com/panel/apps/YOUR_APP_ID/platforms.
- Click on iOS Token Based to enable it.
- Fill iOS Team Id, iOS Key Id, iOS AuthKey and iOS Topic.
The iOS Team Id can be found here https://developer.apple.com/account/#/membership in "Membership Information" section.
The iOS Key Id can be retrieved here https://developer.apple.com/account/resources/authkeys/list, click on the key you have created and you can find it under "View Key Details" section.
The iOS AuthKey is the content of the key file.
Example:
-----BEGIN PRIVATE KEY-----
...........................
AUTH_KEY
...........................
-----END PRIVATE KEY-----
The iOS Topic is the bundle identifier of your iOS application.
Catapush need that the Notification Service Extension and the main application can share resources.
In order to do that you have to create and enable a specific app group for both the application and the extension.
The app and the extension must be in the same app group.
You should also add this information in the App plist and the Extension plist (group.example.group should match the one you used for example group.catapush.test in the screens):
<key>Catapush</key>
<dict>
<key>AppGroup</key>
<string>group.example.group</string>
</dict>You can easily configure the UI appearance by changing TextFont, Background color attributes. You can find this code commented in catapush-ios-sdk-example/catapush-ios-sdk-example/AppDelegate.m
[[MessageCell appearance] setBubbleViewCornerRadius:10];
[[MessageCell appearance] setBubbleViewBorderColor:[UIColor colorWithWhite:0 alpha:0.2]];
[[MessageCell appearance] setBubbleViewColor:[UIColor lightGrayColor]];
[[MessageCell appearance] setBubbleViewBorderWidth:0.5];
[[MessageCell appearance] setMessageTextColor:[UIColor whiteColor]];
[[MessageCollectionView appearance] setBackgroundColor:[UIColor colorWithRed:249.0/255.0 green:250.0/255.0 blue:252.0/255.0 alpha:0]];
[[MessageCollectionView appearance] setMessageTextFont:[UIFont fontWithName:@"HelveticaNeue" size:18]];
[[MessageNavigationBar appearance] setBarTintColor:[UIColor redColor]];
[[MessageNavigationBar appearance] setTitleTextAttributes: @{
NSForegroundColorAttributeName:[UIColor greenColor],
NSFontAttributeName:[UIFont fontWithName:@"HelveticaNeue-CondensedBlack" size:21.0]
}];
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// ...
// Customize Bubble
[[MessageCell appearance] setMessageTextColor:[UIColor whiteColor]];
[[MessageCell appearance] setBubbleViewCornerRadius:2];
[[MessageCell appearance] setBubbleViewColor:[UIColor lightGrayColor]];
// Customize Navigation Bar - Add Shadow to Navigation Bar Title
NSShadow *shadow = [NSShadow new];
shadow.shadowColor = [UIColor colorWithWhite:0 alpha:0.8];
shadow.shadowOffset = CGSizeMake(0, 1);
NSDictionary *attrbutes = @{NSForegroundColorAttributeName:[UIColor colorWithRed:245.0/255.0
green:245.0/255.0
blue:255.0/255.0
alpha:1],
NSShadowAttributeName:shadow,
NSFontAttributeName:[UIFont fontWithName:@"HelveticaNeue-CondensedBlack" size:21.0]
};
[[MessageNavigationBar appearance] setTitleTextAttributes: attrbutes];
[[MessageNavigationBar appearance] setBarTintColor:[UIColor redColor]];
}
Use Long tap to copy a text into clipboard.
