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:

    1. 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'
    1. Abra o CMD (prompt de comando) ou Terminal Linux e rode o comando abaixo usando o Logcat:
    adb logcat > caminho/do/arquivo/nomedoarquivo.log
    1. Refaça todo o processo que gera o erro, desde o inicio até o momento que o erro é acionado.
       
    2. Agora volte ao Terminal ou CMD e pare o processo (Ctrl+c).
      1. Será gerado um arquivo na pasta que definiu no “Passo 2”.
         
    3. 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

     

     

     

     

     

    Conseguimos te ajudar?