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.

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.