Setup and Initialize SDK (SDK < 3.47)

Install the SDK

The CrystalExpress SDK is available through AAR or JAR :

• AAR (Recommend)

  1. Copy ce-xx-xx-x.x.aar to the libs folder of your app project

  2. Add following line to your app build.gradle. (You don't need to do add v4 support library if you already had v7 in your project)

     apply from: 'https://raw.githubusercontent.com/intowow/ce-sdk-android-config/master/aar-config.gradle'
     ...
     dependencies {
       ...
       compile 'com.android.support:support-v4:+'  
     }

  3. Declare Crystal ID received from your Intowow account manager in your Android Manifest.

     <meta-data android:name="CRYSTAL_ID" android:value="crystalidforandroidtestdontuseit" />

• JAR

  1. Copy ce-xx-xx-x.x.jar to the libs folder of your app project.

  2. Add Android v4 Support Library to your app project. (You don't need to do this step if you already added v7 support library in your project)

     dependencies {
         ...
         compile 'com.android.support:support-v4:XX.X.X'  
     }

  3. Setup Your Android Manifest

     • Declare permissions

       <uses-permission android:name="android.permission.INTERNET" />
       <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
       <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

     • Declare Activity

       <activity android:name="com.intowow.sdk.WebViewActivity"
                 android:configChanges="orientation|screenSize"
                 android:theme="@android:style/Theme.NoTitleBar.Fullscreen">
       </activity>

     • Declare Receiver

       <receiver android:name="com.intowow.sdk.ScheduleReceiver" 
                 android:exported="false">
                 <intent-filter >
                           <action android:name="com.intowow.sdk.prefetch"/>
                 </intent-filter>
       </receiver>

     • Declare Crystal ID received from your Intowow account manager.

       <meta-data android:name="CRYSTAL_ID" android:value="crystalidforandroidtestdontuseit" />

Initialize The SDK

• Please add three methods to your application's ActivityLifecycleCallbacks to initialize the sdk

  • I2WAPI.init
  • I2WAPI.onActivityResume
  • I2WAPI.onActivityPause

1.Declare your Application in the AndroidManifest.xml.

<application android:name="Your Application">
    ...
    ...
</application>

2.Add three methods to your Application's ActivityLifecycleCallbacks

import android.app.Activity;
import android.app.Application;
import android.os.Build;
import android.os.Bundle;

import com.intowow.sdk.I2WAPI;

public class BaseApplication extends Application {

  private static final boolean IS_SUPPORT_LIFECYCLE_CALLBACKS = 
    (Build.VERSION.SDK_INT >= Build.VERSION_CODES.ICE_CREAM_SANDWICH);
  private static BaseApplication mInstance = null;

  @Override
  public void onCreate() {    
    super.onCreate();
    mInstance = this;

    if(IS_SUPPORT_LIFECYCLE_CALLBACKS) {
      mInstance.registerActivityLifecycleCallbacks(new ActivityLifecycleCallbacks() {

        @Override
        public void onActivityCreated(Activity activity, Bundle savedInstanceState) {

          //  TODO
          //  Initilize intowow sdk
          //
          boolean isTestMode = false; // Set true to enable test mode
          boolean isOpenVerboseLog = false; // Set true to enable verbose log

          I2WAPI.init(activity.getApplicationContext(), isTestMode, isOpenVerboseLog);

        }

        @Override
        public void onActivityStarted(Activity activity) {
        }

        @Override
        public void onActivityResumed(Activity activity) {

          //  TODO
          //  Notify sdk that Activity has already in resume status
          //
          I2WAPI.onActivityResume(activity.getApplicationContext());

        }

        @Override
        public void onActivityPaused(Activity activity) {

          //  TODO
          //  Notify sdk that Activity has already in pause status
          //
          I2WAPI.onActivityPause(activity.getApplicationContext());

        }

        @Override
        public void onActivityStopped(Activity activity) {
        }

        @Override
        public void onActivitySaveInstanceState(Activity activity,
          Bundle outState) {
        }

        @Override
        public void onActivityDestroyed(Activity activity) {
        }
      });
    }
  }
}

If your app can not use customized Application, please contact with your Intowow account manager.