Inne interfejsy API platformy UWP i winUI
Ważne
Program Visual Studio App Center ma zostać wycofany 31 marca 2025 r. Mimo że możesz nadal używać programu Visual Studio App Center do momentu jej pełnego wycofania, istnieje kilka zalecanych alternatyw, do których można rozważyć migrację.
Dowiedz się więcej o osiach czasu pomocy technicznej i alternatywach.
Możesz kontrolować ilość komunikatów dziennika wyświetlanych w centrum aplikacji w konsoli programu . Użyj interfejsu LogLevel
API, aby włączyć dodatkowe rejestrowanie podczas debugowania. Domyślnie jest ona ustawiana ASSERT
dla środowisk App Store i WARN
w inny sposób.
Aby mieć jak najwięcej komunikatów dziennika, użyj polecenia LogLevel.Verbose
.
AppCenter.LogLevel = LogLevel.Verbose;
Zestaw SDK centrum aplikacji 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();
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 centrum aplikacji, wywołując wywołanie
AppCenter.Start(...)
metody zgodnie z opisem w przewodniku Wprowadzenie do zestawu SDK centrum aplikacji. - 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 App Center, aby wyszukać określone raporty o awarii dla identyfikatora. Dowiedz się więcej w dokumentacji wyszukiwania centrum aplikacji.
Uwaga
Wartość identyfikatora użytkownika jest ograniczona do 256 znaków. Zostanie on wyświetlony z raportami awarii, ale nie będzie używany do agregacji lub liczby użytkowników, których dotyczy problem. Jeśli ustawisz identyfikator użytkownika wiele razy, zostanie użyty 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.
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
go 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.
Włącz lub wyłącz usługi w czasie wykonywania przy użyciu następującego kodu:
Analytics.SetEnabledAsync(false);
W zestawie SDK centrum aplikacji żądania sieciowe są domyślnie dozwolone. Jeśli chcesz wysłać dane zbierane przez zestaw SDK centrum aplikacji przez użytkownika, możesz uniemożliwić automatyczne wysyłanie danych.
AppCenter.IsNetworkRequestsAllowed = false;
W takim przypadku zestaw SDK centrum aplikacji nadal zbiera dane, ale będzie wysyłany tylko wtedy, gdy żądania sieciowe będą dozwolone.
AppCenter.IsNetworkRequestsAllowed = true;
Uwaga
Ta wartość jest zachowywana między uruchamianiami.
W dowolnym momencie możesz sprawdzić, czy wysyłanie danych w zestawie SDK centrum aplikacji jest dozwolone, czy nie.
AppCenter.IsNetworkRequestsAllowed;
Możesz również sprawdzić, czy centrum aplikacji jest włączone, czy nie.
bool enabled = await AppCenter.IsEnabledAsync();
Możesz pobrać wersję zestawu SDK centrum aplikacji, której obecnie używasz.
AppCenter.SdkVersion;
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ć wywołanie przed połączeniem z usługą 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 magazynu, zestaw SDK używa domyślnego maksymalnego rozmiaru 10 MB. Minimalny rozmiar, który można ustawić, to 20 KB.
Uwaga
Rzeczywisty maksymalny rozmiar magazynu może być wyższy niż wybrana wartość. SqLite zaokrągla rozmiar do następnej wielokrotności rozmiaru strony. Zestaw SDK centrum aplikacji używa rozmiaru strony o rozmiarze 4 KB.
Uwaga
Dzienniki starsze niż 25 dni zostaną odrzucone.