The following instructions are for developers using Android Studio.
We have simplified the process by creating an AAR file which can be downloaded from our download page.
The instructions are followed by some screenshots and code samples which will result the most basic integration with the Appoxee SDK.
The Test Application located in the download page contains a full code sample of what is written here.
1.Download the .AAR file from the download page.
2. Open the Android Studio and create your application
3. Import the Appoxee SDK aar file
4. Select "Import .JAR/.AAR Package"
5. Select the Appoxee SDK aar file from the location you have saved it
6. Open your AndroidManifest.xml file after making sure the Appoxee SDK module is part of your project
7. Please add the following lines to your app's gradle.build dependencies section (after step 5 is complete) :
... dependencies { compile 'com.google.android.gms:play-services-gcm:7.5.0' compile project(':appoxeesdk') }
8. Please add the following lines to your app's AndroidManifest.xml file :
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="<app package>"> <permission android:name="<app package>.permission.C2D_MESSAGE" android:protectionLevel="signature" /> <uses-permission android:name="<app package>.permission.C2D_MESSAGE" /> <application > <!-- REQUIRED for C2DM --> <receiver android:name="com.appoxee.gcm.PlayBroadcastReceiver" android:permission="com.google.android.c2dm.permission.SEND" > <!-- Receive the actual message --> <intent-filter> <action android:name="com.google.android.c2dm.intent.RECEIVE" /> <category android:name="<app package>" /> </intent-filter> <!-- Receive the registration id --> <intent-filter> <action android:name="com.google.android.c2dm.intent.REGISTRATION" /> <category android:name="<app package>" /> </intent-filter> </receiver> </application> </manifest>
9. Please add the following code to the activity which implements AppoxeeObserver :
package com.appoxee.testapp; ... public static final String APPOXEE_APP_KEY = "YOUR_SDK_KEY"; public static final String APPOXEE_SECRET_KEY = "YOUR_SECRET_KEY"; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); new initAsync(getApplicationContext(),APPOXEE_APP_KEY,APPOXEE_SECRET_KEY,"",true,"",this).execute(); //Set Debug Logging as true for LogCAT AppoxeeManager.setDebug(true); //Parse Extra fields from incoming push messages Bundle bundle = getIntent().getExtras(); Appoxee.parseExtraFields(bundle); //The rest of your code } @Override protected void onStart() { super.onStart(); Appoxee.onStart(); //The rest of your code } @Override protected void onStop() { super.onStop(); Appoxee.onStop(); //The rest of your code } @Override protected void onNewIntent(Intent intent) { super.onNewIntent(intent); Bundle bundle = intent.getExtras(); Appoxee.parseExtraFields(bundle); //The rest of your code } ... }
10. After completing all the steps run your app for the first time and your are done!
11. If you wish to use the SDK Sync API's - press here
12. If you wish to use the SDK Async API's - press here
13. If you wish to use the Custom Push Notification Builder - press here
As mentioned earlier, our Test Application contains a full code sample. it can be downloaded from here.