VicSDK Android - Maven Setup

Follow the instruction below to setup the VIC SDK on your Android Studio project via Maven.

Gradle

1. Add the SASIS Maven repository to your project in the settings.gradle.kts file:
   
   setup.gradle.kts

   dependencyResolutionManagement {
       repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
   
       repositories {
   		// other repositories
           google()
           mavenCentral()
   	    // mavenLocal()
   
   		// sasis repository
           maven {
               name = "sasis"
               url = uri("https://pkgs.dev.azure.com/SASISAG/VICSDK/_packaging/VICSDK-Android/maven/v1")
   
               credentials(PasswordCredentials::class)
               authentication {
                   create<BasicAuthentication>("basic")
               }
           }
       }
   }

   Beta releases

   If you are a beta tester, we will provide a separate repository link and AccessToken for beta releases. The setup itself works the same way.

2. Add the credentials to the gradle.properties file. As username, everything can be used, as password, the provided access token from SASIS should be used.
   
   gradle.properties

   sasisUsername=anything
   sasisPassword=<AccessToken>

   The AccessToken will be provided via email. If you don't have an AccessToken, please contact us.

3. Add the VicSDK dependency

   Identifier	Version
   ch.sasis:vicsdk	3.1.0

   
   
   libs.version.toml

   [versions]sasis = "3.1.0"
   [libraries]
   sasis-vicsdk = { module = "ch.sasis:vicsdk", version.ref = "sasis" }

   build.gradle.kts // app-level

   dependencies {
       implementation(libs.sasis.vicsdk)
   }

4. Enable Compose if not done already
   build.gradle.kts // app-level

   android {
       buildFeatures {
           compose = true
       }
   }

Manifest

From 3.1.0:

To support Android 17 the back of the card is now generated as image with the right aspect ratio. Portrait only is not guaranteed anymore, so the android:screenOrientation="portrait" can be deleted.

Before 3.1.0:

The cardview currently only supports portrait-mode. So the Activity displaying the cards should force portrait mode in the manifest.

<activity android:name=".MyCardsActivity"
	android:screenOrientation="portrait"></activity>

ProGuard

The following ProGuard rules are required by the SDK to allow minification (not needed from version 3.1.0 anymore)

-keep class com.sun.jna.** { *; }
-keep class ch.sasis.vicsdk.** { *; }