Udostępnij za pośrednictwem


Inne interfejsy API systemu macOS

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.

Dostosowywanie poziomu dziennika

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

Identyfikowanie instalacji

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

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 centrum aplikacji, wywołując wywołanie :start:withServices: metody zgodnie z opisem w przewodniku Wprowadzenie do zestawu SDK centrum aplikacji.
  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 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.

Wyłączanie wszystkich usług 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 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.

Nie zezwalaj na żądania sieciowe

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

Zmienianie stanu usługi w środowisku uruchomieniowym

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.

Sprawdzanie, czy centrum aplikacji jest włączone

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.

Sprawdzanie wersji zestawu SDK centrum aplikacji w czasie wykonywania

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

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 w każdym procesie.
  • Interfejs API został wywołany po AppCenter.start lub AppCenter.configure.

Ostrzeżenia i błędy można sprawdzić w konsoli przy użyciu tagu AppCenter dziennika, aby rozwiązać problemy z konfiguracją.