Další rozhraní API WPF a WinForms

Důležité

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

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

• Android
• iOS
• React Native
• MAUI/Xamarin
• UWP
• WPF/WinForms
• Unity
• macOS
• tvOS
• Cordova

Úprava úrovně protokolu

Můžete řídit množství zpráv protokolu, které se zobrazí z App Center v konzole nástroje . LogLevel Pomocí rozhraní API povolte další protokolování během ladění. Ve výchozím nastavení je pro App Store prostředí WARN a jinak nastavená na ASSERT hodnotu .

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ří UUID pro každé zařízení po instalaci aplikace. Tento identifikátor zůstává stejný pro zařízení při aktualizaci aplikace a nový se vygeneruje jenom při opětovné instalaci aplikace. 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í zpráv o chybách. Použití této funkce:

1. Nakonfigurujte sadu App Center SDK voláním, AppCenter.Start(...) jak je popsáno v příručce Začínáme se sadou App Center SDK.
2. Pomocí userID následujícího kódu nastavte v sadě SDK :

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 dané ID. Další informace najdete v dokumentaci k vyhledávání v 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 ani počty ovlivněných uživatelů. Pokud nastavíte ID uživatele vícekrát, použije se jenom poslední ID uživatele. ID uživatele musíte nastavit sami před každým spuštěním aplikace, protože tuto hodnotu sada SDK mezi spuštěními neukládá.

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

Pokud chcete zakázat všechny služby App Center najednou, použijte Enabled vlastnost . Pokud je tato možnost zakázaná, sada SDK nepředá do App Center žádné informace.

AppCenter.SetEnabledAsync(false);

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

AppCenter.SetEnabledAsync(true);

Toto volání nemusíte čekat, aby ostatní volání rozhraní API (například IsEnabledAsync) byla konzistentní.

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

Změna stavu služby v modulu runtime

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

Analytics.SetEnabledAsync(false);

Zakázat síťové požadavky

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

AppCenter.IsNetworkRequestsAllowed = false;

V tomto případě sada App Center SDK nadále shromažďuje data, ale budou odeslána, pouze pokud budou povoleny síťové požadavky.

AppCenter.IsNetworkRequestsAllowed = true;

Poznámka

Tato hodnota se zachová mezi spuštěními.

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

AppCenter.IsNetworkRequestsAllowed;

Kontrola, jestli je povolená aplikace App Center

Můžete také zkontrolovat, jestli je služba 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ě v zařízení. Velké protokoly můžou zabírat hodně místa, takže se můžete rozhodnout omezit velikost místní databáze.

Pomocí rozhraní SetMaxStorageSizeAsync API můžete nastavit velikost místní databáze. Rozhraní API je asynchronní a zpětné volání se volá při spuštění služeb App Center. Z tohoto důvodu SetMaxStorageSizeAsync musí být volána před voláním .AppCenter.Start(...) Rozhraní API můžete volat 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. SQLite zaokrouhlí velikost nahoru 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í.

Other APIs

Balíček NuGet .NET se sdílí s Xamarinem a UPW, které mají více funkcí. Všechna rozhraní API, která nejsou zdokumentovaná pro WPF a WinForms na této stránce, se vrátí null nebo false a nebudou dělat nic s 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 dodatečná rozhraní API nejsou implementována ve WPF a WinForms.