Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Linked to original documentation.

...

Typical Integration Steps

  1. Follow the initial setup as described the Android Integration documentation, take especially care of:
    1. Dependencies
    2. The handling of native libraries.
    3. Upgrading pro-guard.
  2. Implement the GreenIDListener interface on your activity, for example:

    Code Block
    languagejava
    themeConfluence
    titleGreenIDActivity.kt
    class GreenIDActivity :  AppCompatActity(), GreenIDListener {
    	
    	override fun onGreenIDSuccess(resultCode: Int, verificatationToken: String?, verificationStatus: String?) {
        	// Your business logic here 
    	}	
    
    	override fun onGreenIDFailed(resultCode: Int, message: String?, description: String?) {
    		// Handle all failures
    		when (result) {
    			ResultCode.NO_NETWORK -> noNetwork()
    			ResultCode.BACK -> userPressedBack()
    			else -> handleGeneralGreenIDError(resultCode,message)
    		}
    	}
    }
    


    Note
    • Override is a required keyword in Kotlin.
    • When overriding a function, you do not have specify the access scope:
      • Public stays public,
      • Protected stays protected!


  3. Write a function to start the GreenID™ SDK:

    Code Block
    languagejava
    titleGreenActivity.kt
    // In GreenActivity.kt
    
    private fun startGreenID() {
    
    	val configBundle = Bundle().apply {
    		putString("accountId", "account-id-as-provided")
    		putString("baseUrl", "https://simpleui-uat1.vixverify.com/") // Change this
    		putString("apiCode", "api-code-as-provided")          
    		putString("countryCode", "XX")
    		putString("mode", "onboarding")         
    	}
    
        try {
        	GreenID.getInstance(applicationContext).start(configBundle, this)	
        catch(e: GreenIDConfigException) {
    		// You have to handle this!
    	}
    }


  4. Start the GreenID™, for example on a button/view click:

    Code Block
    // onCreate: 
    
    startGreenIdBtn.setOnClickListener { startGreenID() }


...