Freigeben über


Andere WPF- und WinForms-APIs

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:

  1. Konfigurieren Sie das App Center SDK durch Aufrufen AppCenter.Start(...) , wie im Handbuch für erste Schritte im App Center SDK beschrieben.
  2. 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.