Android SDK Integration Guide

Overview

  1. Video

  2. Steps

  3. Sample

Video

Coming Soon!

Requirements

  • API Level 18 or higher

  • Kotlin

Please update to the latest SDK!

Steps

  1. Downloads

1. Downloads

allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
.
.
.
dependencies {
implementation 'com.github.bluenumberfoundation: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.