Welcome to PushApps SDK's and Tutorials! Below you can find the integration instructions for Androido and iOS. For your convenience, you can find our demo projects, in which the SDK is already integrated.

If you have any questions, comments, requests or anything else on your mind - please contact support@pushapps.mobi

1. Add the pushapps.jar file to your project libs folder.

2. In your main activity, inside the method onCreate() write the following line:

   PushManager.init(getApplicationContext(), GOOGLE_API_PROJECT_ID, PUSHAPPS_APP_TOKEN);

   GOOGLE_API_PROJECT_ID - your Google API Console Project ID, obtained from https://cloud.google.com/console
   PUSHAPPS_APP_TOKEN - your App's App Token in the PushApps admin console
   Don't forget to import com.groboot.pushapps.PushManager;
   

3. Add the following lines to the manifest XML file:

   <permission
       android:name="<your package>.permission.C2D_MESSAGE"
       android:protectionLevel="signature" />
   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.VIBRATE" />
   <uses-permission android:name="android.permission.READ_PHONE_STATE" />
   <uses-permission android:name="android.permission.GET_ACCOUNTS" />
   <uses-permission android:name="android.permission.WAKE_LOCK" />
   <uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" />
   <uses-permission android:name="<your package>.permission.C2D_MESSAGE" />

4. Inside the manifest XML file, In your application tag add the following receiver, service and activity:

   <receiver
       android:name="com.groboot.pushapps.GCMBroadcastReceiver"
       android:permission="com.google.android.c2dm.permission.SEND" >
       <intent-filter>
           <action android:name="com.google.android.c2dm.intent.RECEIVE" />
           <action android:name="com.google.android.c2dm.intent.REGISTRATION" />
           <category android:name="<your package>" />
       </intent-filter>
   </receiver>
   
   <service android:name="com.groboot.pushapps.GCMBaseIntentServiceImpl" />
   
   <activity
       android:name="com.groboot.pushapps.PushActivity"
       android:configChanges="orientation|keyboardHidden" />
   

5. Optional : to unregister a user (or register again) from the PushApps service simply call

   PushManager mPushManager = PushManager.getInstance(getApplicationContext());
   	mPushManager.register(getApplicationContext()); // For registration
   	mPushManager.unregister(getApplicationContext()); // For unregistration
   

HOW TO FIRE CALLBACKS FOR AFTER PUSH NOTIFICATIONS EVENTS:

If you would like to set some of your own code after device was registered / unregistered, or maybe build by yourself the notification, simply follow the same steps above, but in STEP 1, instead of putting this code in your main activity, put it inside the onCreate method in you application file (extends from android.app.Application).

You can use the registration interface for register / unregister callbacks, or the message interface to get notify on incoming messages (you can also implement BOTH).

Please refer to our full guide for examples, or contact us at support@pushapps.mobi

1. Add PushApps.framework to your xcode project. Please make sure that the "Copy items into destination group's folder (if needed)" is NOT checked.

2. Make sure you include AdSupport.framework in your project.

3. Place #import PushApps/PushApps.h in your AppDelegate.h file. If you need, you can also declare on delegation , in order to get notified on push and more events.

4. In your application didFinishLaunchingWithOptions method inside the AppDelegate, add the following line:

   [[PushAppsManager sharedInstance] setDelegate:self]; // optional
   [[PushAppsManager sharedInstance] startPushAppsWithAppToken:@"YOUR_APP_TOKEN" withLaunchOptions:launchOptions];

5. In your AppDelegate, at the end of the file, at the following line:

   #pragma push notification
   
   - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
       NSString *userToken = [[deviceToken description] stringByTrimmingCharactersInSet:[NSCharacterSet characterSetWithCharactersInString:@"<>"]];
       userToken = [userToken stringByReplacingOccurrencesOfString:@" " withString:@""];
       [[PushAppsManager sharedInstance] updatePushToken:deviceToken];
   }
   
   - (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo {
       [[PushAppsManager sharedInstance] handlePushMessageOnForeground:userInfo];
   }