Další rozhraní API pro UPW a WinUI
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.
Můžete řídit množství zpráv protokolu, které se zobrazí z App Center v konzole. LogLevel
Pomocí rozhraní API povolte další protokolování při ladění. Ve výchozím nastavení je nastavená na ASSERT
pro App Store prostředí a WARN
jinak.
Pokud chcete mít co nejvíce zpráv protokolu, použijte LogLevel.Verbose
.
AppCenter.LogLevel = LogLevel.Verbose;
Sada App Center SDK vytvoří UUID pro každé zařízení po instalaci aplikace. Tento identifikátor zůstane stejný pro zařízení, když se aplikace aktualizuje, a nový identifikátor se vygeneruje jenom v případě, že se aplikace znovu nainstaluje. Následující rozhraní API je užitečné pro účely ladění.
System.Guid? installId = await AppCenter.GetInstallIdAsync();
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:
- 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. - 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.
Pokud chcete zakázat všechny služby App Center najednou, použijte vlastnost Enabled
. Pokud je sada SDK zakázaná, nepřesměruje 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);
Na toto volání nemusíte čekat, aby byla další volání rozhraní API (například IsEnabledAsync
) konzistentní.
Stav se v úložišti zařízení během spouštění aplikací udržuje.
Povolte nebo zakažte služby za běhu pomocí následujícího kódu:
Analytics.SetEnabledAsync(false);
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.
AppCenter.IsNetworkRequestsAllowed = 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.
AppCenter.IsNetworkRequestsAllowed = 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.
AppCenter.IsNetworkRequestsAllowed;
Můžete také zkontrolovat, jestli je App Center povolený nebo ne.
bool enabled = await AppCenter.IsEnabledAsync();
Můžete získat verzi sady App Center SDK, kterou právě používáte.
AppCenter.SdkVersion;
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.
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 na 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ž vámi zvolená hodnota. SQLite zaokrouhlí velikost 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í.