Sdílet prostřednictvím

Další nativní rozhraní API Reactu

Důležité

Visual Studio App Center bylo vyřazeno 31. března 2025 s výjimkou funkcí Analýzy a diagnostiky, které se budou dál podporovat až do 30. června 2026. Další informace.

Nastavte úroveň 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 můžete povolit další protokolování při ladění. Výchozí úroveň je LogLevel.ASSERT pro prostředí App Store pro iOS a buildy verzí pro Android. V opačném případě je nastavená na LogLevel.WARNINGhodnotu .

K výstupu všech zpráv protokolu použijte LogLevel.VERBOSEpříkaz .

import AppCenter from 'appcenter';

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

Poznámka:

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

Pokud chcete zvýšit úroveň protokolování při spuštění aplikace, použijte nativní rozhraní API App Center setLogLevel.

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

V Androidu zavolejte AppCenter.setLogLevel(android.util.Log.VERBOSE); před SoLoader.init v callbacku onCreate v MainApplication.java.

Identifikace instalací

Sada App Center SDK vytvoří identifikátor UUID pro každé zařízení po instalaci aplikace. Tento identifikátor zůstane stejný pro zařízení při aktualizaci aplikace a vygeneruje se nový jenom v případě, že se aplikace znovu nainstaluje nebo uživatel ručně odstraní všechna data aplikace v 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í hlášení o chybách. Pokud chcete použít tuto funkci:

  1. Nakonfigurujte sadu App Center SDK, jak je popsáno v příručce Začínáme se sadou App Center SDK.
  2. Nastavte userID v sadě SDK pomocí následujícího kódu:
AppCenter.setUserId("your-user-id");

Po nastavení uživatelského ID můžete pomocí vyhledávací funkce v App Center vyhledat konkrétní zprávy o chybách spojené s tímto ID. Další informace najdete v dokumentaci ke vyhledávání v App Centeru.

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 nastavit ID uživatele, protože tato hodnota není uložená sadou SDK mezi spuštěními.

Zakázat všechny služby během provozu

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

import AppCenter from 'appcenter';

await AppCenter.setEnabled(false);

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

await AppCenter.setEnabled(true);

Stav se zachová v úložišti zařízení napříč spuštěním aplikace.

Zákaz 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 se souhlasem uživatele, můžete vypnout automatické odesílání dat.

await AppCenter.setNetworkRequestsAllowed(false);

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

await AppCenter.setNetworkRequestsAllowed(true);

Poznámka:

Tato hodnota se uchovává mezi starty.

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 nebude spuštěna na platformě Android. Vrátí poslední sadu hodnot pomocí setNetworkRequestsAllowed nebo true pokud se hodnota před spuštěním AppCenter nezměnila.

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 služba App Center povolená

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 aktuálně používáte.

AppCenter.getSdkVersion();
  • Last updated on