Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Von Bedeutung
Visual Studio App Center wurde am 31. März 2025 eingestellt, mit Ausnahme der Analyse- und Diagnosefeatures, die bis zum 30. Juni 2026 weiterhin unterstützt werden. Weitere Informationen
Anpassen der Protokollebene
Sie können die Anzahl der Protokollmeldungen steuern, die über das App Center in der Konsole angezeigt werden. Verwenden Sie die LogLevel
API, um zusätzliche Protokollierung beim Debuggen zu aktivieren. Standardmäßig ist sie auf ASSERT
für die App Store-Umgebungen festgelegt und andernfalls auf WARN
.
Um so viele Protokollnachrichten wie möglich zu haben, verwenden Sie LogLevel.Verbose
.
AppCenter.LogLevel = LogLevel.Verbose;
Identifizieren von Installationen
Das App Center SDK erstellt eine UUID für jedes Gerät, sobald die App installiert ist. Dieser Bezeichner bleibt für ein Gerät identisch, wenn die App aktualisiert wird und eine neue nur generiert wird, wenn die App erneut installiert wird. Die folgende API ist für Debuggingzwecke nützlich.
System.Guid? installId = await AppCenter.GetInstallIdAsync();
Identifizieren von Benutzern
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 durch Aufrufen
AppCenter.Start(...)
, wie im Handbuch für erste Schritte im App Center SDK beschrieben. - Legen Sie ein
userID
SDK mit dem folgenden Code fest:
AppCenter.SetUserId("your-user-id");
Nachdem Sie eine Benutzer-ID festgelegt haben, können Sie das Suchfeature von App Center verwenden, um nach bestimmten Absturzberichten für die ID zu suchen. Weitere Informationen finden Sie in der Suchdokumentation von App Center.
Hinweis
Der Wert für die Benutzer-ID ist auf 256 Zeichen beschränkt. Sie wird mit Ihren Absturzberichten angezeigt, jedoch nicht für Aggregations- oder Zählungen der betroffenen Benutzer verwendet. Wenn Sie die Benutzer-ID mehrmals festlegen, wird nur die letzte Benutzer-ID verwendet. Sie müssen die Benutzer-ID vor dem Start jeder Anwendung selbst festlegen, da dieser Wert nicht vom SDK zwischen starts gespeichert wird.
Deaktivieren aller Dienste zur Laufzeit
Wenn Sie alle App Center-Dienste gleichzeitig deaktivieren möchten, verwenden Sie die Enabled
Eigenschaft. Wenn dies deaktiviert ist, leitet das SDK keine Informationen an das App Center weiter.
AppCenter.SetEnabledAsync(false);
Um alle Dienste erneut zu aktivieren, verwenden Sie dieselbe API, übergeben true
sie aber als Parameter.
AppCenter.SetEnabledAsync(true);
Sie müssen diesen Aufruf nicht warten, um andere API-Aufrufe (z IsEnabledAsync
. B. ) konsistent zu machen.
Der Zustand wird im Speicher des Geräts über Anwendungsstarts hinweg beibehalten.
Ändern des Dienststatus in der Laufzeit
Aktivieren oder deaktivieren Sie die Dienste zur Laufzeit mit folgendem Code:
Analytics.SetEnabledAsync(false);
Netzwerkanforderungen nicht zulassen
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.
AppCenter.IsNetworkRequestsAllowed = false;
In diesem Fall sammelt das App Center SDK weiterhin Daten, wird aber nur gesendet, wenn die Netzwerkanforderungen zulässig sind.
AppCenter.IsNetworkRequestsAllowed = true;
Hinweis
Dieser Wert wird zwischen den Starts beibehalten.
Sie können jederzeit überprüfen, ob das Senden von Daten im App Center SDK zulässig ist oder nicht.
AppCenter.IsNetworkRequestsAllowed;
Überprüfen, ob App Center aktiviert ist
Sie können auch überprüfen, ob App Center aktiviert ist oder nicht.
bool enabled = await AppCenter.IsEnabledAsync();
Überprüfen Sie die App Center SDK-Version zur Laufzeit
Sie können die Version des App Center SDK abrufen, die Sie derzeit verwenden.
AppCenter.SdkVersion;
Speichergröße
Bei Verwendung des App Center SDK werden Protokolle lokal auf dem Gerät gespeichert. Große Protokolle können viel Platz belegen, daher können Sie die Größe der lokalen Datenbank einschränken.
Sie können die SetMaxStorageSizeAsync
API verwenden, um die Größe der lokalen DB festzulegen. Die API ist asynchron, und der Rückruf wird aufgerufen, wenn Sie App Center-Dienste starten. Aus diesem Grund muss SetMaxStorageSizeAsync
vor Ihrem Aufruf von AppCenter.Start(...)
erfolgen. Sie können die API nur einmal aufrufen.
// Use 20 MB for storage.
AppCenter.SetMaxStorageSizeAsync(20 * 1024 * 1024).ContinueWith((storageTask) => {
// The storageTask.Result is false when the size cannot be honored.
});
AppCenter.Start("{Your App Secret}", typeof(Analytics));
Wenn Sie die maximale Speichergröße nicht festlegen, verwendet das SDK eine standardmäßige maximale Größ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 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.
Andere APIs
Das .NET NuGet-Paket wird für Xamarin und UWP freigegeben, die mehr Funktionen haben.
Alle APIs, die auf dieser Seite für WPF und WinForms nicht dokumentiert sind, werden entweder null
oder false
zurückgeben und keine Aktion für WPF und WinForms ausführen.
Die anderen APIs sind sichtbar, damit Sie sie in einer portablen Bibliothek verwenden können (z. B. wenn Sie das SDK in einer Xamarin.Forms-Anwendung verwenden, die ein UWP-Projekt enthält), aber diese zusätzlichen APIs werden nicht in WPF und WinForms implementiert.