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.
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.
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.
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.
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.
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.
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.
É 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.
- 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.