Esign Android SDK - V2 Sample App

Sample application for eSign Android SDK - V2.

Step to use the SDK below as well:

1. settings.gradle :

    pluginManagement {
        repositories {
            google()
            mavenCentral()
            jcenter()
            gradlePluginPortal()
        }
    }
    dependencyResolutionManagement {
        repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
        repositories {
            google()
            jcenter()
            mavenCentral()
            //enter github user name and github token
            maven {
                url = "https://maven.pkg.github.com/surepassio/esign-sample-app"
                credentials {
                    username = "USER_NAME"
                    password = "PAT_TOKEN"//https://docs.github.com/en/github/authenticating-to-github/keeping-your-account-and-data-secure/creating-a-personal-access-token
                    // (Allow Package Read Permission in token)
                }
            }
    
    
        }
    }
rootProject.name = "ESign Sample App"
include ':app'

2. build.grade (app):

   minSdk 26 //min sdk should be 26
   
   dependencies {
         implementation 'io.surepass.sdk:esign-android-sdk-v2:1.0.0'
   }

Make sure to sync your project after adding the dependency.

3. Inside Application:

   binding.btnGetStarted.setOnClickListener {
//            val token = binding.etApiToken.text.toString()
        val token = "YOUR TOKEN"
        val env = "PREPROD"
        openActivity(env, token)
    }

SDK will be started from openActivity function

    private fun openActivity(env: String, token: String) {
        val intent = Intent(this, InitSDK::class.java)
        intent.putExtra("token", token)
        intent.putExtra("env", env)
        eSignActivityResultLauncher.launch(intent)
    }

Response can be obtained in

   private fun registerActivityForResult() {
        eSignActivityResultLauncher =
            registerForActivityResult(
                ActivityResultContracts.StartActivityForResult(),
                ActivityResultCallback { result ->
                    val resultCode = result.resultCode
                    val data = result.data
                    if (resultCode == RESULT_OK && data != null) {
                        val eSignResponse = data.getStringExtra("signedResponse")
                        Log.e("MainActivity", "eSign Response $eSignResponse")
                        showResponse(eSignResponse)
                    }
                })
    }

For better clarification you can check the code details inside the project

Change Theme Of SDK

To customize the theme of the SDK, you can modify the themes.xml file. If your project has set up the theme in the styles.xml file instead, the steps will be the same for that as well.:

1. Locate the themes.xml file: You can usually find this file in the res/values directory of your Android project.

2. Update the theme: Inside the themes.xml file, you'll see a style defined for your application theme. It typically looks like this:

   <resources xmlns:tools="http://schemas.android.com/tools">
       <!-- Base application theme. -->
       <style name="Base.Theme.ESignSampleApp" parent="Theme.Material3.DayNight.NoActionBar">
           <!-- Customize your SDK theme here. -->
            <item name="colorPrimary">@color/background_color</item>
       </style>
   
       <style name="Theme.ESignSampleApp" parent="Base.Theme.ESignSampleApp" />
   </resources>

3. Change the primary color: Modify the <item name="colorPrimary">@color/background_color</item> line to change theme. Replace @color/background_color with the color resource you want to use.

   For example, if you want to change the primary color to red, you can use:

   <item name="colorPrimary">@color/red</item>

   Ensure that the color resource you refer to exists in your colors.xml file or define it if it doesn't.

4. Save your changes.

5. Rebuild your project: After making changes to the theme, rebuild your project to apply the updated theme throughout your application.