SDK Installation & Setup

Incode Welcome

Incode Welcome provides effortless onboarding where security matters.

Incode Welcome is part of Incode Omnichannel Biometric Identity Platform, that is powered by Incode's world class Face Recognition, Liveness detection and ID Validation models. Organizations may choose to have an optional video conference module for additional verification of the customer’s identity. Also if application size is a concern, the SDK features the ability to download its resources at runtime using On-Demand Resources.

In this repo you can find an example onboarding app that uses IncdOnboarding SDK to enable remote account opening.

Prerequisites

For running the example app you must have the following installed:

SDK Variants

The SDK is available in different variants which can differ in linking type, included features, and resource loading.

Versioning and Naming Convention:

The SDK uses custom versioning which is based on semantic versioning with alphabetic symbols representing linking type, specific optional feature(s) and resource loading:

MAJOR.MINOR.PATCH-LinkingType-Feature1-Feature2-...

Linking Type:

Optional Features:

Resources:

(More information regarding On-Demand Resources can be found in the ODR User Guide)

Default Variant:

<version>-d

Dynamic linking with embedded resources, excluding optional features. Recommended for most users.

Examples:

5.31.0-d

Dynamic linking, embedded resources.

5.31.0-d-vc

Dynamic linking with Video Streaming, embedded resources.

5.31.0-s-nfc

Static linking with NFC Scan, embedded resources.

(See NFC Scan-Integration & Usage for more details.)

5.31.0-s-vc

Static linking with Video Streaming, embedded resources.

Example App Instructions

How to run the example app

  1. Make sure you have all the of prerequisites.
  2. Clone or download this project ( Incode-Welcome-Example-iOS).
  3. Follow instructions for Cocoapods/SPM/Manual installation.
  4. Open Omni.xcworkspace in case SDK was added via Cocoapods. In case of SPM or Manual installation, open Omni.xcodeproj
  5. Open Environment/Incode-Info.plist and set the values for:
    • IncdOnboardingURL [string] with the provided Onboarding URL
    • IncdOnboardingApiKey [string] with the provided API key
    • ConferenceURL [string] with the provided Onboarding URL (If applicable)
  6. Run the Omni scheme.

Installation

There are three different methods to add the SDK to your app:

Cocoapods and SPM are the most convenient and fast way to get the SDK installed on your app especially if your project already utilizes these dependency managers. Manual installation offers more flexibility and configurability within your project settings.

Pick the method which makes most sense for your specific project and needs.

Cocoapods installation

  1. Make sure you have all the Prerequisites
  2. Choose the SDK variant
  3. To integrate the sdk into your Xcode project using CocoaPods, specify the source and the pod in your Podfile:
    • source 'git@github.com:Incode-Technologies-Example-Repos/IncdDistributionPodspecs.git'
    •

    pod 'IncdOnboarding', '5.14.0-d'

