Errors

Articolo
03/15/2024

Importante

Visual Studio App Center è previsto per il ritiro il 31 marzo 2025. Anche se è possibile continuare a usare Visual Studio App Center fino a quando non viene completamente ritirato, esistono diverse alternative consigliate che è possibile considerare la migrazione a.

Altre informazioni sulle sequenze temporali di supporto e sulle alternative.

Gli errori del Centro app consentono di gestire gli errori nell'app ed evitare potenziali problemi nell'app. Questa sezione illustra come rilevare e segnalare gli errori nell'app. Altre informazioni sulle procedure consigliate su quando e su come usare gli errori nella documentazione ufficiale per le eccezioni.

Nota

Gli errori gestiti sono attualmente supportati solo nella piattaforma Xamarin.

Informazioni generali

Quando si esegue App Center in un'applicazione, il servizio segnala tutti gli errori durante la durata dell'applicazione. Questi errori vengono inviati al server quando si verificano (se è presente una connessione di rete) o alla successiva avvio dell'applicazione.

Altre informazioni sul set di funzionalità nella documentazione sugli errori.

Integrare l'SDK arresti anomali per iniziare

Per tenere traccia degli errori nell'app Xamarin, integrare il modulo Arresti anomali nell'SDK di App Center. Vedere la documentazione di Crashes SDK per informazioni su come eseguire questa operazione.

Errori non rilevati (arresti anomali)

Un errore non eseguito (arresto anomalo) è un errore che si verifica all'esterno di un blocco try/catch. App Center segnala automaticamente questi arresti anomali per impostazione predefinita, quando si integra il modulo di arresto anomalo di App Center SDK.

All'interno di un contenitore Try/Catch (errori)

Chiamando TrackError il metodo all'interno dell'istanza try/catch, è possibile controllare quali informazioni vengono inviate al servizio App Center quando si verifica un errore e ottenere un'immagine più chiara dell'errore e dello stato del dispositivo.

Esistono diversi vantaggi usando il TrackError metodo:

Inviare report al servizio con maggiore accuratezza.
Inviare report al servizio con informazioni aggiuntive.

Tenere traccia degli errori gestiti in App Center

Includere l'SDK arresti anomali per gestire gli errori e segnalarli a App Center. Come parte di questo modulo, è possibile tenere traccia degli errori usando il TrackError metodo:

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

Altre informazioni su come usare Crashes SDK per tenere traccia degli errori in Xamarin nella documentazione di Crashes SDK.

Aggiunta di informazioni aggiuntive al rilevamento degli errori

È possibile personalizzare il report degli errori inviato a App Center per fornire informazioni aggiuntive per ulteriori informazioni sul contesto dell'errore. Ottenere questo risultato passando un dizionario di coppie chiave/valore stringa al TrackError metodo. Queste proprietà sono facoltative. Ad esempio:

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" }
    });
}

Qui l'eccezione completa (ad esempio) viene ancora inviata al servizio App Center, ma oltre a questo, viene creato e inviato anche un dizionario contenente informazioni di debug aggiuntive.

Limitazioni

È possibile definire un massimo di 20 proprietà per errore, qualsiasi cosa oltre tale limite verrà rifiutata.
Il numero massimo di caratteri per chiave della proprietà di errore e il valore della proprietà di errore è di 125 caratteri.

Condividi tramite