Errori

Importante

Visual Studio App Center è stato ritirato il 31 marzo 2025, ad eccezione delle funzionalità di Analisi e diagnostica, che continueranno a essere supportate fino al 30 giugno 2026. Ulteriori informazioni.

Gli errori di App Center consentono di gestire gli errori nell'app ed evitare potenziali problemi nell'app. Questa sezione illustra come intercettare e segnalare gli errori nell'app. Scopri di più sulle procedure consigliate su quando e come usare gli errori nella documentazione ufficiale per le eccezioni.

Annotazioni

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 (purché sia presente una connessione di rete) o alla successiva avvio dell'applicazione.

Per altre informazioni sul set di funzionalità, vedere la documentazione relativa a Errori.

Integrare Crashes SDK per iniziare

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

Errori non rilevati (arresti anomali)

Un errore non rilevato (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 arresti anomali di App Center SDK.

All'interno di un blocco Try/Catch (Errori)

Chiamando il TrackError metodo all'interno dell'enclosure 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.

L'uso del TrackError metodo offre numerosi vantaggi:

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

Tenere traccia degli errori gestiti in App Center

Includere Crashes SDK per gestire gli errori e segnalarli ad 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 supplementari al rilevamento degli errori

È possibile personalizzare la segnalazione degli errori inviata ad App Center per fornire informazioni aggiuntive per un ulteriore contesto sull'errore. A tale scopo, passare al metodo TrackError un dizionario di coppie chiave/valore di stringhe. Queste proprietà sono facoltative. Per 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" }
    });
}

In questo caso, 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 valore superiore a tale limite verrà rifiutato.
• Il numero massimo di caratteri per chiave di proprietà di errore e il valore della proprietà di errore è di 125 caratteri.