Podpora pro Windows

  • Článek

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.

App Center v současné době podporuje diagnostiku aplikací pro UPW, WPF a WinForms. Tato část vysvětluje nové prostředí aplikací pro UPW v rámci vydání sady SDK 2.5.0. Další informace o aplikacích WPF a WinForms najdete v tématu Věnovaném diagnostickým funkcím a sadě WPF/WinForms SDK.

Univerzální platforma Windows

App Center podporuje úplnou sadu diagnostických funkcí pro aplikace pro UPW i aplikace pro UPW pro Windows Store pomocí sady SDK 2.5.0 nebo novějších verzí. Pokud chcete povolit diagnostiku App Center pro vaši aplikaci pro UPW, postupujte podle dokumentace k sadě App Center SDK pro UPW a integrujte sadu App Center SDK. Další informace o celé sadě funkcí najdete v dokumentaci k diagnostickým funkcím.

Nové prostředí diagnostiky

S vydáním sady SDK 2.5.0 v říjnu 2019 app Center vydalo nové diagnostické prostředí. Tato část podrobně popisuje vylepšení a možnosti přechodu v nové verzi.

Jaká vylepšení byla provedena?

Nové a vylepšené prostředí diagnostiky obsahuje následující doplňky:

  • Kompletní symbolické prostředí, které umožňuje nahrávat symboly v App Center. Další podrobnosti najdete v části symbolika níže.
  • Podpora zpracovaných výjimek
  • Počet ovlivněných uživatelů na chybové ukončení nebo skupinu chyb
  • Možnost přidávat poznámky podle chybového ukončení nebo skupiny chyb
  • Možnost označit skupiny chybových ukončení a chyb jako otevřené, uzavřené nebo ignorované
  • Možnost stáhnout zprávy o chybách a chybách
  • Možnost připojení, zobrazení a stažení jedné binární a jedné textové přílohy k sestavám o chybách
  • Podrobnosti o chybovém ukončení a zprávě o chybách pro jednotlivé instance chybového ukončení, včetně informací o tom, kdy se aplikace spustila, kdy došlo k chybě a jakou zemi/oblast a jazyk zařízení používalo.

Další informace o jednotlivých funkcích najdete v dokumentaci k diagnostice app center.

Jaké je prostředí přechodu?

Po aktualizaci na sadu App Center PRO UPW SDK verze 2.5.0 uvidíte data o chybách a chybách přicházejících na portál Diagnostiky App Center v novém a vylepšeném uživatelském rozhraní. Pro data o chybách a chybách zobrazená v novém uživatelském rozhraní diagnostiky musíte použít rozhraní API uvedená v části chyby. Další informace o mapování starých rozhraní API pro chybové ukončení na nová rozhraní API pro chyby najdete v dokumentaci k přechodu rozhraní API.

Symbolika

Sestavy chyb UPW zobrazují trasování zásobníku pro vlákno, které způsobilo chybové ukončení. Pokud aplikace používá .NET Native (obvykle v buildech vydaných verzí), může trasování zásobníku obsahovat adresy paměti místo názvů tříd, metod, názvů souborů a čísel řádků potřebných ke čtení a pochopení chybových ukončení.

Nesymbolicated crashes

Nesymbolikovaná chybová ukončení se zobrazují v části Diagnostika app center, abyste si mohli zobrazit některé podrobnosti ještě před nahráním symbolů. Chybějící symboly z těchto chyb se zobrazí na kartě "nesymbolicated". Pokud se chybějící symboly nahrají, nesymbolicated crash group bude nahrazena symbolickou skupinou chybových ukončení.

Nahrávání symbolů

Pokud chcete adresy paměti přeložit, musíte do App Center nahrát .appxsym soubor, který obsahuje všechny informace potřebné pro symboliku.

Místní generování symbolů

Pokud chcete získat .appxsym soubor, musíte vytvořit sadu aplikací, jak je popsáno tady. Po vytvoření sady najdete soubor symbolů jako .appxsym soubor ve složce sady aplikací.

Symboly pro aplikace integrované v buildu App Center

Služby sestavení a distribuce app center můžou automaticky vygenerovat platný soubor symbolů a nahrát je do služby Diagnostika. Pokud k sestavení a automatické distribuci aplikace koncovým uživatelům používáte App Center, nemusíte soubory symbolů ručně získávat a nahrávat do App Center.

Symboly pro aplikace publikované v Microsoft Storu

