Guia Rápido de Uso

Este guia apresenta a configuração mínima para integrar e executar o Certiface Doc SDK em aplicativos iOS, incluindo instalação, inicialização do fluxo e tratamento dos principais callbacks.

⚙️Configuração mínima

Configuração mínima para o SDK funcionar no seu app.


📚Conteúdo avançado

Customização de telas, telas completamente substituídas e boas práticas estão no guia detalhado de uso .


🧪 Projeto de exemplo

Prefere começar com algo já funcional? Acesse o projeto demo oficial: Certiface Demo.


⚙️ Instalação

No Podfile do seu projeto:

source 'https://github.com/oititec/ios-artifactory.git'
source 'https://github.com/CocoaPods/Specs.git'

# platform :ios, '13.0' ou superior
use_frameworks!

target 'SeuApp' do
  pod 'CertifaceDocSDK', 'x.y.z'
end

Execute pod install em seguida. Substitua x.y.z pela versão publicada.


🚀 Inicialização e execução do fluxo

A AppKey é do seu produto/backend; o app só repassa ao SDK.

import CertifaceDocSDK

let options = DocumentManagerOptions
    .builder(appKey: appKey, environment: .HML)
    .build()

let manager = CertifaceDocSDKFactory.createDocumentManager()
manager.start(at: self, options: options, callback: self)

Substitua .HML por .PRD ao ir para produção.


🔔 Callbacks

Implemente o protocolo DocumentCallback no seu UIViewController (ou em qualquer objeto que preferir):

import CertifaceDocSDK

extension MeuViewController: DocumentCallback {
    func onSuccess() {
        // Documento enviado com sucesso
    }

    func onError(_ error: DocumentError) {
        // Erro na captura ou envio do documento
    }
}

🧪 Ambiente de testes

  • Use .HML e AppKey de homologação.
  • Só use .PRD com AppKey de produção após validar o fluxo.

📋 Checklist

  • iOS 13.0+ · Swift 5.0
  • Podfile com source da Certiface (Oititec) e pod 'CertifaceDocSDK'
  • NSCameraUsageDescription no Info.plist
  • Callbacks onSuccess / onError tratados

✅ Próximo passo