Android SDK Integration Guide

Overview

1. Requirements

2. Steps

3. Sample

Requirements

• API Level 18 or higher

• Kotlin

Please update to the latest SDK!

Steps

1. Downloads

2. Get Credentials

3. Configuration

4. Using the SDK in Kotlin

5. Using the SDK in Java

1. Downloads

allprojects {
               repositories {
               ...
                   maven { url 'https://jitpack.io' }
               }
           }
           .
           .
           .
           dependencies {
               implementation 'com.github.human-internet:humanid-android-sdk:0.0.4’
           }

2. Get Credentials

Get the clientID and clientSecret through the App Registration Form

3. Configuration

Add this code to your AndroidManifest.xml. Make sure that all metadata is fulfilled.

<meta-data  
           android:name="com.humanid.sdk.applicationIcon"  
           android:resource="@drawable/ic_app_icon"/>
<meta-data
           android:name="com.humanid.sdk.applicationName"
           android:value="@string/app_name"/>
<meta-data  
           android:name="com.humanid.sdk.applicationId"
           android:value="YOUR_APP_ID"/>
<meta-data
           android:name="com.humanid.sdk.applicationSecret"
           android:value="YOUR_APP_SECRET"/>

4. Using the SDK in Kotlin

Add this code to your Activity or Fragment file. We recommend you wrap this in a function that handles the login button.

LoginManager.getInstance(this).registerCallback(object : LoginCallback {
               override fun onCancel() {  }

             override fun onSuccess(exchangeToken: String) {
                 //todo: send the exchangeToken to your server
               }

             override fun onError(errorMessage: String) {  }
             })
             ...
             ..
             .
             override
             fun onActivityResult(requestCode: Int, resultCode:Int, data: Intent?) {
               LoginManager.getInstance(this).onActivityResult(requestCode, resultCode, 
data)
               super.onActivityResult(requestCode, resultCode, data)
             }

5. Using the SDK in Java

Add this code to your Activity or Fragment file. We recommend you wrap this in a function that handles the login button.

LoginManager.INSTANCE.getInstance(this).registerCallback(new LoginCallback() {
               @Override
               public void onCancel() {}

             @Override
               public void onSuccess(@NotNull String exchangeToken) {
                 //todo: send the exchangeToken to your server
               }

             @Override
               public void onError(@NotNull String errorMessage) {}

           });
           ...
           ..
           .
           @Override
           protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent 
data) {
                LoginManager.INSTANCE.getInstance(this).onActivityResult(requestCode, 
resultCode, data);
                super.onActivityResult(requestCode, resultCode, data);
            }

6. You Are All Set!

Your Android app should now be integrated with the humanID login.

Sample

See our Github for a full sample to learn more!

• Warning! To run the example project, clone the repo, and run pod install from the Example directory first.