Inne interfejsy API systemu iOS

Dostosuj poziom logu

Możesz kontrolować ilość komunikatów dziennika z App Center wyświetlanych w konsoli. Użyj setLogLevel:-API, aby włączyć dodatkowe rejestrowanie podczas debugowania. Domyślnie jest ustawiona na LogLevelAssert dla środowiska App Store i LogLevelWarning w przeciwnym razie.

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

[MSACAppCenter setLogLevel:MSACLogLevelVerbose];

AppCenter.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.

NSUUID *installId = [MSACAppCenter  installId];

var installId = AppCenter.installId

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:

1. Skonfiguruj zestaw SDK App Center, wywołując :start:withServices: metodę zgodnie z przewodnikiem Wprowadzenie do zestawu SDK App Center.
2. 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 usłudze App Center.

Wyłącz wszystkie usługi w czasie wykonywania

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 jako parametr.

[MSACAppCenter setEnabled:YES];

AppCenter.enabled = true

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

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.

[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

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

[MSACAppCenter isNetworkRequestsAllowed];

AppCenter.networkRequestsAllowed

Zmienianie stanu usługi w trakcie działania

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

[MSACAnalytics setEnabled:NO];

Analytics.enabled = false

Sprawdzanie, czy centrum aplikacji jest włączone

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

[MSACAppCenter isEnabled];

AppCenter.enabled

Sprawdzanie wersji zestawu SDK App Center podczas działania

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

[MSACAppCenter sdkVersion];

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. Jest to również przydatne w połączeniu z interfejsami API pause 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 podczas uruchamiania usług App Center wywoływany jest element completionHandler. Z tego powodu setMaxStorageSize należy wywołać przed wywołaniem 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 przechowywania, SDK używa domyślnego maksymalnego rozmiaru 10 MB. Minimalny rozmiar, który można ustawić, to 20 KB.

Nieudane wywołania interfejsu API

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 na proces.
• Interfejs API został wywołany po AppCenter.start lub AppCenter.configure.

Możesz sprawdzić ostrzeżenia i błędy w konsoli przy użyciu tagu rejestru AppCenter, aby rozwiązać problemy z konfiguracją.