4. In the Terminal, navigate to your app's project directory and run the `pod install` command to install the SDK via CocoaPods
5. Drag & drop the [`Incode-Info.plist`](https://developer.incode.com/docs/Omni/Environment/Incode-Info.plist) from the example project to your Xcode project (anywhere you prefer inside of the Project navigator).
6. In the “Choose options for adding these files” popup window, make sure to:checkmark “Copy items if needed”, select “Create groups” and checkmark the targets which you wish to use.
7. Open the `Incode-Info.plist` inside your Xcode project and set the following values:
   - `OnboardingURL` with the onboarding URL which we provide you.
   - `OnboardingApiKey` with the API key which we provide you.
   - `ConferenceURL` with the conference URL which we provide you. (Optional)
8. Depending on the modules you would like to use, please adapt your `Info.plist` by adding:
   - `NSCameraUsageDescription`. The SDK uses the camera in order to verify the identity of the customer, e.g. in ID scan, Selfie scan and so on.
   - `NSLocationWhenInUseUsageDescription`. The SDK uses the current user location in order to detect exact location for Geolocation step.
   - `NSMicrophoneUsageDescription`. The SDK uses microphone for performing a video call during Video Conference step or for doing speech recognition during Video Selfie.
   - `NFCReaderUsageDescription`. The SDK uses NFC Reader for reading Passports or other documents that have NFC chip within.

### SPM Installation

1. Make sure you have all the [Prerequisites](https://developer.incode.com/docs/sdk_installation_setup#Prerequisites)
2. Choose the SDK [variant](https://developer.incode.com/docs/sdk_installation_setup#sdk-variants)
3. To integrate the SDK into your Xcode project using SPM, tap on the project in the left side bar, following third tab named `Package Dependencies`.
4. Add the SPM repository [https://github.com/Incode-Technologies-Example-Repos/IncdOnboarding-distribution.git](https://github.com/Incode-Technologies-Example-Repos/IncdOnboarding-distribution.git)
5. When adding package, select `branch` for `dependency rule` and type in the full version you want to integrate e.g. `5.31.1-d` or `5.31.1-d-l`.

### Manual Installation

If you prefer not to use CocoaPods or SPM, you can integrate the SDK into your project manually by following these steps:

1. **Ensure Prerequisites are Met**
   - Confirm that you have all the [Prerequisites](https://developer.incode.com/docs/sdk_installation_setup#Prerequisites) (excluding CocoaPods).
2. **Clone the SDK Distribution Repository**
   - Clone the [SDK distribution repository](https://github.com/Incode-Technologies-Example-Repos/IncdOnboarding-distribution) using `git clone` and check out the tag corresponding to the SDK [variant](https://developer.incode.com/docs/sdk_installation_setup#sdk-variants) you wish to use. For information about tag meanings, refer to the [CocoaPods Installation](https://developer.incode.com/docs/sdk_installation_setup#Cocoapods-installation) section.
3. **Add SDK Files to Your Xcode Project**
   - Navigate to the `IncdOnboarding` folder in the cloned repository.
   - Select all files _except_ the `.podspec` file.
   - Drag and drop the selected files into your Xcode project in the Project Navigator.
4. **(Optional) Add OpenTok Framework**
   - **If** you are using an SDK variant that includes the Video Conference module, download the required OpenTok framework:
     - [OpenTok-iOS-2.22.3.tar.bz2](https://s3.amazonaws.com/artifact.tokbox.com/rel/otkit-ios-sdk-xcframework/OpenTok-iOS-2.22.3.tar.bz2)
   - **If** you are using a variant _without_ the Video Conference module, skip this step.
5. **Configure File Addition Options**
   - In the “Choose options for adding these files” window:
     - Check the “Copy items if needed” option.
     - Select “Create groups”.
     - Ensure the appropriate targets are checkmarked.
6. **Update Build Settings**
   - In the Project Build Settings, add the following to **Other Linker Flags**:
   ```text
   -l "stdc++" -l "iconv" -framework "VideoToolbox"
  1. Update Info.plist with Required Permissions
    • Depending on the SDK modules you plan to use, update your Info.plist with the following keys:
      • NSCameraUsageDescription: The SDK requires access to the camera to verify the identity of the user, such as during ID or selfie scans.
      • NSLocationWhenInUseUsageDescription: The SDK uses location services to detect the user's current location for the Geolocation step.
      • NSMicrophoneUsageDescription: The SDK requires access to the microphone for video calls during the Video Conference step or for speech recognition during Video Selfie.
      • NFCReaderUsageDescription: The SDK uses the NFC reader to read passports or other documents that contain an NFC chip.

Requirements

Known Issues

If you are using the Static variant and are getting a EXC_BAD_ACCESS crash and/or getting duplicate symbol warnings regarding OpenCV, this means that there is another dependency inside your project which is also importing OpenCV. The easiest solution is to switch to the Dynamic variant of our SDK. Other solutions involve manual integration and using a single common OpenCV framework (be aware that OpenCV has different versions and included modules).

Cocoapods does not provide dependency resolution for OpenCV as it is not an official pod.

Known conflicting dependencies: PayPal, card.io.

License

Copyright 2019 Incode Technologies. All rights reserved.