Altre API macOS
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.
È 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
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 a scopo di debug.
NSUUID *installId = [MSACAppCenter installId];
var installId = AppCenter.installId
App Center SDK supporta l'impostazione di un ID utente usato per aumentare i report di arresto anomalo del sistema. Per usare questa funzionalità:
- Configurare App Center SDK chiamando
:start:withServices:
come descritto nella guida introduttiva all'SDK di App Center. - Impostare un
userID
nell'SDK usando il codice seguente:
[MSACAppCenter setUserId:@"your-user-id"];
AppCenter.userId = "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.
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.
[MSACAppCenter setEnabled:NO];
AppCenter.enabled = false
Per abilitare di nuovo 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 tra i lanci dell'applicazione.
Nota
Questo metodo deve essere utilizzato solo dopo AppCenter
l'avvio.
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.
[MSACAppCenter setNetworkRequestsAllowed:false];
AppCenter.networkRequestsAllowed = false
In questo caso, App Center SDK continua a raccogliere i dati, ma verrà inviato solo quando le richieste di rete saranno consentite.
[MSACAppCenter setNetworkRequestsAllowed:true];
AppCenter.networkRequestsAllowed = 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.
[MSACAppCenter isNetworkRequestsAllowed];
AppCenter.networkRequestsAllowed
Abilitare o disabilitare i servizi in fase di esecuzione con il codice seguente:
[MSACAnalytics setEnabled:NO];
Analytics.enabled = false
Nota
Questo metodo deve essere utilizzato solo dopo Analytics
l'avvio.
È anche possibile controllare se App Center è abilitato o meno.
[MSACAppCenter isEnabled];
AppCenter.enabled
Nota
Questo metodo deve essere utilizzato solo dopo AppCenter
l'avvio, ma restituirà false
sempre prima dell'avvio.
È possibile ottenere la versione di App Center SDK attualmente in uso.
[MSACAppCenter sdkVersion];
AppCenter.sdkVersion
Quando si usa App Center SDK, i log vengono archiviati localmente nel dispositivo. I log di grandi dimensioni possono richiedere 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 dimensioni del database maggiori per archiviare più eventi.
Usare l'API setMaxStorageSize
per impostare le dimensioni del database locale. L'API è asincrona e completionHandler
viene chiamato quando si avviano i servizi di App Center. Per questo motivo, setMaxStorageSize
è necessario chiamare prima della 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.
Nota
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.
Nota
I log più vecchi di 25 giorni verranno eliminati.
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
oAppCenter.configure
.
È possibile controllare avvisi ed errori nella console usando il AppCenter
tag di log per risolvere i problemi di configurazione.