Instalación

Integra el SDK de Facephi en tus aplicaciones iOS para realizar procesos de verificación biométrica de forma rápida y segura.

SDK Mobile está formado por un conjunto de librerías (Componentes) que ofrecen la posibilidad de hacer un producto a medida para cada cliente.

Requisitos mínimos

La versión mínima de la SDK de iOS requerida es la siguiente:

- iOS: 13

Integración inicial

En esta sección se explicará paso a paso cómo integrar el componente actual en un proyecto ya existente.

Añadir repositorio privado

Para tener acceso a nuestro repositorio privado, se requiere haber instalado previamente Cocoapods en la máquina.

Por cuestiones de seguridad y mantenimiento, los nuevos componentes de la SDKMobile se almacenan en unos repositorios privados que requieren de unas credenciales específicas para poder acceder a ellos. Esas credenciales deberá obtenerlas a través del equipo de soporte de Facephi. A continuación, se indica como preparar el entorno para consumir los componentes:

• Primero instalamos el comando que nos dará acceso a usar cocoapods con Artifactory.

sudo gem install cocoapods-art

• En caso de utilizar un Mac con chip M1, pueden surgir errores durante la instalación es posible que surjan errores en el futuro, de ser así, se recomienda usar en cambio el siguiente comando:

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

En caso de tener problemas con la instalación, desinstalar completamente cocoapods y todas sus dependencias para hacer una instalación limpia.

• Necesitaremos añadir el repositorio a la lista del fichero netrc. Para ello, desde un Terminal, se ejecuta el siguiente comando:

$ nano ~/.netrc

Y copiamos el siguiente fragmento con los datos correspondientes al final del fichero:

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

Es importante copiar de manera exacta el anterior fragmento de código. El indentado previo a las palabras login y password está formado por dos espacios.

• Finalmente se añadirá el repositorio que contiene dependencias privada:

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

Dependencias requeridas para la integración

Para evitar conflictos y problemas de compatibilidad, en caso de querer instalar el componente en un proyecto que contenga una versión antigua de las librerías de Facephi (Widgets), éstos deberán eliminarse por completo antes de la instalación de los componentes de la SDKMobile.

• Actualmente las librerías FacePhi se distribuyen remotamente a través de diferentes gestores de dependencias, en este caso, Cocoapods. Dependencias obligatorias que deben ser instaladas previamente (añadiéndolas al Podfile):

plugin 'cocoapods-art', :sources => [
  'cocoa-pro-fphi’
]

source 'https://cdn.cocoapods.org/'

target 'Example' do
  pod 'FPHISDKMainComponent', '~> 2.2.0'

   post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['EXPANDED_CODE_SIGN_IDENTITY'] = ""
      config.build_settings['CODE_SIGNING_REQUIRED'] = "NO"
      config.build_settings['CODE_SIGNING_ALLOWED'] = "NO"
    end
  end
end
...
end

• Cuando se quiera actualizar dependencias, antes de ejecutar el pod install hay que usar el siguiente comando para actualizar el repositorio local:

pod repo-art update cocoa-pro-fphi

Posibles Incidencias

En el caso de que el integrador utilice un Macbook con Chip M1, cabe la posibilidad de que la instalación de cocoapods-art no se realice correctamente. Por ello, se debe tener en cuenta los siguientes puntos:

· Si cocoapods se ha instalado mediante Homebrew puede haber problemas.

· Se recomienda instalar cocoapods y cocoapods-art usando gem.

A continuación, incluimos un script que permite realizar todos los pasos necesarios para dejar el entorno preparado para poder funcionar correctamente:

#! /bin/zsh

install_cocoapods () {
    echo "Installing cocoapods with gem"
    # Creating new gems home if it doesnt't exist
    if [ ! -d "$HOME/.gem" ]; then
        mkdir "$HOME/.gem"
    fi
    # Adding to current session
    export GEM_HOME="$HOME/.gem"
    export PATH="$GEM_HOME/bin:$PATH"

    # Adding for future sessions
    if test -f "$HOME/.zshrc"; then
        echo 'Adding $GEM_HOME env var and then adding it to your $PATH'
        echo '' >> "$HOME/.zshrc"
        echo 'export GEM_HOME="$HOME/.gem"' >> "$HOME/.zshrc"
        echo 'export PATH="$GEM_HOME/bin:$PATH"' >> "$HOME/.zshrc"
        echo 'alias pod='arch -x86_64 pod'' >> "$HOME/.zshrc"
    fi

    # Installing cocoapods
    gem install cocoapods
    sudo arch -x86_64 gem install ffi
    which pod
    pod --version
    gem install cocoapods-art
}

uninstall_cocoapods_homebrew () {
    which -s brew
    if [[ $? != 0 ]] ; then
        echo "Homebrew not installed, skipping uninstalling cocoapods from homebrew"
    else
        brew uninstall cocoapods
    fi
}

if ! type "pod" > /dev/null; then
    echo "You don't have cocoapods installed..."
else
    echo "Trying to uninstall it from homebrew first"
    uninstall_cocoapods_homebrew
fi

install_cocoapods

En caso de usar xCode15 se deberá realizar la siguiente configuración:

Se deberá añadir -ld_classic en Other Linker Flags, en el Build Settings de la aplicación.

---

Para dudas o problemas durante la instalación, contacta al Soporte Técnico.