Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

  • The ANE was created on FB 4.7 using Air Compiler

...

  • 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


Integration Instructions : 

  1. Download the ANE+SWC files from the Appoxee Download Page.
  2. Create a new ActionScript Mobile Project, as shown in the image.
    Image Added
  3. Name your project , as shown in the image.
    Image Added
  4. 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"
    Image Added
  5. 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.
    Image Added
  6. 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.
    Image Added
  7. 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.
    Image Added
  8. 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
    languagexml
    firstline1
    titleManifest Additions
    linenumberstrue
    ...
    <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> 
  9. In your app's main .as file , add the following code

    Code Block
    languageactionscript3
    firstline1
    titleCode into your main .as file
    linenumberstrue
    //Add this to imports : 
    import com.appoxee.AppoxeeANE;
    ...
    
    //Add this to class : 
    private var _appoxeeANE:AppoxeeANE;
    
    //Add the class's constructor : 
    _appoxeeANE = new AppoxeeANE("YOUR_APPOXEE_APP_KEY","YOUR_APPOXEE_SECRET_KEY",handleIncomingPushMessage);
    ...
     
    //Add this method to get notified when push messages arrive to the device
    private function handleIncomingPushMessage(payload:String):void {
    			trace("Handle Incoming Push Message Called with : "+result);
    			//handle push payload in callback
    }
    
    Note
    titlePush 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.

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