Migrating from the v1.x.x SDK to the Inform SDK (v2.x.x)

📘

Make sure you are on an up-to-date v1 SDK before migrating!

Before migrating to the Inform SDK, make sure you first update your mobile project to one of the following v1 SDK versions and test internally (you do not need to deploy to the app stores):

• Native Android: v1.17.2 or higher
• Native iOS: v1.17.3 or higher

Taking this step ensures your app is in a fully functional position with the v1 SDK before migrating to the Inform SDK and makes it easier to troubleshoot if anything should arise after you migrate to the Inform SDK.

The Inform version (2.0.0 and newer) of the Validic Mobile Library is designed to improve interoperability with the rest of the Validic ecosystem. It includes improved Record models that closely match the models used in the rest of the Validic Inform system, but offers a clear production upgrade path by maintaining backward-compatibility with the v1 models so that existing user records are not lost.

❗️

Valid user session required

A valid session is required in order to use any of the modules in the Validic SDK.

A Validic user must first be provisioned using the Validic API. Then you can start a session in the SDK using their Inform user credentials.

All mobile operations will fail if a valid user session has not been started first.

Each module contains a README with usage information for v1 and Inform.

Migration guides from the v1.x.x SDK to the Inform SDK along with tutorials can be found here:

• Native Android
  • Migration Guide
  • Tutorials

Note: The Native Android SDK is backwards compatible so that you can mix and match v1.x and Inform SDK modules if you want to transition over to the Inform SDK over time.

• Native iOS
  • Migration Guide
  • Tutorials

Note: The Native Android SDK is backwards compatible so that you can mix and match v1.x and Inform SDK modules if you want to transition over to the Inform SDK over time.

• React Native
  • Migration Guide
  • Tutorials

Note: When updating to the v2.x Inform SDK, all Validic React Native modules in your project must be updated to v2.x at the same time. You cannot mix and match v1.x and v2.x React Native modules in your project.

• Cordova
  • Migration Guide
  • Tutorials

Note: When updating to the v2.x Inform SDK, all Validic Cordova modules in your project must be updated to v2.x at the same time. You cannot mix and match v1.x and v2.x Cordova modules in your project.