Troubleshooting

This page covers common problems you may encounter while building or running the React Native SDK, and where to look for the fix. For setup instructions, see Installation. For known runtime limitations of the SDK itself, see Known Issues.

Android build fails resolving Incode dependencies

If Gradle cannot resolve Incode dependencies during an Android build, the GitHub Packages credentials or repository access is likely missing or incorrect.

Verify:

• The Incode Maven repository is added to your project build.gradle.
• The GITHUB_TOKEN (or equivalent credential) has access to the android-omni-packages registry with read:packages scope.

For the full Android setup, see Installation. If credentials are correct and the error persists, contact your Incode representative.

iOS pod install fails on the Incode podspec source

If pod install fails when resolving the Incode podspec source, GitHub authentication is likely not configured on your machine.

The Incode podspec source is hosted on GitHub and requires authenticated access. Configure SSH or HTTPS GitHub authentication before running pod install.

For the full iOS setup, see Installation.

setLocalizationLanguage, setString, or setQuantityStrings fail at runtime on Android

These methods require the Android extensions dependency. If the dependency is missing, the calls fail at runtime.

Add the dependency to your app-level build.gradle:

implementation 'com.incode.sdk:extensions:1.2.1'

For details on customization methods, see Customization.

streamFrames has no effect

The streamFrames parameter on IdScan, IdScanFront, IdScanBack, and SelfieScan requires:

• The -vc SDK package variant (see SDK variants on Installation).
• The Android video-streaming dependency:

implementation 'com.incode.sdk:video-streaming:1.5.5'

If either is missing, streamFrames has no effect.