Erros

Importante

O Visual Studio App Center foi desativado em 31 de março de 2025, exceto para os recursos de Análise e Diagnóstico, que continuarão a ter suporte até 30 de junho de 2026. Mais informações.

Os Erros do App Center permitem-lhe tratar os erros na sua aplicação e evitar potenciais problemas na sua aplicação. Esta seção examina como detetar e relatar os erros em seu aplicativo. Saiba mais sobre as melhores práticas sobre quando e como usar erros na documentação oficial para exceções.

Observação

Atualmente, os erros manipulados são suportados apenas 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 para o 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 de Erros.

Integrar o Crashes SDK para começar

Para controlar erros em seu aplicativo Xamarin, integre o módulo Falhas no SDK do App Center. Consulte a nossa Documentação do SDK Crashes para saber como fazê-lo.

Erros não detetados (falhas)

Um erro não detetado (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 de tentativa/captura (erros)

Ao chamar o método TrackError dentro de um bloco try/catch, pode-se controlar quais informações são enviadas para o serviço do App Center quando ocorre um erro, e ter uma visão mais clara do erro e do estado do dispositivo.

Há uma série de 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 Crashes para lidar com erros e relatá-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 Crashes SDK para rastrear erros no Xamarin em nossa Documentação do Crashes SDK.

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. Para isso, passe um dicionário de pares chave/valor de cadeias de caracteres para o TrackError método. Estas 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 (ex) ainda está sendo enviada de volta para o serviço App Center, mas, além disso, um dicionário contendo 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 de propriedade de erro é de 125 caracteres.