Při publikování aplikace do úložiště probíhá kompilace .NET Native na straně serveru. Symboly si proto musíte stáhnout z Partnerského centra.

  1. Vyhledejte aplikaci v seznamu a klikněte na ni.
  2. V levém panelu rozbalte nabídku Správa produktů .
  3. Klikněte na Spravovat balíčky.
  4. Klikněte na Zobrazit balíčky v pravém horním rohu odeslání (verze), pro které chcete symboly použít.
  5. Vyhledejte balíček pro verzi, pro kterou potřebujete symboly, a kliknutím na odkazy pro všechny podporované architektury stáhněte všechny symboly (například odkaz Stáhnout Windows 10 soubor symbolů (x64).

Portál App Center

  1. Přihlaste se do App Center a vyberte svou aplikaci.
  2. V nabídce vlevo přejděte do části Diagnostika a vyberte Symboly.
  3. V pravém horním rohu klikněte na Nahrát symboly a nahrajte soubor.
  4. Jakmile app Center indexuje symboly, budou pro vás symbolické chybové ukončení.

App Center API

Proces nahrávání symbolů prostřednictvím rozhraní API zahrnuje řadu tří volání rozhraní API: jedno pro přidělení místa na back-endu, jedno pro nahrání souboru a jedno pro aktualizaci stavu nahrávání. Tělo prvního volání rozhraní API by mělo být nastavené symbol_type na UWP.

  1. Aktivujte POST požadavek na rozhraní API symbol_uploads. Toto volání přidělí místo na našem back-endu pro váš soubor a vrátí symbol_upload_id vlastnost a upload_url .
curl -X POST 'https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/symbol_uploads' \
    -H 'accept: application/json' \
    -H 'X-API-Token: {API TOKEN}' \
    -H 'Content-Type: application/json' \
    -d '{JSON BODY}'
  1. upload_url Pomocí vlastnosti vrácené z prvního kroku vytvořte požadavek s hlavičkou PUT a "x-ms-blob-type: BlockBlob" zadejte umístění souboru na disku. Toto volání soubor nahraje do našich účtů back-endového úložiště. Přečtěte si další informace o hlavičkách požadavků put blob .
curl -X PUT '{upload_url}' \
    -H 'x-ms-blob-type: BlockBlob' \
    --upload-file '{path to file}'
  1. Vytvořte PATCH požadavek na rozhraní API symbol_uploads pomocí symbol_upload_id vlastnosti vrácené z prvního kroku. V textu požadavku zadejte, jestli chcete nastavit stav nahrávání na committed (úspěšně dokončeno) procesu nahrávání, nebo aborted (neúspěšně dokončeno).
curl -X PATCH 'https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/symbol_uploads/{symbol_upload_id}' \
    -H 'accept: application/json' \
    -H 'X-API-Token: {API TOKEN}' \
    -H 'Content-Type: application/json' \
    -d '{ "status": "committed" }'

Poznámka

Rozhraní API pro nahrávání symbolů nefunguje pro soubory, které jsou větší než 256 MB. K nahrání těchto souborů použijte rozhraní příkazového řádku App Center. Rozhraní příkazového řádku App Center si můžete nainstalovat podle pokynů v úložišti Rozhraní příkazového řádku app center.

Rozhraní příkazového řádku App Center

K nahrání souborů symbolů můžete použít také rozhraní příkazového řádku:

appcenter crashes upload-symbols --appxsym {symbol file}

Ignorování symbolů

Pokud App Center neobsahuje všechny soubory symbolů, které by plně symbolizovaly zprávy o chybách, jsou chybové ukončení uvedené na kartě Nesymbolicated . Požadované symboly se nahrají z této stránky, pokud k nim máte přístup.

Pokud symboly nemůžete nahrát, můžete je označit jako Ignorované tak, že vyberete řádky v tabulce a kliknete na tlačítko Ignorovat verze . Toto tlačítko říká App Center, aby zpracovala chybové ukončení a symbolizovala je co nejúplněji se symboly, které jsou v souboru. Po dokončení zpracování se zobrazí na kartě Chybové ukončení částečně symbolicky. Nová chybová ukončení, která také závisejí na stejných ID symbolů označených jako ignorovaná, obcházejí kartu Unsymbolicated , když přicházejí a procházejí systémem.

WinRT, Silverlight a další platformy

App Center kromě UPW, WPF a WinForms nepodporuje žádné jiné platformy Windows. Pokud máte aplikaci pro Windows s nativními chybami C++, můžete tato chybová ukončení nahrát do App Center prostřednictvím rozhraní API pro nahrání chybových ukončení.