Podpora windows

Důležité

31. března 2025 je naplánované vyřazení sady Visual Studio App Center. I když můžete Visual Studio App Center dál používat, dokud nebude plně vyřazený, 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 podpory a alternativách.

App Center v současné době podporuje diagnostiku pro aplikace UPW, WPF a WinForms. Tato část vysvětluje nové prostředí pro aplikace pro UPW v rámci vydání sady SDK verze 2.5.0. Další informace o aplikacích WPF a WinForms najdete v tématu Diagnostické funkce a sada WPF/WinForms SDK.

Univerzální platforma Windows

App Center podporuje úplnou sadu funkcí diagnostiky pro aplikace UPW na straně i 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 sady App Center SDK pro UPW a integrujte sadu App Center SDK. Další informace o kompletní 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 vydala App Center nové prostředí diagnostiky. 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 zahrnuje následující doplňky:

• Plnohodnotné symbolické prostředí, které umožňuje nahrát 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 chybu nebo skupinu chyb
• Možnost přidávat poznámky na chybové ukončení nebo skupinu chyb
• Možnost označit chybové ukončení a skupiny chyb jako otevřené, zavřené nebo ignorováné
• Schopnost stahovat chybové ukončení a zprávy o chybách
• Možnost připojení, zobrazení a stažení jednoho binárního souboru a jedné textové přílohy do zpráv o chybách
• Podrobnosti o chybovém ukončení a zprávě o chybách pro každou instanci chybového ukončení, včetně toho, kdy se aplikace spustila, kdy došlo k chybovému ukončení a jaké zemi/oblasti a jazyku zařízení použilo

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 UPW SDK verze 2.5.0 se v novém a vylepšeném uživatelském rozhraní zobrazí chybové ukončení a chybová data přicházející na portál App Center Diagnostics. V případě chybového ukončení a chybových dat zobrazených v novém uživatelském rozhraní diagnostiky musíte použít rozhraní API uvedená v části chyby. Další informace o tom, jak stará rozhraní API chyb mapují na nová rozhraní API chyb, najdete v dokumentaci k přechodu rozhraní API.

Symbolika

Sestavy chybových ukončení 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

Nesymbolicated crashes are displayed in the App Center Diagnostics section, you can view some details even before uploading symbols. Chybějící symboly z těchto chyb se zobrazí na kartě "Bez znaméně". Pokud se chybějící symboly nahrají, skupina chyb, která není vymbolicovaná, nahradí symbolickou skupinou chybových ukončení.

Nahrání symbolů

Pokud chcete přeložit adresy paměti, musíte nahrát .appxsym soubor do App Center, 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 zde. Po vytvoření sady prostředků 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 ho do diagnostické služby. Pokud k vytváření a automatické distribuci aplikace koncovým uživatelům používáte App Center, nemusíte soubory symbolů do App Center získávat a nahrávat ručně.

Symboly pro aplikace publikované v Microsoft Storu

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

1. Vyhledejte aplikaci v seznamu a klikněte na ni.
2. Z levého 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 pro odeslání (verzi), pro které chcete symboly.
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 stáhnout soubor symbolů Windows 10 (x64).

Poznámka:

Aby aplikace vygenerovala symboly ladění, musí deklarovat závislost na libovolné verzi .NET Native. Tato deklarace by měla být zahrnuta v <Dependencies> části vašeho AppxManifest.xmloddílu . Příklad:

<PackageDependency Name="Microsoft.NET.Native.Framework.2.2" MinVersion="2.2.29512.0" Publisher="CN=Microsoft Corporation, 0=Microsoft Corporation, L=Redmond, S=Washington, C=US"/>
<PackageDependency Name="Microsoft.NET.Native.Runtime.2.2" MinVersion="2 2.28604.0" Publisher="CN=Microsoft Corporation, 0=Microsoft Corporation, L=Redmond, S=Washington, C=US"/>

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. Po indexování symbolů v App Center se pro vás symbolizuje 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, jeden pro nahrání souboru a jeden 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 hodnotu a upload_url vlastnost.

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}'

2. upload_url Pomocí vlastnosti vrácené z prvního kroku vytvořte požadavek s hlavičkouPUT: "x-ms-blob-type: BlockBlob" a zadejte umístění souboru na disku. Toto volání nahraje soubor do našich back-endových účtů úložiště. Přečtěte si další informace o hlavičkách požadavku PUT Blob .

curl -X PUT '{upload_url}' \
    -H 'x-ms-blob-type: BlockBlob' \
    --upload-file '{path to file}'

3. PATCH Vytvořte požadavek na rozhraní API symbol_uploads pomocí symbol_upload_id vlastnosti vrácené z prvního kroku. V textu požadavku určete, jestli chcete nastavit stav nahrávání na committed proces nahrávání (úspěšně dokončeno), 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ání symbolu nefunguje u souborů, 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 můžete nainstalovat podle pokynů v úložišti rozhraní příkazového řádku App Center.

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

Soubory symbolů můžete nahrát také pomocí rozhraní příkazového řádku:

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

Ignorování symbolů

Pokud App Center neobsahuje všechny soubory symbolů k úplnému symbolickému hlášení o chybách, jsou chyby 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 zpracovával chybové ukončení a symbolizoval je co nejplněji pomocí symbolů v souboru. Jakmile zpracování dokončí, zobrazí se na kartě Chybové ukončení částečně symbolicky. Nové chyby, které také závisejí na stejných ID symbolů označených jako ignorování, se při jejich průchodu systémem obejití karty Unsymbolicated .

WinRT, Silverlight a další platformy

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