Configuração do ambiente SmartPOS
Prepare Android Studio, Kotlin, app de exemplo e validações iniciais para desenvolver com o Plugin SmartPOS.
Prepare o ambiente Android para desenvolver, compilar e testar uma aplicação integrada ao Plugin SmartPOS.
Configure o ambiente antes de adicionar as dependências do plugin. Isso facilita a validação do app de exemplo e reduz problemas de build.
Pré-requisitos
Antes de configurar o projeto Android, conclua estas etapas:
1. Instale o Android Studio na versão mais recente disponível.
2. Use Kotlin 1.9.0 no projeto Android.
3. Baixe o código do aplicativo de exemplo para consultar uma implementação funcional.
4. Valide os requisitos do terminal SmartPOS, incluindo firmware e modelo suportado.
5. Tenha acesso às credenciais obtidas no onboarding da Zoop para testar fluxos transacionais.
IDE
Use o Android Studio para desenvolver e compilar a aplicação Android.
Recomendamos usar a última versão disponível, principalmente para evitar incompatibilidades com Gradle, Kotlin e recursos do Android SDK.
Linguagem
Use Kotlin 1.9.0, seguindo o padrão atual do Android usado pelo Plugin SmartPOS.
Para consultar mudanças da versão, acesse a documentação oficial do Kotlin:
Use o app de exemplo como referência para configurar versões, flavors e dependências no arquivo
build.gradle.
App de exemplo
Baixe o app de exemplo antes de iniciar a configuração do seu projeto.
O projeto de exemplo ajuda a validar:
- estrutura de flavors por dispositivo;
- configuração do Maven da Zoop;
- dependências necessárias;
- permissões Android;
- inicialização do SDK;
- fluxos básicos do Plugin SmartPOS.
Acesse Downloads SmartPOS para baixar o ZIP do projeto de exemplo.
Valide o terminal antes do desenvolvimento
Antes de executar o app no SmartPOS, confirme que o terminal atende aos requisitos mínimos.
| Fabricante | Terminal | Validação principal |
|---|---|---|
| Gertec | GPOS720 | Firmware 164.0 ou superior |
| Pax | A910/A910S | Firmware compatível listado nos requisitos |
Consulte a página Requisitos dos terminais SmartPOS para validar firmware e ficha técnica.
Não avance para testes transacionais em um terminal com firmware incompatível. O plugin pode falhar em inicialização, leitura de cartão, impressão ou outros fluxos.
Checklist do ambiente
Antes de configurar o Gradle do projeto, confirme:
- O Android Studio está instalado e atualizado.
- O projeto usa Kotlin
1.9.0. - O app de exemplo foi baixado para consulta.
- O terminal SmartPOS é suportado.
- O firmware do terminal atende ao requisito do fabricante.
- O onboarding foi iniciado ou concluído.
- Você possui credenciais para testar fluxos do plugin.
Próximo passo
Depois de preparar o ambiente, configure o Maven, as dependências e as permissões Android em Configuração do projeto.
Updated 9 days ago