Altre API iOS

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.

• Androide
• Ios
• MAUI/Xamarin
• UWP
• WPF/WinForms
• React Native
• macOS
• tvOS
• Unità

Regolare il livello di log

È possibile controllare la quantità di messaggi di log visualizzati da App Center nella console. Usare - setLogLevel:API per abilitare la registrazione aggiuntiva durante il debug. Per impostazione predefinita, è impostato su LogLevelAssert per l'ambiente App Store e LogLevelWarning in caso contrario.

Per avere il maggior numero possibile di messaggi di log, usare MSACLogLevelVerbose/LogLevel.verbose.

[MSACAppCenter setLogLevel:MSACLogLevelVerbose];

AppCenter.logLevel = .verbose

Identificare le installazioni

App Center SDK crea un UUID per ogni dispositivo dopo l'installazione dell'app. Questo identificatore rimane invariato per un dispositivo quando l'app viene aggiornata e ne viene generata una nuova solo quando l'app viene nuovamente installata. L'API seguente è utile per scopi di debug.

NSUUID *installId = [MSACAppCenter  installId];

var installId = AppCenter.installId

Identificare gli utenti

App Center SDK supporta l'impostazione di un ID utente usato per aumentare i report di arresto anomalo del sistema. Per usare questa funzionalità:

1. Configurare App Center SDK chiamando :start:withServices: come descritto nella Guida introduttiva all'SDK di App Center.
2. Impostare un userID oggetto nell'SDK usando il codice seguente:

[MSACAppCenter setUserId:@"your-user-id"];

AppCenter.userId = "your-user-id"

Dopo aver impostato un ID utente, è possibile utilizzare la funzione di ricerca di App Center per trovare specifici report di crash per l'ID. Altre informazioni sono disponibili nella documentazione di ricerca di App Center.

Annotazioni

Il valore dell'ID utente è limitato a 256 caratteri. ** Verrà mostrato con i report di crash, ma non verranno usati per l'aggregazione o il conteggio degli utenti coinvolti. Se si imposta l'ID utente più volte, verrà usato solo l'ultimo ID utente. È necessario impostare manualmente l'ID utente prima dell'avvio di ogni applicazione, perché questo valore non viene archiviato dall'SDK tra i lanci.

Disabilitare tutti i servizi in fase di esecuzione

Se si vuole disabilitare tutti i servizi di App Center contemporaneamente, usare l'API setEnabled . Se disabilitato, l'SDK non inoltra informazioni ad App Center.

[MSACAppCenter setEnabled:NO];

AppCenter.enabled = false

Per abilitare nuovamente tutti i servizi, usare la stessa API ma passare YES/true come parametro.

[MSACAppCenter setEnabled:YES];

AppCenter.enabled = true

Lo stato viene salvato in modo permanente nella risorsa di archiviazione del dispositivo all'avvio dell'applicazione.

Annotazioni

Questo metodo deve essere utilizzato solo dopo l'avvio di AppCenter.

Non consentire le richieste di rete

In App Center SDK le richieste di rete sono consentite per impostazione predefinita. Se si desidera inviare dati raccolti dall'SDK di App Center dall'utente, è possibile impedire l'invio automatico dei dati.

[MSACAppCenter setNetworkRequestsAllowed:false];

AppCenter.networkRequestsAllowed = false

In questo caso, App Center SDK continua a raccogliere dati, ma verrà inviato solo quando le richieste di rete saranno consentite.

[MSACAppCenter setNetworkRequestsAllowed:true];

AppCenter.networkRequestsAllowed = true

Annotazioni

Questo valore viene mantenuto tra gli avvii.

In qualsiasi momento, è possibile verificare se l'invio di dati in App Center SDK è consentito o meno.

[MSACAppCenter isNetworkRequestsAllowed];

AppCenter.networkRequestsAllowed

Modificare lo stato del servizio in fase di esecuzione

Abilitare o disabilitare i servizi in fase di esecuzione con il codice seguente:

[MSACAnalytics setEnabled:NO];

Analytics.enabled = false

Annotazioni

Questo metodo deve essere utilizzato solo dopo l'avvio di Analytics.

Controllare se App Center è abilitato

È anche possibile verificare se App Center è abilitato o meno.

[MSACAppCenter isEnabled];

AppCenter.enabled

Annotazioni

Questo metodo deve essere usato solo dopo che AppCenter è stato avviato; restituirà sempre false prima dell'avvio.

Controllare la versione di App Center SDK in fase di esecuzione

È possibile ottenere la versione di App Center SDK attualmente in uso.

[MSACAppCenter sdkVersion];

AppCenter.sdkVersion

Dimensioni dello spazio di archiviazione

Quando si usa App Center SDK, i log vengono archiviati localmente nel dispositivo. I log di grandi dimensioni possono occupare molto spazio, pertanto è possibile scegliere di limitare le dimensioni del database locale. È utile anche in combinazione con le pause API e resume . Se si prevede di essere sospesi per molto tempo, è possibile usare una dimensione del database maggiore per archiviare più eventi.

Usare l'API setMaxStorageSize per impostare le dimensioni del database locale. L'API è asincrona e completionHandler viene chiamata quando si avviano i servizi di App Center. Per questo motivo, setMaxStorageSize deve essere chiamato prima di effettuare una chiamata a AppCenter.start. È possibile chiamare l'API una sola volta.

// Use 20 MB for storage.
[MSACAppCenter setMaxStorageSize:(20 * 1024 * 1024) completionHandler:^(BOOL success) {
    if (!success) {
        // The success parameter is false when the size can't be honored.
    }
}];
[MSACAppCenter start:@"{Your App Secret}", withServices:@[[MSACAnalytics class]]];

// Use 20 MB for storage.
AppCenter.setMaxStorageSize(20 * 1024 * 1024, completionHandler: { (success) in
    if !success {
        // The success parameter is false when the size can't be honored.
    }
})
AppCenter.start(withAppSecret: "{Your App Secret}", services:[Analytics.self])

Se non si impostano le dimensioni massime di archiviazione, l'SDK usa una dimensione massima predefinita di 10 MB. Le dimensioni minime che è possibile impostare sono pari a 20 KB.

Annotazioni

Le dimensioni massime effettive di archiviazione possono essere leggermente superiori al valore scelto. SQLite arrotonda le dimensioni fino al multiplo successivo della dimensione della pagina. App Center SDK usa una dimensione di pagina di 4 KB.

Annotazioni

I log precedenti a 25 giorni verranno eliminati.

Chiamate API non riuscite

Esistono molti motivi per cui la completionHandler chiamata può restituire false.

• La dimensione specificata è un valore non valido (minore di 20 KB o maggiore di 140 TB).
• Le dimensioni correnti del database sono maggiori delle dimensioni massime specificate.
• L'API è già stata chiamata. È possibile configurarlo una sola volta per processo.
• L'API è stata chiamata dopo AppCenter.start o AppCenter.configure.

È possibile controllare avvisi ed errori nella console usando il AppCenter tag di log per risolvere i problemi di configurazione.