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.

npm install fails with E404 for the Incode package

NPM returns 404 Not Found instead of a permission error when you request a private package your account cannot see, so a missing, expired, or unauthorized token looks like a package that does not exist:

npm error code E404
npm error 404 Not Found - GET https://registry.npmjs.org/@incode-sdks%2freact-native-incode-sdk

Verify:

• You accepted the invitation to the Incode React Native team within 7 days of receiving it. If it expired, ask your Incode representative to resend it.
• An .npmrc file in your project root sets //registry.npmjs.org/:_authToken.
• The token is exported in the shell you run the install from, if your .npmrc uses ${NPM_TOKEN} expansion.
• The token has not expired and grants read access to the @incode-sdks scope.
• On Yarn Berry (2.x and newer), the scope is configured in .yarnrc.yml. Yarn Berry ignores .npmrc.

Run npm whoami --registry=https://registry.npmjs.org/ to confirm the token authenticates. For the full NPM setup, see Installation.

Android build fails resolving Incode dependencies

Android builds need access to Incode GitHub Packages artifacts. If Gradle cannot resolve Incode dependencies, verify:

• The Incode Maven repository is declared in your project build.gradle.
• GITHUB_USERNAME and GITHUB_TOKEN are set.
• The token or equivalent credential has read:packages scope for the android-omni-packages registry.

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, and 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.