mobile-credential-holder-react-native

Table of Contents

• Licensing
• Features
• Getting started
• Contributing

Licensing

Request or download the MATTR Pi SDK Trial Licence Agreement and the MATTR Customer Agreement and review these terms

Setup

Features

• Manage Trusted Issuers
• Manage Mobile Credentials

Getting started

How to get access to MATTR Pi Mobile Credential Holder SDK

Refer to our SDK Docs landing page for step-by-step instructions to gain access to any of our SDKs.

Please reach out to us in case you need any assistance Get in touch.

Install dependencies

Add this SDK as a dependency to the react native app:

yarn add @mattrglobal/mobile-credential-holder-react-native
Copy

Linking the package manually is not required from React Native 0.60 and higher that supports Autolinking.

Platform iOS

You need to install the pods (via Cocoapods) to complete the linking.

npx pod-install ios
Copy

Platform Android

Additional configuration steps are required to bundle the native libraries.

Kotlin Support

This React Native library is written in Kotlin, so you must enable the Kotlin Gradle plugin. If your project was generated using the official React Native 0.73.0 template, you might have it enabled already.

Open the android/build.gradle script and apply the following changes:

 buildscript {
   ext {
+    kotlinVersion = "1.9.0"

     buildToolsVersion = "34.0.0"
     minSdkVersion = 24
     compileSdkVersion = 34
     targetSdkVersion = 34
     ndkVersion = "25.1.8937393"
   }
   repositories {
     google()
     mavenCentral()
   }
   dependencies {
     classpath("com.android.tools.build:gradle:7.3.1")
     classpath("com.facebook.react:react-native-gradle-plugin")

+    classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlinVersion")
+    classpath("org.jetbrains.kotlin:kotlin-android-extensions:$kotlinVersion")
   }
 }
Copy

Open the android/app/build.gradle script and apply the following changes:

  apply plugin: "com.android.application"
+ apply plugin: "org.jetbrains.kotlin.android"
  apply plugin: "com.facebook.react"
Copy

Minimum requirements

• kotlinVersion >= 1.9.0
• minSdkVersion >= 24

Local Maven Repository

The precompiled MATTR Mobile Credential Holder Android Native SDK is provided in the published NPM package.

Open the android/build.gradle script and append the following changes:

 allprojects {
   repositories {
     …
     google()
+    maven {
+      url = "$rootDir/../node_modules/@mattrglobal/mobile-credential-holder-react-native/android/frameworks"
+    }
   }
 }
Copy

Contributing

Tests & Verifications

To run all Jest unit tests in this project:

yarn test
Copy

Sync native SDKs

iOS

Requires access to the https://github.com/mattrglobal/ios-mobile-credential-holder-sdk repository.

yarn sync:iosMobileCredentialHolderSDK:stable
or
yarn sync:iosMobileCredentialHolderSDK:unstable
Copy

Android

Requires access to the https://github.com/mattrglobal/android-mobile-credential-sdks repository.

Create a PAT github token(classic) with repo access, https://github.com/settings/tokens/new, make sure allow MATTR SSO access.

export GITHUB_TOKEN=xxx
yarn sync:androidMobileCredentialHolderSDK:stable
or
yarn sync:androidMobileCredentialHolderSDK:unstable
Copy

Change Log

[Unreleased]