Visão geral do SDK Demo App
O SDK Demo App é uma aplicação de referência executável que consome o SDK White Label exatamente como uma integração real faria. Use-o como referência viva para ver o SDK em ação, antes ou durante a sua própria integração.
O que é o demo app
O demo app inicia, solicita as credenciais do SDK e inicializa o SDK. Em seguida, ele expõe os principais recursos do SDK em um menu simples: venda, estorno, impressão e personalização da interface.
Ele é uma integração completa e funcional, não um conjunto de trechos. Cada chamada que ele faz ao SDK é a mesma que o seu próprio aplicativo faria. A ordem e o tratamento de resultado também são idênticos.
O demo app não é a documentação oficial do SDK. Ele é um exemplo executável de como o SDK é consumido na prática. Para o contrato oficial do SDK, consulte a documentação do SDK White Label.
Como funciona
A aplicação separa o código que você deve copiar do código do qual deve apenas tirar ideias. Um pacote contém wrappers leves sobre o SDK — são essas as chamadas que você precisa para integrar. O outro contém a aplicação de demonstração em si: sua interface, seu estado, seu armazenamento e sua injeção de dependências.
Cada recurso do SDK fica atrás de uma interface pequena. O que importa para a sua integração é o corpo de cada método, que contém a chamada exata ao SDK e nada mais. O comportamento específico por país fica isolado no seu próprio source set, então as interfaces compartilhadas permanecem iguais entre mercados.
A inicialização é o único passo que toda integração precisa fazer primeiro, e o demo app a conduz a partir de um único cliente.
Onde se encaixa
Recorra ao demo app quando quiser ver um comportamento antes de construí-lo. Ele mostra como o warm-up reporta sucesso, o que um pagamento recusado devolve e como fica a substituição de uma tela.
Ele complementa a documentação do SDK em vez de substituí-la. A documentação define o contrato; o demo app mostra uma forma correta de cumpri-lo. Quando as duas divergem, vale a documentação.
Próximos passos
- Pré-requisitos — o toolchain e os serviços do terminal que você precisa antes de executar a aplicação.
- Início rápido — obtenha o projeto, compile e execute em um terminal.
- Referência de clientes do SDK — qual interface do demo app envolve cada chamada ao SDK.