> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-en/sdks/sdk-mobile/framework-plugins/extras/ios.md).

# iOS

Native installation guide for hybrid platforms.

For ***iOS***, update the file `Info.plist` with the required keys at the client application level:

```xml
<key>NSCameraUsageDescription</key>
<string>Camera access is required for Biometric Verification.</string>
<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>
```

#### Add a private repository

To access our private repository, you must first have installed **Cocoapods** on the machine.

For security and maintenance reasons, the new components of the ***SDKMobile*** are stored in private repositories that require specific credentials to access. You must obtain these credentials from the Facephi support team. The following explains how to prepare the environment to use the components:

* First, install the command that will let us use cocoapods with **Artifactory**.

```bash
sudo gem install cocoapods-art
```

If you are using a Mac with an **M1 chip**, errors may occur during installation, and further errors may arise in the future. If so, we recommend using the following command instead:

```bash
sudo arch -arm64 gem install ffi; sudo arch -arm64 gem install cocoapods-art
```

If you have problems with the installation, completely uninstall cocoapods and all its dependencies to perform a clean installation.

* We need to add the repository to the **netrc**file. To do so, run the following command in a Terminal:

```bash
$ nano ~/.netrc
```

Then copy the following snippet, replacing the placeholders with the appropriate details, to the end of the file:

```bash
machine facephicorp.jfrog.io
  login <USERNAME>
  password <TOKEN>
```

Be sure to copy the code snippet above exactly. The indentation before the words login and password consists of two spaces.

* Finally, add the repository containing the private dependency:

```sh
pod repo-art add cocoa-pro-fphi 
"https://facephicorp.jfrog.io/artifactory/api/pods/cocoa-pro-fphi"
```

#### Dependencies required for integration

To avoid conflicts and compatibility issues, if you want to install the component in a project that contains an old version of Facephi libraries (*Widgets*), they must be completely removed before installing the ***SDKMobile***.

* FacePhi libraries are currently distributed remotely through different dependency managers, in this case, ***Cocoapods*****. Required dependencies** that must be installed beforehand (by adding them to the *Podfile*):

```sh
plugin 'cocoapods-art', :sources => ['cocoa-pro-fphi’]
source 'https://cdn.cocoapods.org/'

target 'Example' do
... 
```

* To update dependencies, before running ***pod install*** you must use the following command to update the local repository:

```sh
pod repo-art update cocoa-pro-fphi --prune
```
