Sdílet prostřednictvím

Další rozhraní API WPF a WinForms

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 v konzole. LogLevel Pomocí rozhraní API můžete povolit další protokolování při ladění. Ve výchozím nastavení je to nastaveno na ASSERT pro prostředí App Storu a WARN pro ostatní případy.

Pokud chcete mít co nejvíce zpráv protokolu, použijte LogLevel.Verbose.

AppCenter.LogLevel = LogLevel.Verbose;

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í, když se aplikace aktualizuje a vygeneruje se nový, jenom když se aplikace znovu nainstaluje. Následující rozhraní API je užitečné pro účely ladění.

System.Guid? installId = await AppCenter.GetInstallIdAsync();

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 voláním AppCenter.Start(...) podle popisu 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 tuto vlastnost Enabled. Pokud je tato možnost zakázaná, sada SDK nepředá žádné informace do App Centeru.

AppCenter.SetEnabledAsync(false);

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

AppCenter.SetEnabledAsync(true);

Toto volání nemusíte čekat, pokud chcete provádět další volání rozhraní API (například IsEnabledAsync) konzistentně.

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

Změna stavu služby za běhu

Povolte nebo zakažte služby za běhu pomocí následujícího kódu:

Analytics.SetEnabledAsync(false);

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.

AppCenter.IsNetworkRequestsAllowed = 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.

AppCenter.IsNetworkRequestsAllowed = 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.

AppCenter.IsNetworkRequestsAllowed;

Kontrola, jestli je služba App Center povolená

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

bool enabled = await AppCenter.IsEnabledAsync();

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.SdkVersion;

Velikost úložiště

Při použití sady App Center SDK se protokoly ukládají místně na zařízení. Velké protokoly můžou zabírat hodně místa, takže se můžete rozhodnout omezit velikost místní databáze.

K nastavení velikosti místní databáze můžete použít SetMaxStorageSizeAsync rozhraní API. Rozhraní API je asynchronní a zpětné volání je spuštěno, když spustíte služby App Center. Z tohoto důvodu SetMaxStorageSizeAsync musí být volána před vaším voláním AppCenter.Start(...). Rozhraní API můžete zavolat pouze jednou.

// Use 20 MB for storage.
AppCenter.SetMaxStorageSizeAsync(20 * 1024 * 1024).ContinueWith((storageTask) => {
    // The storageTask.Result is false when the size cannot be honored.
});
AppCenter.Start("{Your App Secret}", typeof(Analytics));

Pokud nenastavíte maximální velikost úložiště, sada SDK použije výchozí maximální velikost 10 MB. Minimální velikost, kterou můžete nastavit, je 20 kB.

Poznámka:

Skutečná maximální velikost úložiště může být vyšší než hodnota, kterou jste zvolili. Funkce SQLite zaokrouhlí velikost až na další násobek velikosti stránky. Sada App Center SDK používá velikost stránky 4 kB.

Poznámka:

Protokoly starší než 25 dnů se zahodí.

Jiná rozhraní API

Balíček NuGet .NET se sdílí s Xamarinem a UPW, který má více funkcí. Všechna rozhraní API, která nejsou zdokumentována pro WPF a WinForms na této stránce, vrátí null nebo false a neprovedou žádnou akci v rámci WPF a WinForms. Ostatní rozhraní API jsou viditelná, takže je můžete použít v přenosné knihovně (například při použití sady SDK v aplikaci Xamarin.Forms, která obsahuje projekt UPW), ale tato další rozhraní API se neimplementují ve WPF a WinForms.

  • Last updated on