Using the greenID simulator-enabled Android libraries (SDK 3.x)

Owned by Matt Gray (Unlicensed)
Last updated: Dec 06, 2022 by Sharmeen Hussain
2 min read

IMPORTANT NOTICE: The mobile SDK has been deprecated and no longer offered as an integration option in greenID. For alternative options, please contact your GBG account representative.

GreenID Mobile applications can now be tested using a mobile emulator, instead of a physical mobile device. The emulator-enabled SDKs are not fully functional inside an emulator, but they can display the initial pages and they do an error handoff to the client application when the document capture process would normally begin. The words "Simulator detected" will appear in the error description.

Purpose

This alternative set of emulator SDK libraries allows developers to write the necessary integration code and run and test their applications by whatever means they choose initially. When they are ready to test the application with actual devices, they simply replace the emulator version of the SDK libraries with the fully functional ones.

Integration steps

  1. Backup existing libraries in the project
    • Comment out the three lines containing IDScan libraries in your build.gradle file: 
      com.idscan.ieos:mjcs
      com.idscan.ides:default-AUS-profile
      com.idscan.idfb:liveness-core

  2. Acquire new emulator-enabled libraries
    • As of May 2018, the emulator-enabled libraries are distributed alongside the normal greenID SDK files.

  3. Import new mock libraries
    • Open your project in Android Studio.
    • Copy the aar files labelled mock_ to your app's /libs folder.  There are some for older versions of greenID Mobile ('catfishair' and 'imagus'), and some for the newer version ('idscan')



    • Add the following line to the dependencies section of your project's ‘build.gradle’ file:
      implementation(name: 'mock_idscan_libraries-1.1(1)-release', ext: 'aar')


    • Run Gradle sync to ensure all dependencies are included correctly and resolved.



  4. Test new mock libraries
    • Create a new Virtual Device in Android studio by clicking on the following icon:



    • This will bring up a new screen as follows:



    • Click on the create virtual device button and select your device specific options.



    • Select the hardware requirements of your application. Device type etc.



    • Select your supported operating system. If it is your first time creating a virtual device, it might take a few minutes to download the Android operating system image. This happens only once though.





    • Startup your new emulator by clicking the play symbol



    • Click run on the application quick run and select the Android emulator as your target device.



Sample Code example

The greenID Sample Code example project found at http://greenidmobile.vixverify.com/ has been configured to allow both emmulator and physical device libraries to co-exist in the same project.

Inspect the project's "build.gradle" file for information on how to do this.

The project allows for two build variants, one for emulator, and one for physical devices.

Home | greenID API | greenID Web | greenID Mobile | greenID Business | greenID Additional Services | Notification of Verification | Admin Panel Guide 

If you can't find what you need here, email us at customer.support@gbgplc.com or log a ticket via our portal

On this page

greenID Mobile A-Z