Inne interfejsy API WPF i WinForms

Ważne

Program Visual Studio App Center został wycofany 31 marca 2025 r. z wyjątkiem funkcji analizy i diagnostyki, które będą nadal obsługiwane do 30 czerwca 2026 r. Dowiedz się więcej.

Dostosuj poziom logu

Możesz kontrolować ilość komunikatów dziennika z App Center wyświetlanych w konsoli. Użyj interfejsu LogLevel API, aby włączyć dodatkowe rejestrowanie podczas debugowania. Domyślnie ustawione jest na ASSERT dla środowisk App Store, a WARN w przypadku innych.

Aby mieć jak najwięcej komunikatów dziennika, użyj polecenia LogLevel.Verbose.

AppCenter.LogLevel = LogLevel.Verbose;

Identyfikowanie instalacji

SDK App Center tworzy identyfikator UUID dla każdego urządzenia po zainstalowaniu aplikacji. Ten identyfikator pozostaje taki sam dla urządzenia, gdy aplikacja zostanie zaktualizowana, a nowy jest generowany tylko wtedy, gdy aplikacja zostanie ponownie zainstalowana. Poniższy interfejs API jest przydatny do celów debugowania.

System.Guid? installId = await AppCenter.GetInstallIdAsync();

Identyfikowanie użytkowników

Zestaw SDK centrum aplikacji obsługuje ustawianie identyfikatora użytkownika używanego do rozszerzania raportów o awarie. Aby użyć tej funkcji:

Skonfiguruj zestaw SDK App Center, wywołując AppCenter.Start(...) metodę zgodnie z przewodnikiem Wprowadzenie do zestawu SDK App Center.
Ustaw element userID w zestawie SDK przy użyciu następującego kodu:

AppCenter.SetUserId("your-user-id");

Po ustawieniu identyfikatora użytkownika możesz użyć funkcji wyszukiwania centrum aplikacji, aby wyszukać określone raporty o awarii dla identyfikatora. Dowiedz się więcej w dokumentacji wyszukiwania w usłudze App Center.

Uwaga / Notatka

Wartość identyfikatora użytkownika jest ograniczona do 256 znaków. Zostanie wyświetlony z raportami awarii, ale nie będzie używany do agregacji ani liczenia liczby użytkowników, których dotyczy. W przypadku ustawienia identyfikatora użytkownika wiele razy będzie używany tylko ostatni identyfikator użytkownika. Należy ustawić identyfikator użytkownika przed uruchomieniem każdej aplikacji, ponieważ ta wartość nie jest przechowywana przez zestaw SDK między uruchomieniem.

Wyłącz wszystkie usługi w czasie wykonywania

Jeśli chcesz jednocześnie wyłączyć wszystkie usługi App Center, użyj Enabled właściwości . Po wyłączeniu zestaw SDK nie będzie przekazywać żadnych informacji do Centrum aplikacji.

AppCenter.SetEnabledAsync(false);

Aby ponownie włączyć wszystkie usługi, użyj tego samego interfejsu API, ale przekaż true jako parametr.

AppCenter.SetEnabledAsync(true);

Nie musisz czekać na to wywołanie, aby inne wywołania interfejsu API (takie jak IsEnabledAsync) były spójne.

Stan jest utrwalany w magazynie urządzenia w ramach uruchamiania aplikacji.

Zmienianie stanu usługi w trakcie działania

Włącz lub wyłącz usługi w czasie wykonywania za pomocą następującego kodu:

Analytics.SetEnabledAsync(false);

Nie zezwalaj na żądania sieciowe

W zestawie SDK centrum aplikacji żądania sieciowe są domyślnie dozwolone. Jeśli chcesz wysłać dane, które SDK App Center zbiera na podstawie zgody użytkownika, możesz zablokować automatyczne wysyłanie danych.

AppCenter.IsNetworkRequestsAllowed = false;

W takim przypadku zestaw SDK centrum aplikacji będzie nadal zbierać dane, ale będzie wysyłany tylko wtedy, gdy żądania sieciowe będą dozwolone.

AppCenter.IsNetworkRequestsAllowed = true;

Uwaga / Notatka

Ta wartość jest zachowywana między startami.

W dowolnym momencie możesz sprawdzić, czy wysyłanie danych w zestawie SDK Centrum Aplikacji jest dozwolone, czy nie.

AppCenter.IsNetworkRequestsAllowed;

Sprawdzanie, czy centrum aplikacji jest włączone

Możesz również sprawdzić, czy centrum aplikacji jest włączone, czy nie.

bool enabled = await AppCenter.IsEnabledAsync();

Sprawdzanie wersji zestawu SDK App Center podczas działania

Możesz uzyskać wersję zestawu SDK centrum aplikacji, której obecnie używasz.

AppCenter.SdkVersion;

Rozmiar magazynu

W przypadku korzystania z zestawu SDK centrum aplikacji dzienniki są przechowywane lokalnie na urządzeniu. Duże dzienniki mogą zająć dużo miejsca, więc możesz ograniczyć rozmiar lokalnej bazy danych.

Za pomocą interfejsu SetMaxStorageSizeAsync API można ustawić rozmiar lokalnej bazy danych. Interfejs API jest asynchroniczny, a wywołanie zwrotne jest wywoływane podczas uruchamiania usług App Center. Z tego powodu SetMaxStorageSizeAsync należy wywołać przed wywołaniem AppCenter.Start(...). Interfejs API można wywołać tylko raz.

// 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));

Jeśli nie ustawisz maksymalnego rozmiaru przechowywania, SDK używa domyślnego maksymalnego rozmiaru 10 MB. Minimalny rozmiar, który można ustawić, to 20 KB.

Uwaga / Notatka

Rzeczywista maksymalna pojemność magazynu może być wyższa niż wybrana wartość. SqLite zaokrągla rozmiar do następnej wielokrotności rozmiaru strony. SDK Centrum Aplikacji używa rozmiaru strony 4 KB.

Uwaga / Notatka

Dzienniki starsze niż 25 dni zostaną odrzucone.