Inne interfejsy API React Native

  • Artykuł

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. Komunikaty dziennika są wyświetlane w konsoli w systemach iOS i LogCat w systemie Android. Użyj interfejsu setLogLevel API, aby włączyć dodatkowe rejestrowanie podczas debugowania. Domyślnym poziomem jest LogLevel.ASSERT środowisko App Store systemu iOS i kompilacje wersji systemu Android. W przeciwnym razie zostanie ustawiona 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

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

Jeśli chcesz zwiększyć rejestrowanie na potrzeby uruchamiania aplikacji, użyj natywnych interfejsów APILogLevel centrum aplikacji.

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

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

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 lub użytkownik ręcznie usunie wszystkie dane aplikacji w systemie Android. Następujący 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 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.

import AppCenter from 'appcenter';

await AppCenter.setEnabled(false);

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

await AppCenter.setEnabled(true);

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

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.

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

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.

await AppCenter.isNetworkRequestsAllowed();

Uwaga

Wartość zapisana w obszarze SharedPreferences jest ignorowana do momentu AppCenter uruchomienia na platformie Systemu Android. Spowoduje to zwrócenie ostatniej wartości ustawionej przy użyciu polecenia setNetworkRequestsAllowed lub true jeśli wartość nie została zmieniona przed uruchomieniem programu AppCenter.

Zmienianie stanu usługi w środowisku uruchomieniowym

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 centrum aplikacji w czasie wykonywania

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

AppCenter.getSdkVersion();