Andere macOS-APIs
Wichtig
Visual Studio App Center wird am 31. März 2025 eingestellt. Sie können Visual Studio App Center zwar weiterhin verwenden, bis es vollständig eingestellt ist, es gibt jedoch mehrere empfohlene Alternativen, zu denen Sie eine Migration in Betracht ziehen können.
Sie können die Menge der Protokollmeldungen steuern, die aus App Center in der Konsole angezeigt werden. Verwenden Sie die setLogLevel:
-API, um während des Debuggens zusätzliche Protokollierung zu aktivieren. Standardmäßig ist sie für LogLevelAssert
die App Store-Umgebung auf festgelegt und LogLevelWarning
andernfalls.
Um so viele Protokollmeldungen wie möglich zu erhalten, verwenden Sie MSACLogLevelVerbose
/LogLevel.verbose
.
[MSACAppCenter setLogLevel:MSACLogLevelVerbose];
AppCenter.logLevel = .verbose
Das App Center SDK erstellt nach der Installation der App eine UUID für jedes Gerät. Dieser Bezeichner bleibt für ein Gerät identisch, wenn die App aktualisiert wird, und ein neuer Bezeichner wird nur generiert, wenn die App erneut installiert wird. Die folgende API ist für Debugzwecke nützlich.
NSUUID *installId = [MSACAppCenter installId];
var installId = AppCenter.installId
Das App Center SDK unterstützt das Festlegen einer Benutzer-ID , die zum Erweitern von Absturzberichten verwendet wird. So verwenden Sie diese Funktion:
- Konfigurieren Sie das App Center SDK, indem Sie aufrufen
:start:withServices:
, wie im Leitfaden Erste Schritte mit dem App Center SDK beschrieben. - Legen Sie im SDK mithilfe des folgenden Codes fest
userID
:
[MSACAppCenter setUserId:@"your-user-id"];
AppCenter.userId = "your-user-id"
Nachdem Sie eine Benutzer-ID festgelegt haben, können Sie die Suchfunktion von App Center verwenden, um nach bestimmten Absturzberichten für die ID zu suchen. Weitere Informationen finden Sie in der App Center-Suchdokumentation.
Hinweis
Der Wert für die Benutzer-ID ist auf 256 Zeichen beschränkt. Es wird zusammen mit Ihren Absturzberichten angezeigt, aber nicht für die Aggregation oder Anzahl betroffener Benutzer verwendet. Falls Sie die Benutzer-ID mehrmals festlegen, wird nur die letzte Benutzer-ID verwendet. Sie müssen die Benutzer-ID selbst festlegen, bevor jede Anwendung gestartet wird, da dieser Wert zwischen den Starts nicht vom SDK gespeichert wird.
Wenn Sie alle App Center-Dienste gleichzeitig deaktivieren möchten, verwenden Sie die setEnabled
API. Wenn es deaktiviert ist, leitet das SDK keine Informationen an App Center weiter.
[MSACAppCenter setEnabled:NO];
AppCenter.enabled = false
Um alle Dienste gleichzeitig zu aktivieren, verwenden Sie dieselbe API, übergeben YES
/true
Sie jedoch als Parameter.
[MSACAppCenter setEnabled:YES];
AppCenter.enabled = true
Der Zustand wird über Anwendungsstarts hinweg im Speicher des Geräts beibehalten.
Hinweis
Diese Methode darf erst nach dem AppCenter
Start verwendet werden.
Im App Center SDK sind Netzwerkanforderungen standardmäßig zulässig. Wenn Sie Daten senden möchten, die das App Center SDK vom Benutzer erfasst, können Sie das automatische Senden von Daten nicht zulassen.
[MSACAppCenter setNetworkRequestsAllowed:false];
AppCenter.networkRequestsAllowed = false
In diesem Fall sammelt das App Center SDK weiterhin Daten, wird jedoch nur gesendet, wenn die Netzwerkanforderungen zulässig sind.
[MSACAppCenter setNetworkRequestsAllowed:true];
AppCenter.networkRequestsAllowed = true
Hinweis
Dieser Wert wird zwischen starts beibehalten.
Sie können jederzeit überprüfen, ob das Senden von Daten im App Center SDK zulässig ist.
[MSACAppCenter isNetworkRequestsAllowed];
AppCenter.networkRequestsAllowed
Aktivieren oder deaktivieren Sie die Dienste zur Laufzeit mit folgendem Code:
[MSACAnalytics setEnabled:NO];
Analytics.enabled = false
Hinweis
Diese Methode darf erst nach dem Analytics
Start verwendet werden.
Sie können auch überprüfen, ob App Center aktiviert ist.
[MSACAppCenter isEnabled];
AppCenter.enabled
Hinweis
Diese Methode darf nur verwendet werden, nachdem AppCenter
gestartet wurde. Sie wird immer vor dem Start zurückgegeben false
.
Sie können die Version des App Center SDK abrufen, die Sie derzeit verwenden.
[MSACAppCenter sdkVersion];
AppCenter.sdkVersion
Bei Verwendung des App Center SDK werden Protokolle lokal auf dem Gerät gespeichert. Große Protokolle können viel Speicherplatz in Anspruch nehmen, sodass Sie die Größe der lokalen Datenbank einschränken können. Dies ist auch in Verbindung mit den pause
APIs und resume
nützlich. Wenn Sie erwarten, dass sie für einen längeren Zeitraum angehalten wird, können Sie eine größere Datenbankgröße verwenden, um mehr Ereignisse zu speichern.
Verwenden Sie die setMaxStorageSize
API, um die Größe der lokalen Datenbank festzulegen. Die API ist asynchron, und die completionHandler
wird aufgerufen, wenn Sie App Center-Dienste starten. Aus diesem Grund setMaxStorageSize
muss vor dem Aufruf von AppCenter.start
aufgerufen werden. Sie können die API nur einmal aufrufen.
// 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])
Wenn Sie die maximale Speichergröße nicht festlegen, verwendet das SDK eine maximale Standardgröße von 10 MB. Die Mindestgröße, die Sie festlegen dürfen, beträgt 20 KB.
Hinweis
Die tatsächliche maximale Speichergröße ist möglicherweise etwas höher als der von Ihnen ausgewählte Wert. SQLite rundet die Größe auf das nächste Vielfache der Seitengröße auf. Das App Center SDK verwendet eine Seitengröße von 4 KB.
Hinweis
Die Protokolle, die älter als 25 Tage sind, werden verworfen.
Es gibt viele Gründe, warum der completionHandler
Aufruf möglicherweise false zurückgibt.
- Die angegebene Größe ist ein ungültiger Wert (kleiner als 20 KB oder größer als 140 TB).
- Die aktuelle Datenbankgröße ist größer als die angegebene maximale Größe.
- Die API wurde bereits aufgerufen. Sie können sie nur einmal pro Prozess konfigurieren.
- Die API wurde nach
AppCenter.start
oderAppCenter.configure
aufgerufen.
Sie können Warnungen und Fehler in der Konsole mithilfe des AppCenter
Protokolltags überprüfen, um Konfigurationsprobleme zu beheben.