Altre API di React Native

  • Articolo

Importante

Visual Studio App Center è pianificato 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 a cui è possibile prendere in considerazione la migrazione.

Altre informazioni sulle sequenze temporali di supporto e sulle alternative.

Modificare il livello di log

È possibile controllare la quantità di messaggi di log visualizzati da App Center. I messaggi di log vengono visualizzati nella console in iOS e LogCat in Android. Usare l'API setLogLevel per abilitare la registrazione aggiuntiva durante il debug. Il livello predefinito è LogLevel.ASSERT per l'ambiente App Store iOS e le build di versione di Android. In caso contrario, è impostato su LogLevel.WARNING.

Per restituire tutti i messaggi di log, usare LogLevel.VERBOSE.

import AppCenter from 'appcenter';

await AppCenter.setLogLevel(AppCenter.LogLevel.VERBOSE);

Nota

L'API JavaScript setLogLevel non può aumentare la registrazione per il codice di avvio dell'app, prima del caricamento di JavaScript.

Se vuoi aumentare la registrazione per l'avvio dell'app, usa le API native di App Center setLogLevel.

In iOS chiamare [MSACAppCenter setLogLevel: MSACLogLevelVerbose]; prima di qualsiasi chiamata a [AppCenterReactNative register]; (o AppCenterReactNativeAnalytics o AppCenterReactNativeCrashes ) AppCenterReactNativePushnel file AppDelegate.m del progetto. È necessario aggiungere @import AppCenter; se manca nel file.

In Android chiamare AppCenter.setLogLevel(android.util.Log.VERBOSE); prima SoLoader.init nel onCreate callback in MainApplication.java.

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 o l'utente elimina manualmente tutti i dati dell'app in Android. L'API seguente è utile a scopo di debug.

import AppCenter from 'appcenter';

const installId = await AppCenter.getInstallId();   // Returned as a string

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 come descritto nella guida introduttiva all'SDK di App Center.
  2. Impostare un userID nell'SDK usando il codice seguente:
AppCenter.setUserId("your-user-id");

Dopo aver impostato un ID utente, è possibile usare la funzionalità di ricerca di App Center per cercare report di arresto anomalo specifici per l'ID. Altre informazioni sono disponibili nella documentazione di ricerca di App Center.

Nota

Il valore dell'ID utente è limitato a 256 caratteri. Verrà visualizzato con i report di arresto anomalo del sistema, ma non usati per l'aggregazione o il numero di utenti interessati. Se si imposta l'ID utente più volte, verrà usato solo l'ultimo ID utente. È necessario impostare l'ID utente manualmente 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 alcuna informazione ad App Center.

import AppCenter from 'appcenter';

await AppCenter.setEnabled(false);

Per abilitare di nuovo tutti i servizi, usare la stessa API ma passare true come parametro.

await AppCenter.setEnabled(true);

Lo stato viene salvato in modo permanente nella risorsa di archiviazione del dispositivo tra i lanci dell'applicazione.

Non consentire richieste di rete

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

await AppCenter.setNetworkRequestsAllowed(false);

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

await AppCenter.setNetworkRequestsAllowed(true);

Nota

Questo valore viene mantenuto tra gli inizi.

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

await AppCenter.isNetworkRequestsAllowed();

Nota

Il valore salvato in SharedPreferences viene ignorato fino a quando AppCenter non viene avviato nella piattaforma Android. Restituisce l'ultimo valore impostato usando setNetworkRequestsAllowed o true se il valore non è stato modificato prima dell'avvio di AppCenter.

Modificare lo stato del servizio in fase di esecuzione

È possibile abilitare o disabilitare il servizio in fase di esecuzione con il codice seguente:

await AppCenter.Analytics.setEnabled(false);

Controllare se App Center è abilitato

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

const enabled = await AppCenter.isEnabled();

Controllare la versione di App Center SDK in fase di esecuzione

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

AppCenter.getSdkVersion();