Deploy SmartPOS
Compile e instale aplicações Android em terminais SmartPOS Gertec e Pax, incluindo fluxos de debug, produção, assinatura e ADB.
Compile e instale sua aplicação Android em terminais SmartPOS de desenvolvimento ou produção.
O fluxo de produção depende do fabricante. Antes de instalar em máquinas produtivas, valide assinatura, ferramenta de distribuição e nível de segurança exigido para o terminal.
Terminais suportados
| Fabricante | Terminal |
|---|---|
| Gertec | GPOS720 |
| Pax | A910/A910S |
Antes de fazer deploy
Confirme estes itens antes de instalar o app no terminal:
1. Conclua ou inicie o onboarding do fabricante.
2. Valide os requisitos do terminal, incluindo firmware.
3. Configure o projeto Android em Configuração do projeto.
4. Baixe o app de exemplo, se quiser validar o terminal antes de instalar seu app.
5. Para produção, obtenha a assinatura e a ferramenta de instalação exigidas pelo fabricante.
Build da aplicação
Para gerar o pacote da aplicação, use as tasks do Gradle no Android Studio e selecione a opção assemble.
Você também pode usar o app de exemplo para validar o processo de build antes de compilar sua aplicação final.
Antes de testar seu app, você pode instalar o APK de exemplo correspondente ao fabricante para confirmar que o terminal está operacional.
Deploy em dispositivo de desenvolvimento/debug
Use este fluxo para instalar em uma máquina de desenvolvimento ou debug.
1. Gere o APK
Compile a aplicação pelo Android Studio usando a task assemble.
2. Instale pelo Android Studio
Para testes rápidos, use o quick run do Android Studio.
3. Instale via ADB
Após o build, navegue até a pasta em que está o APK e execute:
adb install -t nome_do_app.apkSe já existir uma versão anterior instalada, execute:
adb install -t -r nome_do_app.apkGertec GPOS720
Use esta seção para instalar em terminais Gertec GPOS720.
Desenvolvimento/debug
Em dispositivos de desenvolvimento, instale pelo Android Studio ou via ADB:
adb install -t nome_do_app.apkPara substituir uma versão existente:
adb install -t -r nome_do_app.apkProdução
Para gerar uma release de produção, configure a assinatura de aplicativo disponibilizada pela Gertec.
Para deploy em máquina de produção, use a ferramenta específica do fabricante. Entre em contato com a Gertec para obter a ferramenta necessária.
Em máquinas Gertec de produção, não assuma que a instalação via ADB estará disponível. Siga o processo de assinatura e distribuição definido pela Gertec.
Pax A910/A910S
Use esta seção para instalar em terminais Pax A910 ou A910S.
Desenvolvimento/debug
Em dispositivos de desenvolvimento, instale pelo Android Studio ou via ADB:
adb install -t nome_do_app.apkPara substituir uma versão existente:
adb install -t -r nome_do_app.apkProdução
Para gerar uma release, configure a assinatura de aplicativo disponibilizada pelo fabricante.
Além da assinatura da aplicação, envie o pacote assinado para a etapa adicional de assinatura exigida pelo fabricante. Sem essa etapa, não é possível instalar a aplicação no SmartPOS de produção.
Para deploy em máquina de produção Pax, não é possível instalar via ADB. Use a ferramenta específica do fabricante e siga o processo de assinatura exigido.
Compatibilidade de assinatura
Só é possível instalar uma aplicação com nível de segurança igual ao da aplicação instalada no dispositivo.
| Versão anterior | Nova versão | Status |
|---|---|---|
| Assinatura do Android | Assinada pela Pax | Falha |
| Assinada pela Pax | Assinada pela Pax | Sucesso |
| Não assinada | Não assinada | Sucesso |
Caso seja necessário instalar versões com níveis de assinatura diferentes, desinstale a versão anterior antes de instalar a nova.
Checklist de deploy
Antes de considerar o deploy concluído, valide:
- O APK foi gerado com sucesso.
- O terminal usado no teste corresponde ao flavor ou dependência correta.
- A instalação em debug foi validada pelo Android Studio ou ADB.
- O firmware do terminal está compatível.
- Para produção, a aplicação foi assinada conforme o fabricante.
- Para Pax, o pacote passou pela etapa adicional de assinatura quando exigida.
- A ferramenta de deploy do fabricante foi usada em máquinas produtivas.
- Uma versão anterior incompatível por nível de assinatura foi removida, se necessário.
Próximo passo
Depois de instalar o app no terminal, siga para Ativação SmartPOS para registrar o dispositivo e obter as credenciais de uso do plugin.
Updated 9 days ago