Udostępnij przez

Inne interfejsy API platformy React Native

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 wyświetlanych w Centrum aplikacji. W systemie iOS komunikaty dziennika są wyświetlane w konsoli, a w systemie Android w LogCat. Użyj interfejsu setLogLevel API, aby włączyć dodatkowe rejestrowanie podczas debugowania. Domyślnym poziomem jest LogLevel.ASSERT środowisko sklepu App Store dla systemu iOS i kompilacje wersji systemu Android. W przeciwnym razie ustawiono wartość LogLevel.WARNING.

Aby wyświetlić wszystkie komunikaty dziennika, użyj polecenia LogLevel.VERBOSE.

import AppCenter from 'appcenter';

await AppCenter.setLogLevel(AppCenter.LogLevel.VERBOSE);

Uwaga / Notatka

Interfejs API JavaScript setLogLevel nie może zwiększyć poziomu rejestrowania kodu uruchamiania aplikacji przed załadowaniem JavaScript.

Jeśli chcesz zwiększyć rejestrowanie podczas startu aplikacji, użyj natywnych interfejsów API App Center setLogLevel.

W systemie iOS wywołaj [MSACAppCenter setLogLevel: MSACLogLevelVerbose]; przed wywołaniem [AppCenterReactNative register]; (lub AppCenterReactNativeAnalytics lub AppCenterReactNativeCrashes lub AppCenterReactNativePush) w pliku AppDelegate.m projektu. Należy dodać @import AppCenter; , jeśli brakuje go w tym pliku.

W systemie Android wywołaj AppCenter.setLogLevel(android.util.Log.VERBOSE); przed SoLoader.init w wywołaniu zwrotnym onCreate w MainApplication.java.

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 lub użytkownik ręcznie usunie wszystkie dane aplikacji w systemie Android. Poniższy interfejs API jest przydatny do celów debugowania.

import AppCenter from 'appcenter';

const installId = await AppCenter.getInstallId();   // Returned as a string

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 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:
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 interfejsu setEnabled() API. Po wyłączeniu zestaw SDK nie będzie przekazywać żadnych informacji do Centrum aplikacji.

import AppCenter from 'appcenter';

await AppCenter.setEnabled(false);

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

await AppCenter.setEnabled(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.

await AppCenter.setNetworkRequestsAllowed(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.

await AppCenter.setNetworkRequestsAllowed(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.

await AppCenter.isNetworkRequestsAllowed();

Uwaga / Notatka

Wartość zapisana w SharedPreferences jest ignorowana, dopóki AppCenter nie zostanie uruchomiony na platformie Android. Zwróci ostatni zestaw wartości przy użyciu setNetworkRequestsAllowed lub true jeśli wartość nie została zmieniona przed uruchomieniem programu AppCenter.

Zmienianie stanu usługi w trakcie działania

Usługę można włączyć lub wyłączyć w czasie wykonywania przy użyciu następującego kodu:

await AppCenter.Analytics.setEnabled(false);

Sprawdzanie, czy centrum aplikacji jest włączone

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

const enabled = await AppCenter.isEnabled();

Sprawdzanie wersji zestawu SDK App Center podczas działania

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

AppCenter.getSdkVersion();
  • Last updated on