Android SDK Quickstart Guide

dependencies {
implementation 'com.webex.connect:core-gms-full:2.20.1'
} // Use the appropriate version

dependencies {
implementation 'com.webex.connect:core-gms-lite:2.20.1'
} // Use the appropriate version

dependencies {
implementation 'com.webex.connect:core-hms-full:2.20.1'
} // Use the appropriate version

dependencies {
implementation 'com.webex.connect:core-hms-lite:2.20.1'
} // Use the appropriate version

dependencies {
    //...
    implementation files('IMIconnectCore.aar')
    //...
}

buildscript { 
  repositories { 
    // ... 
    maven {url 'https://maven.google.com/'} 
  } 
  dependencies { 
    // ... 
    classpath 'com.google.gms:google-services:4.3.10’ } 
  } 
  allprojects { 
    repositories { 
      // ... 
      maven {url 'https://maven.google.com/'}
  }
}

buildscript { 
  repositories { 
    // ... // Configure the Maven repository address for the HMS Core SDK. 
    maven {url 'https://developer.huawei.com/repo/'} 
  } 
  dependencies { 
    // ... // For HMS // Add the AppGallery Connect plugin configuration. 
    classpath 'com.huawei.agconnect:agcp:1.4.2.300' } 
} 
allprojects { 
  repositories { 
    // ... // For HMS // Configure the Maven repository address for the HMS Core SDK. 
    maven {url 'https://developer.huawei.com/repo/'} 
  } 
}

app/build.gradle
apply plugin: 'com.android.application' 
apply plugin: 'com.google.gms.google-services' 
android { 
  // ... 
} 
dependencies { 
  // ...  
  implementation "androidx.sqlite:sqlite:2.1.0" 
  implementation "androidx.work:work-runtime:2.7.0" 
  implementation "androidx.constraintlayout:constraintlayout:2.1.4"
  implementation "com.squareup.picasso:picasso:2.5.2" 
  implementation "net.zetetic:android-database-sqlcipher:4.4.3@aar" 
  implementation "com.google.firebase:firebase-messaging:23.1.0"
  implementation "com.google.android.gms:play-services-base:18.1.0" 
  implementation "com.google.android.gms:play-services-location:21.0.0"
  implementation "androidx.core:core:1.10.1"
}

app/build.gradle
apply plugin: 'com.android.application' 
apply plugin: 'com.huawei.agconnect' 
android { 
  // ... 
} 
dependencies { 
  // ... 
  implementation "androidx.sqlite:sqlite:2.1.0" 
  implementation "androidx.work:work-runtime:2.7.0" 
  implementation "androidx.constraintlayout:constraintlayout:2.1.4"
  implementation "com.squareup.picasso:picasso:2.5.2" 
  implementation "net.zetetic:android-database-sqlcipher:4.4.3@aar" 
  implementation "androidx.core:core:1.10.1"
  // HMS dependency 
  implementation "com.huawei.hms:push:6.5.0.300" 
}

<!-- OPTIONAL Add the server domain from IMIconnect -->

<meta-data android:name="serverdomain" android:value="Your IMIconnect’s domain" />

<!-- PERMISSIONS -->
<!-- REQUIRED for connecting to imiconnect -->
<uses-permission android:name="android.permission.WAKE_LOCK"/>
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>
<!-- OPTIONAL add this permission if you wish to capture IMSI and IMEI details -->
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<!-- OPTIONAL add this permission if you wish to monitor network attributes -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<!-- OPTIONAL add this permission if you wish to monitor account attributes such as email-->
<uses-permission android:name="android.permission.GET_ACCOUNTS"/>
<!-- OPTIONAL add this permission if you wish to monitor location and/or cell id changes -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- OPTIONAL add this permission if you wish to monitor location changes to a fine degree of accuracy -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!-- Replace YOUR_APPLICATION_CLASS_NAME with the name of your actual class that derives from the Application class. Do not worry if you do not already use an Application subclass in your project, we will create one later in this guide -->
<application
   android:name="YOUR_APPLICATION_CLASS_NAME"
   android:allowBackup="true"
   android:label="@string/app_name"
   android:theme="@style/AppTheme">
   <activity
       android:name="YOUR_ACTIVITY_NAME"
       android:label="@string/app_name">
       <intent-filter>
           <!-- OPTIONAL Include this section if you wish to use deeplinks -->
           <data
               android:host="command"
               android:scheme="@string/app_id"/>
           <category android:name="android.intent.category.DEFAULT"/>
           <category android:name="android.intent.category.BROWSABLE"/>
           <action android:name="android.intent.action.MAIN"/>
           <category android:name="android.intent.category.LAUNCHER"/>
       </intent-filter>
   </activity>
   <receiver
       android:name="com.imimobile.connect.core.messaging.ICMessagingReceiver"
       android:enabled="true"
       android:exported="false"
             android:permission="com.imimobile.connect.core.permission.PUSH_PERMISSION">
       <intent-filter>
           <action android:name="com.imimobile.connect.core.rtmevent"/>
           <action android:name="com.imimobile.connect.core.notification.click"/>
           <action android:name="com.imimobile.connect.core.intent.notification.RECEIVE"/>
       </intent-filter>
   </receiver>

</application>

# MANDATORY The App ID that is generated by IMIconnect for your application
appId=<APP_ID>
# MANDATORY The Client Key that is generated by IMIconnect for your application
clientKey=<CLIENT_KEY>
# OPTIONAL Add the IMIconnect's server environment, by default is AWS UK
environment=
# OPTIONAL Add the server domain to override zero-rating domain
serverDomain=
# OPTIONAL Add the allowUnencryptedDatabaseFallback to allow creating a default SQLite database when SQLcipher fails, by default is false.
allowUnencryptedDatabaseFallback=true
shouldRequestNotificationPermission=true
#OPTIONAL To enable the push notification permission requested on registration.

-dontwarn org.eclipse.jetty.** 
-dontwarn com.google.firebase.messaging.FirebaseMessaging 
-dontwarn javax.servlet.** 
-dontwarn org.slf4j.** 
  
# for sqlcipher 
-keep class net.sqlcipher.** { *; } 
-keep class net.sqlcipher.database.* { *; } 

# WorkManager 
-keep class * extends androidx.work.Worker 
-keep class * extends androidx.work.InputMerger 
-keep public class * extends androidx.work.ListenableWorker { 
  public <init>(...); 
} 
-keep class androidx.work.WorkerParameters

# For MQTT
-keep class org.eclipse.paho.client.mqttv3.** {*;}
-keep class org.eclipse.paho.android.service.** { *; }
-keepclasseswithmembers class org.eclipse.paho.** {*;}

For HMS :

-dontwarn org.eclipse.jetty.** 
-dontwarn javax.servlet.** 
-dontwarn org.slf4j.** 
  
# for sqlcipher 
-keep class net.sqlcipher.** { *; } 
-keep class net.sqlcipher.database.* { *; } 

# WorkManager 
-keep class * extends androidx.work.Worker 
-keep class * extends androidx.work.InputMerger 
-keep public class * extends androidx.work.ListenableWorker { 
  public <init>(...); 
} 
-keep class androidx.work.WorkerParameters 
  
#Proguard rules for HMS 
-ignorewarnings -keepattributes *Annotation* 
-keepattributes Exceptions 
-keepattributes InnerClasses 
-keepattributes Signature 
-keepattributes SourceFile,LineNumberTable 
-keep class com.hianalytics.android.**{*;} 
-keep class com.huawei.updatesdk.**{*;} 
-keep class com.huawei.hms.**{*;}

# For MQTT
-keep class org.eclipse.paho.client.mqttv3.** {*;}
-keep class org.eclipse.paho.android.service.** { *; }
-keepclasseswithmembers class org.eclipse.paho.** {*;}

public class MyApplication extends Application 
{
    @Override
    public void onCreate() 
    {
        super.onCreate();
      
        // Initialize the imiconnect SDK 
        try 
        {
            IMIconnect.startup(this);
        } catch (ICException e) 
        {
            e.printStackTrace();
        }
    }
}

//Sample code to register Notification channel:

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) 
{
  // Provide your channel name & description that will be visible to the user. These will need configuring in your strings.xml 
  String name = getString(R.string.channel_name);
  String description = getString(R.string.channel_description);

  // A channel registered with the id of ICConstants.DEFAULT_CHANNEL_ID is required as a minimum
  NotificationChannel channel = new NotificationChannel(ICConstants.DEFAULT_CHANNEL_ID, name, NotificationManager.IMPORTANCE_DEFAULT);
  
  channel.setDescription(description);
  
  // Register the channel with the system
  NotificationManager notificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
  
  notificationManager.createNotificationChannel(channel);
}

IMIconnect.register(new ICDeviceProfile(ICDeviceProfile.getDefaultDeviceId()), new ICRegistrationCallback()
{
   @Override
   public void onRegistrationComplete(final Bundle bundle, final ICException exception)
   {
     if (exception != null) 
     {
       Log.e("Registration", "Registration failed! Reason:" + exception.toString());
     } 
     else 
     {
       Log.d("Registration", "Registration succeeded!");
     }
   }
});

IMIconnect.register(new ICDeviceProfile(ICDeviceProfile.getDefaultDeviceId(),enteredUserId), new ICRegistrationCallback()
{
   @Override
   public void onRegistrationComplete(final Bundle bundle, final ICException exception)
   {
     if (exception != null) 
     {
       Log.e("Registration", "Registration failed! Reason:" + exception.toString());
     } 
     else 
     {
       Log.d("Registration", "Registration succeeded!");
     }
   }
});