Pré-requisitos

Para que você consiga integrar com o SDK Android da Stone é necessário seguir alguns requisitos técnicos.

• Nosso SDK é desenvolvido nativamente no sistema Android, por isso sua aplicação precisa ser Android também ou, caso ela seja desenvolvida com uma plataforma híbrida, é necessário uma interface ou plugin que permita essa comunicação.

Sua aplicação precisa ter a versão do 5.0+ do Android (API 21), ou superior.

Versão S.O Android
Os hardwares utilizados pela Stone possuem diferentes versões do sistema operacional, definição aplicada pela respectiva fabricante:

• GPOS 700X - v8.1
• Positivo L400 - v11
• Positivo L300 - v7.1
• Sunmi P2-B - v7.1
• APOS A8 - v5.1

Muito importante basear seu desenvolvimento pensando em uma retro compatibilidade com a menor versão (5.0), assim você garante a utilização em todos os modelos.

Tamanho do APK
O app pode ter no máximo 70MB, por conta de boas práticas de gerenciamento de espaço e banda larga (3G/4G) dos terminais SmartPOS.

📘

Caso você queira utilizar mais de um dispositivos, aconselhamos a usar o mecanismo de Flavors do Android.

❗️

Atenção!

A comunicação de URLs externas com Stone só é possível com protocolo de segurança, ou seja, qualquer URL, domínios ou site externo a Stone deve conter HTTPS.
Protocolo de segurança mínimo aceito é o TLS 1.2

Fique atento ao fim de sua integração, o time de integrações solicitara a relação de URLs para inserção na whitelist.

Requisito Mandatórios!

1. Suporte mínimo à versão 5.0 + do Android (API 21), ou superior.
   1. Caso utilize uma versão mais atual, lembre-se de sempre desenvolver pensando na retrocompatibilidade da aplicação.
2. O desenvolvimento do aplicativo pode ser nativo ou híbrido, mas em caso de híbrido é necessário que sua linguagem ou framework consiga fazer o download das bibliotecas da SDK utilizando o Gradle, ou ferramenta que acesse nosso repositório no PackageCloud.
3. O aplicativo deve possuir uma seção de "Fale Conosco" informando ao cliente os contatos necessários para atendimento em caso de problemas ou dúvidas. Essa seção deve estar bem visível e de fácil acesso.
4. Utilizar layout dinâmico/responsivos considerando que no futuro o aplicativo pode ser instalado em outros hardwares com resoluções e densidades diferentes.
5. O aplicativo deve estar utilizando o SDK Android Stone.
6. Deve ser possível navegar por todas as telas sem o aplicativo "quebrar".
7. Caso você queira utilizar mais de um dispositivo, aconselhamos a usar o mecanismo de Flavors do Android.
8. Sua aplicação precisa estar assinada digitalmente antes de ser instalada em um dispositivo ou atualizada. Conforme o fluxo de Assinatura do Google.
9. O packageName deve ter o seguinte padrão:
   “br.com.NomeEmpresaParceira.NomeApp.Campolivre”
   1. Nome da sua empresa
   2. Nome do seu app
   3. Livre
      1. Não deve conter referência a concorrentes do Grupo Stone.
      2. Não deve conter o nome Stone;
      3. Não deve conter nome de fabricantes de terminais ou modelos do terminal.
10. Dados como VersionName, VersionCode devem seguir o padrão google de utilização e os seguintes requisitos:
    1. versionCode: O valor deverá ser um número inteiro positivo.
    2. versionName: nesta configuração, só aceita números e o caractere "ponto". O tamanho máximo para esse campo é 12 caracteres.

📘

Guia do Desenvolvedor SDK Android

Para maiores informações acessar o doc: Guia do Desenvolvedor SDK Android