Inne interfejsy API systemu iOS
Ważne
Program Visual Studio App Center ma zostać wycofany 31 marca 2025 r. Chociaż możesz nadal używać programu Visual Studio App Center do momentu jego 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 . setLogLevel:
Użyj -API, aby włączyć dodatkowe rejestrowanie podczas debugowania. Domyślnie jest ona ustawiona LogLevelAssert
na dla środowiska App Store i LogLevelWarning
w inny sposób.
Aby mieć jak najwięcej komunikatów dziennika, użyj polecenia MSACLogLevelVerbose
/LogLevel.verbose
.
[MSACAppCenter setLogLevel:MSACLogLevelVerbose];
AppCenter.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. Następujący interfejs API jest przydatny do celów debugowania.
NSUUID *installId = [MSACAppCenter installId];
var installId = AppCenter.installId
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
:start:withServices:
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:
[MSACAppCenter setUserId:@"your-user-id"];
AppCenter.userId = "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 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. Musisz ustawić identyfikator użytkownika samodzielnie przed każdym uruchomieniem 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 interfejsu setEnabled
API. Po wyłączeniu zestaw SDK nie będzie przekazywać żadnych informacji do Centrum aplikacji.
[MSACAppCenter setEnabled:NO];
AppCenter.enabled = false
Aby ponownie włączyć wszystkie usługi, użyj tego samego interfejsu API, ale przekaż YES
/true
go jako parametr.
[MSACAppCenter setEnabled:YES];
AppCenter.enabled = true
Stan jest utrwalany w magazynie urządzenia w przypadku uruchamiania aplikacji.
Uwaga
Ta metoda musi być używana tylko po AppCenter
uruchomieniu.
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.
[MSACAppCenter setNetworkRequestsAllowed:false];
AppCenter.networkRequestsAllowed = 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.
[MSACAppCenter setNetworkRequestsAllowed:true];
AppCenter.networkRequestsAllowed = true
Uwaga
Ta wartość jest zachowywana między rozpoczęciem.
W dowolnym momencie możesz sprawdzić, czy wysyłanie danych w zestawie SDK centrum aplikacji jest dozwolone, czy nie.
[MSACAppCenter isNetworkRequestsAllowed];
AppCenter.networkRequestsAllowed
Włącz lub wyłącz usługi w czasie wykonywania przy użyciu następującego kodu:
[MSACAnalytics setEnabled:NO];
Analytics.enabled = false
Uwaga
Ta metoda musi być używana tylko po Analytics
uruchomieniu.
Możesz również sprawdzić, czy centrum aplikacji jest włączone, czy nie.
[MSACAppCenter isEnabled];
AppCenter.enabled
Uwaga
Ta metoda musi być używana tylko po AppCenter
uruchomieniu. Zawsze będzie ona zwracana false
przed rozpoczęciem.
Możesz uzyskać wersję zestawu SDK centrum aplikacji, której obecnie używasz.
[MSACAppCenter sdkVersion];
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, dlatego możesz ograniczyć rozmiar lokalnej bazy danych. Jest to również przydatne w połączeniu pause
z interfejsami API i resume
. Jeśli spodziewasz się wstrzymania przez długi czas, możesz użyć większego rozmiaru bazy danych do przechowywania większej liczby zdarzeń.
Użyj interfejsu setMaxStorageSize
API, aby ustawić rozmiar lokalnej bazy danych. Interfejs API jest asynchroniczny, a element jest wywoływany completionHandler
podczas uruchamiania usług App Center. Z tego powodu setMaxStorageSize
należy wywołać metodę przed wywołaniem metody AppCenter.start
. Interfejs API można wywołać tylko raz.
// 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])
Jeśli nie ustawisz maksymalnego rozmiaru magazynu, zestaw SDK używa domyślnego maksymalnego rozmiaru 10 MB. Minimalny rozmiar, który można ustawić, wynosi 20 KB.
Uwaga
Rzeczywisty maksymalny rozmiar magazynu może być nieco 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.
Istnieje wiele powodów, dla których completionHandler
wywołanie może zwrócić wartość false.
- Określony rozmiar jest nieprawidłową wartością (mniejszą niż 20 KB lub większą niż 140 TB).
- Bieżący rozmiar bazy danych jest większy niż określony maksymalny rozmiar.
- Interfejs API został już wywołany. Można go skonfigurować tylko raz w każdym procesie.
- Interfejs API został wywołany po
AppCenter.start
lubAppCenter.configure
.
Ostrzeżenia i błędy można sprawdzić w konsoli przy użyciu tagu AppCenter
dziennika, aby rozwiązać problemy z konfiguracją.