Evrotrust React Native WL SDK

Usage

See the provided file

Evrotrust SDK React Native 1.4.pdf

Included SDKs

Android WL SDK - 1.1.8
iOS WL SDK - 1.1.1232
FaceTec SDK (Android & iOS) - 10.1.9
Regula DocumentReader - iOS 9.7.6818 (MRZRFID 9.7.19696) / Android 9.7.13216 (MRZRFID 9.7.16470)

React-Native setup instructions

1. Set registry

  "npm config set registry https://registry.npmjs.org/"

2. Create a new workspace

  "npx [email protected]"

  Where would you like to create your workspace?            - org
  Which stack do you want to use?                           - none:
      Configures a TypeScript/JavaScript monorepo.
  Would you like to use Prettier for code formatting?       - no
  Which CI provider would you like to use?                  - skip
  Would you like remote caching to make your build faster?  - skip

3. Enter in the new workspace

  "cd org"

4. Install react-native for Nx 18+

  "npx nx add @nx/react-native"

5. Generate react-native:init

  "npx nx generate @nx/react-native:app myapp"

6. Generating @nx/react-native:application

  Run 'pod install' for native modules? (Y/n) › true
  Which bundler do you want to use to build the application?  - vite

7. In "org/myapp/package.json" add dependencies

  before changes:

  {
    "name": "@org/myapp",
    "version": "0.0.1",
    "private": true,
  }

  after changes:

  {
    "name": "@org/myapp",
    "version": "0.0.1",
    "private": true,
    "dependencies": {
      "react": "19.1.1",
      "react-native": "0.82.0",
      "@react-native/metro-config": "^0.82.0",
      "react-native-svg": "*",
      "metro-config": "*"
    }
  }

8. Enter in the project folder

  "cd myapp"

9. Install react library

  "npm i @evrotrust/[email protected]"

Android setup instructions

10. Modify myapp/android/gradle.properties to have the following

  - "android.enableJetifier=true"
  - "android.useAndroidX=true"
  - (Optional) increase memory "org.gradle.jvmargs=-Xmx4608m"

11. Modify myapp/android/app/build.gradle to have the following

  allprojects {
    repositories {
      maven {
        url "https://maven.regulaforensics.com/RegulaDocumentReader"
      }
      google()
      mavenCentral()
      maven { url 'https://www.jitpack.io' }
      maven {
        name = "github"
        url = uri("https://maven.pkg.github.com/Evrotrust/maven")
        credentials {
          username System.getenv("EVROTRUST_MAVEN_USERNAME")
          password System.getenv("EVROTRUST_MAVEN_PASSWORD")
        }
      }
    }
  }

12. Add your environment variable depends your OS:

EVROTRUST_MAVEN_USERNAME=your_username
EVROTRUST_MAVEN_PASSWORD=your_password

13. Add to dependencies in myapp/android/app/build.gradle

  implementation 'com.evrotrust:evrotrust-wl-sdk:1.1.8'
  implementation 'com.evrotrust:facetec-sdk:10.1.9'

14. (Optional) If you received un error

  "Unable to make progress running work. There are items queued for
      execution but none of them can be started"

  Add this to myapp/android/build.gradle

  gradle.startParameter.excludedTaskNames.addAll(
    gradle.startParameter.taskNames.findAll { it.contains("testClasses") }
  )

15. (Optional) If you received crash after change locale, add this to myapp/android/app/src/main/AndroidManifest.xml

  android:configChanges="locale|layoutDirection"

16. Run the project

  "npx nx run-android myapp"

iOS setup instructions

10. Add "regula.license" file somewhere in the project. From Xcode in "Build Phases > Copy Bundle Resources" add the "regula.license" file.
11. Select your target -> Build Settings -> Always Embedded Swift Standard Libraries -> set YES
    
12. Select your target -> Build Settings -> Always Enable Bitcode -> set NO
    
13. Open project_name/ios/project_name_likes/Info.plist

  Add in .plist file:
  - key NSCameraUsageDescription with some description
  - key NSMicrophoneUsageDescription with some description
  - key NFCReaderUsageDescription with some description
  - key com.apple.developer.nfc.readersession.iso7816.select-identifiers - an array with
    the following string elements:
    * A00000045645444C2D3031
    * A0000002480300
    * A0000002480200
    * A0000002480100
    * A000000167455349474E
    * E80704007F00070302
    * A0000002471001
  - key UIDesignRequiresCompatibility with Boolean YES (required to use the
    pre-iOS 26 design, since the SDK doesn't support the new design introduced
    in iOS 26)

14. AFNetworking (4.0.1) is bundled with the SDK as a prebuilt dynamic xcframework and embedded automatically by pod install — no action needed. (EvrotrustSDK.framework loads it via @rpath/AFNetworking.framework, so it must be a dynamic framework; adding it as a source pod would break the build with duplicate/static-linkage errors.)

15. Add FaceTec.strings as localization file in XCode for English(EN), Bulgarian(BG), German(DE), Hungarian(HU), Albanian(SQ), Macedonian(MK), Romanian(RO), Italian(IT) and French(FR)

16. Run the project

  "npx nx run-ios myapp"