# 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](doc:react-native-installation). For known runtime limitations of the SDK itself, see [Known Issues](doc:react-native-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](doc:react-native-installation#android-setup). 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](doc:react-native-installation#ios-setup).

## `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`:

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

For details on customization methods, see [Customization](doc:react-native-customization).

## `streamFrames` has no effect

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

- The `-vc` SDK package variant (see [SDK variants](doc:react-native-installation#sdk-variants) on Installation).
- The Android video-streaming dependency:

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

If either is missing, `streamFrames` has no effect.