Pular para o conteúdo principal

Instalação

AMBIENTE DE DESENVOLVIMENTO​

É necessário que seu ambiente de desenvolvimento esteja de acordo com os seguintes pré-requisitos:

  • Possuir a versão 15.0.1 ou superior do Xcode instalado (IDE oficial de desenvolvimento da Apple);
  • Possuir a versão do SDK iOS na versão 11 ou superior;
  • Possuir o gerenciador de dependências Cocoapods ou Swift Package Manager já configurado.

UTILIZANDO O COCOAPODS​

O CocoaPods é um gerenciador de dependências para projetos Cocoa, para instruções de uso e instalação visite a documentação do oficial do Cocoapods. Para integrar o SDK iOS em seu projeto Xcode usando CocoaPods, siga as orientações abaixo:

Inclua o unicocheck-ios em seu Podfile:

pod ‘unicocheck-ios’

Em seguida, basta utilizar o comando em seu terminal para instalar as dependências:

pod install
Atenção

Se estiver executando o projeto em .xcodeproj é necessário abrir o projeto em .xcworkspace.

UTILIZANDO O SWIFT PACKAGE MANAGER (SPM)​

O Swift Package Manager é um gerenciador de dependências para projetos Swift. Ele é integrado ao sistema de compilação Swift para automatizar o processo de download, compilação e vinculação de dependências. Para integrar o SDK iOS em seu projeto usando o SPM, siga as orientações abaixo:

Inclua a dependência em seu arquivo Package.swift:

Package.swift
dependencies: [
    .package(url: "https://github.com/acesso-io/unico-check-ios.git", .upToNextMajor(from: "2.12.0"))
]

PERMISSÕES PARA UTILIZAÇÃO DA CÂMERA​

Para utilizar o método de abertura de câmera em seu projeto é necessário adicionar as permissões antes de compilar a sua aplicação:

Info.plist
<key>NSCameraUsageDescription</key>
<string>Camera usage description</string>

OBTENDO AS CREDENCIAIS​

Para utilizar o SDK iOS é necessário importar as credenciais (Client API Key) em seu projeto. Utilize o guia a seguir para gerar e importar as credenciais:

  1. Acesse a sua instância com o login e senha;
  2. Role a barra de menus para baixo e clique no menu Configurações, em seguida clique no menu Integração e por fim clique no menu API Key;
  3. Para criar uma API Key clique em + Nova API Key ou para editar clique sob a API Key desejada;
  4. Se desejar utilizar o modo câmera de selfie com prova de vida da FaceTec, verifique se o campo Utiliza liveness com interação está preenchido com a opção SIM. Se estiver preenchido com NÃO, ou não estiver aparecendo, entre em contato com o suporte através da Central de ajuda e solicite a ativação; Para mais informações sobre SMARTLIVE COM INTERAÇÃO (LIVENESS COM INTERAÇÃO), clique aqui.
  5. No campo Utiliza autenticação segura na SDK selecione a opção Sim;
  6. Expanda a seção SDK iOS, adicione a identificação do projeto e o Bundle ID;
  7. Por fim, clique em Salvar;
  8. Volte para a seção APIKey;
  9. Escolha a API Key configurada, na coluna Bundle, clique no botão de Download;
  10. Uma nova seção é aberta, selecione a opção iOS;
    NOTA

    Se a aba não abrir, verifique se o seu navegador está bloqueando os pop-ups.

  11. Clique em Gerar e automaticamente uma nova aba é aberta em seu navegador contendo informações do projeto em formato JSON;
  12. Salve esse JSON.

EMBARCANDO AS CREDENCIAIS EM SEU PROJETO​

IMPLEMENTANDO O PROTOCOLO AcessoBioConfigDataSource​

Implemente o protocolo AcessoBioConfigDataSource em sua classe.

Copie e cole as informações contidas no JSON em seus respectivos métodos:

Arquivo JSON
{
    "project_info":{
        "project_number":"<YOUR_PROJECT_NUMBER>",
        "project_id":"<YOUR_PROJECT_ID>"
    },
    "client_info":{
        "mobilesdk_app_id":"<YOUR_MOBILE_SDK_APP_ID>",
        "ios_client_info":{
            "bundle_identifier":"<YOUR_MOBILE_BUNDLE_IDENTIFIER>"
        }
    },
    "host_info":{
        "host_info":"<YOUR_HOST_INFO>",
        "host_key":"<YOUR_HOST_KEY>"
    }
}
.h:
#import <AcessoBio/AcessoBioManager.h>
#import <AcessoBio/AcessoBio-Swift.h>

@interface YourUnicoConfigClass: AcessoBioConfigDataSource {}
@end

.m:
@implementation YourUnicoConfigClass

- (NSString * _Nonnull)getBundleIdentifier {
    return @"<YOUR_MOBILE_BUNDLE_IDENTIFIER>";
}

- (NSString * _Nonnull)getHostInfo {
    return @"<YOUR_HOST_INFO>";
}

- (NSString * _Nonnull)getHostKey {
    return @"<YOUR_HOST_KEY>";
}

- (NSString * _Nonnull)getMobileSdkAppId {
    return @"<YOUR_MOBILE_SDK_APP_ID>";
}

- (NSString * _Nonnull)getProjectId {
    return @"<YOUR_PROJECT_ID>";
}

- (NSString * _Nonnull)getProjectNumber {
    return @"<YOUR_PROJECT_NUMBER>";
}

@end

Dúvidas?​

Não encontrou algo ou ainda precisa de ajuda? Se já é um cliente ou parceiro, pode entrar em contato através da Central de Ajuda.