# Native iOS SDK

{% hint style="warning" %}
*The latest Stable Version is V2.0*&#x20;
{% endhint %}

{% embed url="<https://github.com/faceki/Native-iOS-KYC-V2>" %}

### Let's Get your iOS App running with FACEKI SDK

### Requirements

1. **Xcode 13**&#x20;

{% hint style="info" %}
[Xcode 13](https://developer.apple.com/xcode/) adds powerful new team development features, perfect for working with Xcode Cloud as well as with GitHub, Bitbucket, and GitLab collaboration features. Initiate, review, comment, and merge pull requests directly within Xcode. See your teammates’ comments right inside your code. And quickly compare any two versions of your code files.
{% endhint %}

{% embed url="<https://developer.apple.com/documentation/xcode>" %}

\
2\. **iOS CocoaPod**&#x20;

{% hint style="info" %}
[CocoaPods](https://cocoapods.org/) is a dependency manager for Swift and Objective-C Cocoa projects. It has over 87 thousand libraries and is used in over 3 million apps. CocoaPods can help you scale your projects elegantly.
{% endhint %}

{% embed url="<https://guides.cocoapods.org/contributing/contribute-to-cocoapods.html>" %}

{% hint style="info" %}
View [Quick Guide](https://kycdocv2.faceki.com/quick-guides#dashboard) steps first&#x20;
{% endhint %}

### **Steps**

### iOS CocoaPod Integration

**1**. Create a new Xcode Project.&#x20;

![](https://3621714085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQdiwjdAaMBpDtolO59Ll%2Fuploads%2F8ffPMS4SKFkw0ZE5kPrc%2FScreen%20Shot%202022-01-02%20at%202.37.56%20PM%201.png?alt=media\&token=bdfa3ece-5566-4134-80b8-b9ef5345c945)

2\. Choose app in-app template.

![](https://3621714085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQdiwjdAaMBpDtolO59Ll%2Fuploads%2FI8DRqnJ3ngPnrtGcO6Mx%2FScreen%20Shot%202022-01-02%20at%202.42.52%20PM.png?alt=media\&token=76230a33-7065-43a0-99c9-fba1062a645b)

3\. Add unique Bundle Identifier, set product name and organization identifier.

![](https://3621714085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQdiwjdAaMBpDtolO59Ll%2Fuploads%2F6HuFWZqYBtDjLyxSs1eV%2FScreen%20Shot%202022-01-02%20at%202.48.39%20PM.png?alt=media\&token=25102922-d287-4bd4-9c68-313e1db75fd9)

## Apple Developer Account Setup

4\. Create an Apple Developer account ID and login & Select Identifiers and click + icon.

![](https://3621714085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQdiwjdAaMBpDtolO59Ll%2Fuploads%2FwCgEajtFW1sQizw40suG%2FScreen%20Shot%202022-01-02%20at%203.16.23%20PM.png?alt=media\&token=880c983a-348c-48c3-be39-fb9210803bb4)

5\. Select App IDs in Certificates, Identifiers & Profiles Tab.

![](https://3621714085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQdiwjdAaMBpDtolO59Ll%2Fuploads%2FBuZ416pdug9sOEOK5hXR%2FScreen%20Shot%202022-01-02%20at%203.20.20%20PM.png?alt=media\&token=b025f1c6-4f18-4637-a8e9-a52a0ffb6adc)

6\. Select App as a type.

![](https://3621714085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQdiwjdAaMBpDtolO59Ll%2Fuploads%2FiNDjHZcCoyOme8ZGxKPi%2FScreen%20Shot%202022-01-02%20at%203.25.23%20PM.png?alt=media\&token=a2197005-9037-495d-ac7f-4cab0414edf2)

7\. Add your bundle ID mentioned in the project created and&#x20;description. Now select App groups in the capabilities.

8\. Go to signing and capabilities and select teams with Apple developer account linked to it and. Click on the capabilities button.

9\. Select app groups in capabilities

10\. Add App group - “ ”

11\. To use Faceki API, you need to register any of [Faceki packages on the link](https://apps.faceki.com/pricing) then access  [Dashboard](https://apps.faceki.com/integration/client-id) >> Integration >> [Client-ID](https://apps.faceki.com/integration/client-id)

12\. Click on the hidden eyes and securely copy the **Client ID** (token).

<figure><img src="https://3621714085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQdiwjdAaMBpDtolO59Ll%2Fuploads%2FDWVmYknOY7F92oiri7AH%2FScreenshot%202023-05-24%20150054.png?alt=media&#x26;token=5c51a515-853d-4cc4-8fb1-fe35c1768d99" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Please don't share the token with anybody, highly secure and confidential&#x20;
{% endhint %}

13\. Copy the **Client ID** from the project and keep it safe and secure

14\. Faceki Framework is available through [Github link ](https://github.com/faceki/KYC-iOS-App-Connect-V2)

15\. Create a new Xcode Project with a View Controller

16\. To run the example project, clone the repo, and run `pod install` from the Example directory first.

17\. To install KYC-iOS-Native POD, simply add the following line to your Podfile:

```
pod 'KYC-iOS-Native', :git => 'https://github.com/faceki/KYC-iOS-Native.git'
```

{% embed url="<https://youtu.be/jbP5bGzRmkA>" %}

18\. Edit the source file in which you want to initiate Faceki SDK with your email and token, user can Simply add a button in his Project to initiate the Pod Library, the user needs to copay paste this code in his code file.

```
let smManagerVC = Logger.initiateSMSDK(setClientID : "YOUR_FACEKI_CLIENTID", userEmail: "YOUR_FACEKI_EMAIL") navigationController?.pushViewController(smManagerVC, animated: true)You can also check out FACEKI's Github 
```

19\. User needs to give Camera Usage permission in info.plist of Xcode project.

{% hint style="info" %}
**Good to know:** depending on the product you're building, it can be useful to explicitly document use cases. Got a product that can be used by a bunch of people in different ways? Maybe consider splitting it out!
{% endhint %}

### Arabic Language&#x20;

To disable the Arabic language, then after you install POD, In "KYC-iOS-Native" folder there is "MainFACEKI.storyboard" open that file you will see two localize string files.

```
MainFACEKI.strings(Arabic) & MainFACEKI.strings(English)
```

Copy Text of English file and then paste that into Arabic file (First clean all texts from Arabic File)

### Edit Splash Screen

To change the Splash screen, just replace the image with your splash image here

```
"/Assets/Splash.png"
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kycdocv2.faceki.com/mobile-sdk/native-ios-sdk.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
