Sdílet prostřednictvím


Další rozhraní API pro React Native

Důležité

31. března 2025 je naplánované vyřazení z provozu. I když můžete dál používat Visual Studio App Center, dokud ho úplně vyřadíte, existuje několik doporučených alternativ, na které můžete zvážit migraci.

Přečtěte si další informace o časových osách a alternativách podpory.

Úprava úrovně protokolu

Můžete řídit množství zpráv protokolu, které se zobrazují z App Center. Zprávy protokolu se zobrazují v konzole v iOSu a LogCat v Androidu. setLogLevel Pomocí rozhraní API povolte další protokolování při ladění. Výchozí úroveň je LogLevel.ASSERT pro prostředí App Store iOS a buildy verze Androidu. V opačném případě je nastavená na LogLevel.WARNING.

Pokud chcete zobrazit výstup všech zpráv protokolu, použijte LogLevel.VERBOSE.

import AppCenter from 'appcenter';

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

Poznámka

Rozhraní API JavaScriptu setLogLevel nemůže zvýšit protokolování spouštěcího kódu aplikace před načtením JavaScriptu.

Pokud chcete zvýšit protokolování pro spuštění aplikace, použijte nativní rozhraní App Center setLogLevel API.

V iOSu zavolejte [MSACAppCenter setLogLevel: MSACLogLevelVerbose]; před voláním [AppCenterReactNative register]; (nebo AppCenterReactNativeAnalytics nebo AppCenterReactNativeCrashes ) AppCenterReactNativePushv projektu AppDelegate.m. Pokud v souboru chybí, musíte ho přidat @import AppCenter; .

V Androidu volejte AppCenter.setLogLevel(android.util.Log.VERBOSE); před SoLoader.init zpětným onCreate voláním v MainApplication.javasystému .

Identifikace instalací

Sada App Center SDK vytvoří UUID pro každé zařízení po instalaci aplikace. Tento identifikátor zůstane stejný pro zařízení při aktualizaci aplikace a nový identifikátor se vygeneruje jenom v případě, že se aplikace znovu nainstaluje nebo uživatel ručně odstraní všechna data aplikace na Androidu. Následující rozhraní API je užitečné pro účely ladění.

import AppCenter from 'appcenter';

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

Identifikace uživatelů

Sada App Center SDK podporuje nastavení ID uživatele , které se používá k rozšíření zpráv o chybách. Použití této funkce:

  1. Nakonfigurujte sadu App Center SDK podle pokynů v příručce Začínáme se sadou App Center SDK.
  2. V sadě SDK nastavte userID parametr pomocí následujícího kódu:
AppCenter.setUserId("your-user-id");

Po nastavení ID uživatele můžete pomocí funkce vyhledávání v App Center vyhledat konkrétní zprávy o chybách pro ID. Další informace najdete v dokumentaci k vyhledávání app center.

Poznámka

Hodnota ID uživatele je omezená na 256 znaků. Zobrazí se se zprávami o chybách, ale nepoužije se pro agregaci nebo počty ovlivněných uživatelů. Pokud nastavíte ID uživatele vícekrát, použije se pouze poslední ID uživatele. Před spuštěním každé aplikace musíte id uživatele nastavit sami, protože tato hodnota není uložená v sadě SDK mezi spuštěními.

Zakázat všechny služby za běhu

Pokud chcete zakázat všechny služby App Center najednou, použijte rozhraní setEnabled() API. Pokud je sada SDK zakázaná, nepřesměruje do App Center žádné informace.

import AppCenter from 'appcenter';

await AppCenter.setEnabled(false);

Pokud chcete znovu povolit všechny služby najednou, použijte stejné rozhraní API, ale předejte true ho jako parametr.

await AppCenter.setEnabled(true);

Stav se v úložišti zařízení během spouštění aplikací udržuje.

Zakázání síťových požadavků

V sadě App Center SDK jsou ve výchozím nastavení povolené síťové požadavky. Pokud chcete odesílat data, která sada App Center SDK shromažďuje uživatelem, můžete zakázat automatické odesílání dat.

await AppCenter.setNetworkRequestsAllowed(false);

V tomto případě sada App Center SDK dál shromažďuje data, ale budou odeslána pouze v případě, že budou povolené síťové požadavky.

await AppCenter.setNetworkRequestsAllowed(true);

Poznámka

Tato hodnota se zachová mezi zahájením.

Kdykoli můžete zkontrolovat, jestli je odesílání dat v sadě App Center SDK povolené nebo ne.

await AppCenter.isNetworkRequestsAllowed();

Poznámka

Hodnota uložená v SharedPreferences se ignoruje, dokud AppCenter se nesdílí na platformě Android. Vrátí poslední sadu hodnot pomocí setNetworkRequestsAllowed nebo true pokud se hodnota nezměnila před spuštěním AppCenter.

Změna stavu služby za běhu

Službu můžete povolit nebo zakázat za běhu pomocí následujícího kódu:

await AppCenter.Analytics.setEnabled(false);

Kontrola, jestli je povolený App Center

Můžete také zkontrolovat, jestli je App Center povolený nebo ne.

const enabled = await AppCenter.isEnabled();

Kontrola verze sady App Center SDK za běhu

Můžete získat verzi sady App Center SDK, kterou právě používáte.

AppCenter.getSdkVersion();