Boas práticas para desenvolvedores


Aqui, estão reunidas orientações essenciais para garantir que sua integração aconteça de forma eficiente, segura e alinhada à experiência esperada na Cielo Smart.

Segurança e Privacidade

  • Proteja dados sensíveis de clientes e funcionários.
  • Nunca exponha tokens de autenticação ou senhas.

Rate limiting e performance

  • Escalone as solicitações da Automação Comercial ou PDV para evitar picos de tráfego.
  • Utilize cache para dados grandes ou para armazenar valores especializados.
  • Evite chamadas POST em multi-threading para prevenir deadlocks.
  • Minimize o uso de dados, considerando conexões móveis limitadas.
  • Otimize as operações visando o baixo consumo de bateria.

Qualidade de código

  • O aplicativo deve seguir as boas práticas de desenvolvimento Java e Android, conforme as diretrizes oficiais para desenvolvedores da plataforma Android.
  • Aplique os princípios Design Orientado a Objetos (S.O.L.I.D.) e diretrizes de estilo Java.
  • Entenda e configure corretamente compileSdkVersion, targetSdkVersion e minSdkVersion.
  • Aproveite os botões nativos do Android, como os botões Voltar e Início.

Usabilidade e experiência do usuário

  • Utilize ícones com dimensionamento padrão Android. Siga esta guideline.
  • Implemente ferramentas de monitoramento de falhas em seus produtos Android com o objetivo de manter a consciência operacional do produto. Sugerimos a utilização do Crashlytics.
  • Colete métricas de uso do aplicativo para melhorar o produto.
  • Priorize clareza e acessibilidade no design do seu aplicativo: contraste, fontes legíveis e texto grande.
  • Esclareça os termos de uso da aplicação e ofereça suporte adequado ao usuário.
  • Seu aplicativo será usado em condições de trabalho de ritmo rápido em ambientes dinâmicos, portanto, construa fluxos de fácil entendimento com o mínimo de passos possível.
  • Ao adaptar um aplicativo desenvolvido para outra plataforma, mantenha apenas os recursos e botões relevantes para o usuário da Cielo Smart.
  • Recomenda-se o uso do Material Design no desenvolvimento de aplicações para a Cielo Smart, promovendo a adoção de boas práticas de design e melhorando a experiência em dispositivos móveis.
📘

É importante assegurar-se de que o aplicativo desenvolvido ofereça desempenho adequado e uma boa experiência de uso em todos os modelos de terminais disponibilizados pela plataforma. Para isso, a definição da tecnologia, da arquitetura e das estratégias de desenvolvimento deve considerar as características e limitações de cada dispositivo, garantindo sua compatibilidade e eficiência operacional.



Did this page help you?