SDKS-4759 - Implement end-to-end instrumented tests for the MFA authentication migration module.

The new test suite verifies the full migration pipeline from legacy ForgeRock Authenticator SDK storage (encrypted SharedPreferences and AndroidKeyStore) to the modern Ping SDK SQLite storage.

Key changes:
- Added `MigrationTest.kt` containing comprehensive instrumented tests for TOTP, HOTP, Push credentials, Push notifications, and device token migration.
- Integrated `MockWebServer` to simulate PingAM registration endpoints for authenticating legacy Push mechanisms during tests.
- Implemented robust cleanup logic to ensure test isolation by removing SharedPreferences, KeyStore entries, and SQLite databases before and after each test.
- Verified migration idempotency, progress event emission order, and automatic cleanup of legacy data upon successful migration.
- Updated `build.gradle.kts` with necessary `androidTest` dependencies including `mockwebserver`, `nimbus-jose-jwt`, and the legacy `forgerock-authenticator` SDK.
- Configured JNI library packaging options in `build.gradle.kts` to resolve duplicate `.so` file conflicts during instrumentation tests.

Author: witrisna

mfa/auth-migration/build.gradle.kts

@@ -1,3 +1,10 @@
+/*
+ * Copyright (c) 2026 Ping Identity Corporation. All rights reserved.
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file for details.
+ */
+
 description = "Legacy Authentication Migration"
 
 plugins {
@@ -41,5 +48,10 @@ dependencies {
     testImplementation(libs.mockk)
     testImplementation(libs.robolectric)
     testImplementation(project(":foundation:android"))
-    testImplementation(libs.forgerock.authenticator)
+
+    androidTestImplementation(libs.mockwebserver)
+    androidTestImplementation(libs.kotlinx.coroutines.test)
+    androidTestImplementation(libs.kotlin.test)
+    androidTestImplementation(libs.androidx.junit)
+    androidTestImplementation(libs.androidx.test.runner)
 }

mfa/auth-migration/src/androidTest/AndroidManifest.xml

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  ~ Copyright (c) 2019 - 2026 Ping Identity Corporation. All rights reserved.
+  ~
+  ~ This software may be modified and distributed under the terms
+  ~ of the MIT license. See the LICENSE file for details.
+  -->
+
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <application
+        android:allowBackup="false"
+        android:label="Test"
+        android:supportsRtl="true"
+        android:usesCleartextTraffic="true">
+
+    </application>
+
+</manifest>

mfa/auth-migration/src/androidTest/kotlin/com/pingidentity/auth/migration/MigrationTest.kt

@@ -1,16 +1,20 @@
 /*
  * Copyright (c) 2026 Ping Identity Corporation. All rights reserved.
+ *
  * This software may be modified and distributed under the terms
  * of the MIT license. See the LICENSE file for details.
  */
 
 package com.pingidentity.auth.migration
 
 import android.content.Context
+import com.pingidentity.auth.migration.AuthMigration.logger
+import com.pingidentity.auth.migration.AuthMigration.start
 import com.pingidentity.logger.Logger
 import com.pingidentity.logger.STANDARD
 import com.pingidentity.migration.Migration
 import com.pingidentity.migration.MigrationProgress
+import kotlinx.coroutines.flow.FlowCollector
 import kotlinx.coroutines.sync.Mutex
 import kotlinx.coroutines.sync.withLock
 
@@ -112,7 +116,7 @@ object AuthMigration {
                 step(cleanupLegacyDataStep(config.legacyStorageProvider, config.backup))
             }
 
-            migration.migrate(context).collect { progress ->
+            val collector = config.progress ?: FlowCollector { progress ->
                 when (progress) {
                     is MigrationProgress.Started -> {
                         logger.i("Migration started")
@@ -134,6 +138,8 @@ object AuthMigration {
                     }
                 }
             }
+
+            migration.migrate(context).collect(collector)
         }
     }
 }

mfa/auth-migration/src/main/kotlin/com/pingidentity/auth/migration/AuthMigration.kt

@@ -1,5 +1,6 @@
 /*
  * Copyright (c) 2026 Ping Identity Corporation. All rights reserved.
+ *
  * This software may be modified and distributed under the terms
  * of the MIT license. See the LICENSE file for details.
  */
@@ -9,6 +10,8 @@ package com.pingidentity.auth.migration
 import android.content.Context
 import com.pingidentity.logger.Logger
 import com.pingidentity.logger.STANDARD
+import com.pingidentity.migration.MigrationProgress
+import kotlinx.coroutines.flow.FlowCollector
 import org.forgerock.android.auth.StorageClient
 
 /**
@@ -29,6 +32,7 @@ import org.forgerock.android.auth.StorageClient
  *   invoked by [StorageClientProvider.cleanUp] unconditionally — pass a no-op (the default) to
  *   skip backup. For custom [LegacyStorageProvider] implementations, the callback is forwarded
  *   via [LegacyStorageProvider.cleanUp] and it is the implementation's responsibility to invoke it.
+ * @property progress An optional [FlowCollector] that receives migration pipeline events.
  *
  * ## Example — default migration (no block needed)
  * ```kotlin
@@ -72,4 +76,5 @@ class LegacyAuthenticationConfig(context: Context) {
     var legacyStorageProvider: LegacyStorageProvider = StorageClientProvider(context)
     var logger: Logger = Logger.STANDARD
     var backup: (context: Context) -> Unit = {}
+    var progress: FlowCollector<MigrationProgress>? = null
 }

mfa/auth-migration/src/main/kotlin/com/pingidentity/auth/migration/LegacyAuthenticationConfig.kt

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2025 Ping Identity Corporation. All rights reserved.
+ * Copyright (c) 2025 - 2026 Ping Identity Corporation. All rights reserved.
  *
  * This software may be modified and distributed under the terms
  * of the MIT license. See the LICENSE file for details.
@@ -18,6 +18,13 @@ plugins {
 
 android {
     namespace = "com.pingidentity.device.binding.migration"
+
+    packaging {
+        resources.excludes += setOf(
+            "META-INF/LICENSE.md",
+            "META-INF/LICENSE-notice.md",
+        )
+    }
 }
 
 dependencies {
@@ -37,4 +44,13 @@ dependencies {
     testImplementation(libs.mockk)
     testImplementation(libs.robolectric)
 
+    androidTestImplementation(project(":foundation:journey-plugin"))
+    androidTestImplementation(libs.mockk)
+    androidTestImplementation(libs.mockk.android)
+    androidTestImplementation(libs.kotlinx.coroutines.test)
+    androidTestImplementation(libs.forgerock.auth)
+    androidTestImplementation(libs.kotlin.test)
+    androidTestImplementation(libs.androidx.junit)
+    androidTestImplementation(libs.androidx.test.runner)
+
 }