Setup Guide for Android CPIK Libraries

This guide walks you through integrating the CPIK with your Expo app using Expo Dev Client. This approach gives you the best of both worlds: Expo’s developer experience with full access to native CPIK functionality.

Our React Native Android SDK is defined by Expo as a 3rd party library. So, we need to create a development build to use the library in your project.

We are using:

• React native: 0.79.5
• Expo SDK 53

Prerequisites

Before starting, ensure you follow the React Native environment setup instructions.

Step-by-Step Integration

Step 1: Create Your Project

Start with the provided template:

# Copy template to your project
cd YourAppName

Step 2: Install the CPIK libraries

Follow the manual method steps shown here.

Step 3: Install Required Dependencies

Before generating native files, install the necessary Expo modules:

# Install Expo Dev Client (required for native modules)
npm install
npx expo install expo-dev-client

Step 4: Configure Native Dependencies

Android Configuration

Generate Native Android Project:

npx expo prebuild --platform android

Step 5: Run the Sample Application

Debug Mode

1. Build the Development Client:

# Build Android APK locally
cd android && ./gradlew assembleDebug

2. Install on Device/Emulator:

# Install the built APK
cd .. && adb install android/app/build/outputs/apk/debug/app-debug.apk

3. Start Development Server:

# Return to project root and start Expo dev server
npx expo start --dev-client

Release Mode

1. Build the Development Client:

# Build Android APK locally
cd android && ./gradlew assembleRelease

2. Install on Device/Emulator:

# Install the built APK
cd .. && adb install android/app/build/outputs/apk/release/app-release.apk