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'
endExecute 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
.HMLpor.PRDao 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
.HMLe AppKey de homologação. - Só use
.PRDcom AppKey de produção após validar o fluxo.
📋 Checklist
-
iOS 13.0+· Swift 5.0 -
Podfilecomsourceda Certiface (Oititec) epod 'CertifaceDocSDK' -
NSCameraUsageDescriptionnoInfo.plist - Callbacks
onSuccess/onErrortratados
✅ Próximo passo
- Guia detalhado — opções adicionais, customização visual, telas próprias e erros
- Demo oficial no GitHub — exemplo pronto de app integrador
Updated about 1 month ago
