Errors

Importante

O Visual Studio App Center está programado para ser desativado em 31 de março de 2025. Embora você possa continuar a usar o Visual Studio App Center até que ele seja totalmente desativado, há várias alternativas recomendadas para as quais você pode considerar migrar.

Saiba mais sobre linhas do tempo e alternativas de suporte.

Os erros do App Center permitem que você manipule os erros em seu aplicativo e evite possíveis problemas em seu aplicativo. Esta seção examina como capturar e relatar os erros em seu aplicativo. Saiba mais sobre as práticas recomendadas sobre quando e como usar erros na documentação oficial para exceções.

Observação

Atualmente, só há suporte para erros manipulados na plataforma Xamarin.

Informações gerais

Ao executar o App Center em um aplicativo, o serviço relata todos os erros durante o tempo de vida do aplicativo. Esses erros são enviados ao servidor quando ocorrem (desde que haja uma conexão de rede) ou na próxima vez que o aplicativo for iniciado.

Saiba mais sobre nosso conjunto de recursos em nossa documentação erros.

Integrar o SDK de Falhas para começar

Para rastrear erros em seu aplicativo Xamarin, integre o módulo Falhas no SDK do App Center. Confira nossa Documentação do SDK de Falhas para saber como fazer isso.

Erros não capturadas (falhas)

Um erro não capturada (falha) é um erro que ocorre fora de um bloco try/catch. O App Center relata automaticamente essas falhas por padrão ao integrar o módulo de falhas do SDK do App Center.

Dentro de um compartimento Try/Catch (erros)

Ao chamar TrackError o método dentro do compartimento try/catch, você pode controlar quais informações são enviadas ao serviço do App Center quando ocorre um erro e obter uma imagem mais clara do erro e do estado do dispositivo.

Há vários benefícios usando o TrackError método :

• Envie relatórios para o serviço com maior precisão.
• Envie relatórios para o serviço com informações adicionais.

Rastrear erros manipulados no App Center

Inclua o SDK de Falhas para lidar com erros e denunciá-los ao App Center. Como parte deste módulo, você pode rastrear erros usando o TrackError método :

try
{
    int divByZero = 42 / int.Parse("0");
} catch (DivideByZeroException ex){
    Crashes.TrackError(ex);
}

Saiba mais sobre como usar o SDK de Falhas para rastrear erros no Xamarin em nossa Documentação do SDK de Falhas.

Adicionando informações adicionais à captura de erros

É possível personalizar o relatório de erros enviado ao App Center para fornecer informações adicionais para contexto adicional sobre o erro. Faça isso passando um Dicionário de pares chave/valor de cadeias de caracteres para o TrackError método . Essas propriedades são opcionais. Por exemplo:

try
{
    using (var text = File.OpenText("saved_game001.txt"))
    {
        Console.WriteLine("{0}", text.ReadLine());
        ...
    }
}
catch (FileNotFoundException ex)
{
    Crashes.TrackError(ex, new Dictionary<string,string>{
        { "Filename", "saved_game001.txt" },
        { "Where", "Reload game" },
        { "Issue", "Index of available games is corrupted" }
    });
}

Aqui, a exceção completa (por exemplo) ainda está sendo enviada de volta para o serviço do App Center, mas além disso, um Dicionário que contém informações adicionais de depuração também está sendo criado e enviado.

Limitações

• Você pode definir um máximo de 20 propriedades por erro, qualquer coisa além desse limite será rejeitada.
• O número máximo de caracteres por chave de propriedade de erro e valor da propriedade de erro é de 125 caracteres.