Page Comparison

These instructions are for using Appoxee SDK with Adobe Air applications.Acknowledgments

The ANE was created on FB 4.7 using Air Compiler

...

The code samples are in ActionScript under an ActionScript Mobile Project.

...

A. The Appoxee SDK jar file

B. The Appoxee ANE jar file

C. The Appoxee SDK resources

...

20.
Appoxee SDK Version used by this plugin is 2.7.0.

Prerequisites

Having an Appoxee Application setup properly with everything that is needed for creating an Android Application, as explained here.

ANE Package Content

Appoxee SDK Jar file
Appoxee ANE jar File
Appoxee GCM ANE file
Appoxee SDK Resources
3rd Party Libraries & Resources :
- android-support-v4
- android-support-v7-appcompat

...

Warning

title	Google Play Services and Adobe Air

Be advised :

The ANE file does not contain Google Play Services. Google Play Services needs to be added to your project in 1 of 2 ways :

To be included in your own ANE (if such exists)
To download an ANE that already contains it. for example : https://github.com/myflashlab/common-dependencies-ANE

Integration Instructions :

Download the ANE+SWC files from the Appoxee Download Page.
Create a new ActionScript Mobile Project, as shown in the image.
Name your project , as shown in the image.
In the new project's dialog under Mobile Settings tab, mark the following permissions : INTERNET , WRITE_EXTERNAL_STORAGE, WAKE_LOCK, ACCESS_NETWORK_STATE , as shown in the image. Make sure that "Google Android" is ticked under "Target Platforms"
in the new project's dialog under Build Paths tab, in the Library Path tab, Add the Appoxee SWC. add other SWC files if you use other 3rd party libs.
in the new project's dialog under Build Paths tab, in the Native Extensions tab, Add the Appoxee ANE & the Appoxee GCM ANE file. add other ANE files if you use other 3rd party libs.
After the project is generated, go into it's properties, into ActionScript Build Package ->Google Android and tick all the checkboxes of the ANE, including Appoxee's . Press OK.

In your app's XML file , inside the Android tag you will find the Android Additions. Add the following code before the </manifest> tag :

Code Block

language	xml
firstline	1
title	Manifest Additions
linenumbers	true

...
<permission android:name="air.DemoApp.permission.C2D_MESSAGE" android:protectionLevel="signature" />
<uses-permission android:name="air.DemoApp.permission.C2D_MESSAGE" />
<uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" />

<application>

	 <meta-data android:name="com.google.android.gms.version"
  	  android:value="@integer/google_play_services_version" />

   	 <service android:name="com.appoxee.gcm.PlayIntentService" />
	 <!-- 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="air.DemoApp" />
            </intent-filter>

            <!-- Receive the registration id -->
            <intent-filter>
                <action android:name="com.google.android.c2dm.intent.REGISTRATION" />
                <category android:name="air.DemoApp" />
            </intent-filter>
        </receiver>
 </application>

In your app's main .as file , add the following code :

Code Block

language	actionscript3
firstline	1
title	Code into your main .as file
linenumbers	true

//Add this to imports : 

import com.appoxee.AppoxeeANE;
import
com.appoxee.CallbackResult;
import flash.events.Event;

//Add this to class : 
private var _appoxeeANE:AppoxeeANE;

//Add the class's constructor : 

_appoxeeANE = new AppoxeeANE("5625d0c93066e6.01334678YOUR_APPOXEE_APP_KEY","5625d0c9306825.8037476","air.DemoApp.debug.AppEntry");

//Activate / De-Activate Event Registration
this.addEventListener(Event.ACTIVATE,appActivate,false,0,true);
this.addEventListener(Event.DEACTIVATE,appDeActivate,false,0,true);
...

//Add this to class : 
YOUR_APPOXEE_SECRET_KEY",handleIncomingPushMessage);
...
 
//Add this method to get notified when push messages arrive to the device
private function handleCallbackhandleIncomingPushMessage(resultpayload:CallbackResultString):void {
//Do what is needed ...
}

private function appActivate(_event:Event):void {
_appoxeeANE.onActivate();
_appoxeeANE.addCallbackFunction(handleCallback)
}

private function appDeActivate(_event:Event):void {
_appoxeeANE.onDeactivate();
_appoxeeANE.removeCallbackFunction(handleCallback);
}			trace("Handle Incoming Push Message Called with : "+result);
			//handle push payload in callback
}

Note

title	Push Notification Callback and Extra Fields Parsing

The method handleIncomingPushMessage() id the method that will be called every time a push notification will be received by the device. Further explanation on using the Incoming Push Notification Callback Method can be found here.

This conclude the basic integration of the ANE. Click here to see API usage.

Versions Compared

Old Version 7

New Version Current

Key