Versions Compared

Version Old Version 2 New Version 3
Changes made by

Former user

Former user

Saved on

Key

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

Introduction

...

As of V2.2, we have added support for Google Play Services, since Google has announced the GCM.jar is deprecated. Since Google didn't retire the service completely and still accept requests created by GCM.jar classes, we have backward compatibility for now.

If you choose to use Google Play Services, you need to know the
Infowarning
titleUsing Google Play Services
Integration Change

As of version 2.2 , GCM.jar isn't included in the /libs folder of the Appoxee SDK. The SDK doesn't include Google Play Services lib as well. It is up to you, the developer to choose which library to use, according to the minimal Android OS version you wish to be compatible too.

 

 

Info
titleUsing Google Play Services

If you choose to use Google Play Services, you need to know the following :

  1. To test your app when using the Google Play services SDK, you must use either:

    • A compatible Android device that runs Android 2.3 or higher and includes Google Play Store.
    • The Android emulator with an AVD that runs the Google APIs platform based on Android 4.2.2 or higher.

  2. To make the Google Play services APIs available to your app:

    1. Copy the library project at <android-sdk>/extras/google/google_play_services/libproject/google-play-services_lib/ to the location where you maintain your Android app projects.
    2. Import the library project into your Eclipse workspace (if you use Eclipse) : Click File > Import, select Android > Existing Android Code into Workspace, and browse to the copy of the library project to import it.
    3. In your app project, reference Google Play services library project.

      Note: You should be referencing a copy of the library that you copied to your development workspace—you should not reference the library directly from the Android SDK directory.

  3. To prevent ProGuard from stripping away required classes, add the following lines in the<project_directory>/proguard-project.txt file:

     

    Code Block
    languagetext
    titleProGuard
    -keep class * extends java.util.ListResourceBundle {
    protected Object[][] getContents();
}

-keep public class com.google.android.gms.common.internal.safeparcel.SafeParcelable {
    public static final *** NULL;
}

-keepnames @com.google.android.gms.common.annotation.KeepName class *
-keepclassmembernames class * {
    @com.google.android.gms.common.annotation.KeepName *;
}

-keepnames class * implements android.os.Parcelable {
    public static final ** CREATOR;
}



 

...

  1. Your MainActivity needs to exted AppoxeeBaseActivity and implement AppoxeeObserver
  2. Your MainActivity onCreate() method should contain : 

     

    new initAsync(getApplicationContext(),"APP_KEY",

                         "SECRET_KEY", "com.package.MainActivity" , true, this).execute();

    AppoxeeManager.setDebug(true);

    Appoxee.parseExtraFields(getIntent().getExtras());

    setContentView(R.layout.main);

    .....



  3. Make sure that the following methods are implemented and contain Appoxee's method calls :

    @Override

       protected void onResume()

          {

        super.onResume();

     // If Inbox implemented and you have a method for updating your inbox’s

     // Badge

          updateMsgBadge();

          }

     

    d. @Override

     public void onRegistrationCompleted() {

      // TODO Auto-generated method stub

        Utils.Debug("Can perform all API Calls");

        

     }

     

     @Override

     public void onMessagesUpdateCompleted() {

               // If Inbox implemented and you have a method for updating your inbox’s

     // Badge

     

          Utils.Debug("Can update Badge");

          updateMsgBadge();

     

     }




    Note

    To fully use Appoxee’s Analytics , all of your activities should implement onStart() & onStop in the actvities code :

     

    @Override

    protected void onStart()

                  {

       super.onStart();

       Appoxee.onStart();

                 }

       

    @Override

                 protected void onStop()

                 {

       super.onStop();

       Appoxee.onStop();

                 }

     

    In order to avoid these additions in each activity, you can simply extend AppoxeeBaseActivity instead of Activity. (AppoxeeBaseActivity extends Android’s FragmentActivity and contains the onStart() & onStop() calls)

    Option B: Implicit Integration (without using Observer)

    1. In your main activity class onCreate() method enter the following code :

      new initAsync(getApplicationContext(),"APP_KEY",

                           "SECRET_KEY", true, "com.package.MainActivity").execute();

      AppoxeeManager.setDebug(true);

      Appoxee.parseExtraFields(getIntent().getExtras());

      setContentView(R.layout.main);

      .....



    2. Make sure that the following methods are implemented and contain Appoxee's method calls :

       

      @Override  protected void onStart() 

        {

       

        super.onStart();

       

        Appoxee.onStart();

       

        }

       

       @Override

       

        protected void onStop()

       

        {

       

        super.onStop();

       

        Appoxee.onStop();

       

        }

        @Override
       

           protected void onNewIntent(Intent intent)

       

           {

       

               super.onNewIntent(intent);

       

               Bundle bundle = intent.getExtras();

       

               Appoxee.parseExtraFields(bundle);

      }

      @Override 

      protected void onResume()

       

       {

        super.onResume();

       

       // If Inbox implemented and you have a method for updating your inbox’s

       

       // Badge

       

        updateMsgBadge();

       

       }

       

      Note

      When Integrating Appoxee and choosing not to use an Observer, All Appoxee API Calls will fail unless implementing a thread that will sample the flag

      Appoxee.isReady()==true. Only then will the API Calls will execute (Tags,Alias... )


      Note

      To fully use Appoxee’s Analytics , all of your activities should implement onStart() & onStop in the actvities code :

      Code Block
      languagejava
      linenumberstrue
      @Override 
protected void onStart()
  {
   super.onStart();
   Appoxee.onStart();
  }
    
@Override
protected void onStop()
  {
   super.onStop();
   Appoxee.onStop();
  }

       

      @Override

      protected void onStart()

                    {

         super.onStart();

         Appoxee.onStart();

                   }

         

      @Override

                   protected void onStop()

                   {

         super.onStop();

         Appoxee.onStop();

                   }

       

      In order to avoid these additions in each activity, you can simply extend AppoxeeBaseActivity instead of Activity. (AppoxeeBaseActivity extends Android’s FragmentActivity and contains the onStart() & onStop() calls)

     

...