Debugmode: Coletando logs completos no seu projeto
Descubra como extrair logs completos de seu projeto para encontrar e solucionar erros rapidamente.
1. Introdução:
- Para ajudar na análise de alguma situação que não consiga solucionar envolvendo a SDK Android, precisamos de mais informações sobre o comportamento do evento que não funciona corretamente na sua integração. E com o logs completos, você ajudará o time de Integrações e os desenvolvedores da SDK Android Stone para te direcionar na solução.
2. Objetivo do Artigo:
Explicar a ativação do Logback dentro da ferramenta Android Studio. Essa é uma biblioteca que facilita e amplia a coleta de dados de log na SDK Android Stone, permitindo uma melhor e mais rápida a análise de suporte.
3. Contextualização:
- Logbacks são importantes para identificarmos soluções de eventuais problemas envolvendo:
- - Criação de transações;
- - Impressão (customizada ou não);
- - Ativação de terminal;
- E muitos outros eventos.
4. Ferramentas e Tecnologias Envolvidas:
- - Sistema Operacional (SO): Linux ou Windows
- - IDE: Android Studio, Visual Studio…
5. Passo a Passo:
- Adicione a seguinte dependências no projeto do seu app:
debugImplementation "com.github.tony19:logback-android:2.0.0"
debugImplementation 'br.com.stone.sdk.android:debugmode:4.0.3'
- Abra o CMD (prompt de comando) ou Terminal Linux e rode o comando abaixo usando o Logcat:
adb logcat > caminho/do/arquivo/nomedoarquivo.log
- Refaça todo o processo que gera o erro, desde o inicio até o momento que o erro é acionado.
- Agora volte ao Terminal ou CMD e pare o processo (Ctrl+c).
- Será gerado um arquivo na pasta que definiu no “Passo 2”.
- Será gerado um arquivo na pasta que definiu no “Passo 2”.
- Colete o arquivo .txt e envie para o time de Integrações.
6. Boas Práticas:
- - Indicar na abertura de seu ticket se a integração do tipo “Providers” ou “Deeplink”.
- Se possível, utilizar a versão mais recente da SDK Android.
- Informar qual modelo de POS que utiliza e versão do bundle (fica no topo esquerdo da tela do POS).
9. Conclusão:
- Neste artigo, mostramos como gerar logback caso precise acionar o time de Integrações da Stone.
- É uma informação muito útil para apoiarmos na resolução de algum problema envolvendo transacional, impressão ou outras funcionalidades da nossa SDK.
10. Recursos Adicionais:
- Veja mais sobre o tema acessando a documentação do Android:
https://developer.android.com/studio/command-line/logcat?hl=pt-br