Implementação de terminais no SDK Providers
Neste artigo, você vai aprender sobre a implementação de terminais no SDK Providers para melhorar sua experiência com o desenvolvimento de aplicações.
Caso utilize o SDK Providers é necessário realizar a implementação das dependências das fabricantes no projeto. Desta forma, sua aplicação conseguirá ser executada nos terminais.
Veja mais informações na nossa documentação online e também a seguir:
- Na aba de Getting Started são encontradas as dependências dos terminais que são suportados: Ingenico, Sunmi e Positivo.
- Para transacionar com os terminais, implemente duas dependências fundamentais da SDK Providers dentro do seu projeto, que são:
Adicionar a dependência para o core da SDK:
dependencies {
implementation "br.com.stone:stone-sdk:$stone_sdk_version"
}Dependência do módulo de POS Android:
dependencies {
implementation "br.com.stone:stone-sdk-posandroid:$stone_sdk_version"
}Em seguida, basta inserir as dependências das fabricantes, colocando uma abaixo da outra. Ficará assim:
dependencies {
implementation "br.com.stone:stone-sdk:$stone_sdk_version"
implementation "br.com.stone:stone-sdk-posandroid:$stone_sdk_version"
implementation "br.com.stone:stone-sdk-posandroid-ingenico:$stone_sdk_version"
implementation "br.com.stone:stone-sdk-posandroid-positivo:$stone_sdk_version"
implementation "br.com.stone:stone-sdk-posandroid-sunmi:$stone_sdk_version"
}Feito isso o SDK Providers irá executar em sua aplicação independente do terminal que esteja instalada.
Observação1: A SDK está apta a comportar os diferentes modelos de terminal, mas é preciso garantir que seu projeto também consiga.
Observação2: Para a correta implementação dos modelos Positivo é necessário utilizar a SDK v4.8.4 ou superior.
Complemento:
Suporte a versões do Android
Lembrando que por cada terminal possuir uma versão do Android diferente é necessário se atentar a versão mínima e alvo do API do Android no AndroidManifest, abordamos esse ponte nesta seção da doc:
POS Android
O POS Android ou SmartPOS é um terminal de pagamento com um sistema operacional baseado no Android.
Ele permite que sua aplicação Android seja executada no próprio POS, sem a necessidade de usar um smartphone ou tablet.
Modelos de POS homologados na Stone:
| Modelo Terminal | S.O | Versão API Android |
| Ingenico A8 | v5.1 | API 22 |
| Sunmi P2-B | v7.1 | API 25 |
| Positivo L300 | v7.1 | API 25 |
| Positivo L400 | v11 | API 30 |
Obs. Para mais detalhes do equipamento veja a especificação no site da fabricante.
Lembrando que é necessário indicar a versão mínima da API Android que o seu app terá suporte e a versão alvo no AndroidManifest:
<uses-sdk
android:minSdkVersion="22"
android:targetSdkVersion="30"
/>
No exemplo acima a versão mínima da API que o app terá suporte é a 22 correspondente a versão do A8, e a versão alvo 30 corresponde ao L400.