Windows-támogatás

Fontos

A Visual Studio App Center 2025. március 31-én megszűnt, kivéve az Elemzési és diagnosztikai funkciókat, amelyek 2026. június 30-ig továbbra is támogatottak lesznek. Tudj meg többet.

Az App Center jelenleg támogatja az UWP-, WPF- és WinForms-alkalmazások diagnosztikáit. Ez a szakasz a 2.5.0 SDK-kiadás részeként az UWP-alkalmazások új felületét ismerteti. A WPF- és WinForms-alkalmazásokkal kapcsolatos további információkért lásd a diagnosztikai funkciókat és a WPF/WinForms SDK-t.

Az univerzális Windows-platform

Az App Center támogatja a teljes diagnosztikai funkciókészletet mind az oldalbetöltéses, mind a Windows Áruházbeli UWP-alkalmazások számára, ha a 2.5.0-s vagy annál újabb SDK verziót használják. Ha engedélyezni szeretné az App Center diagnosztika használatát az UWP-alkalmazáshoz, kövesse az App Center UWP SDK dokumentációját az App Center SDK integrálásához. A diagnosztikai funkciók dokumentációjában további információt talál a teljes funkciókészletről.

Új diagnosztikai élmény

A 2019. októberi 2.5.0 SDK-s kiadással az App Center új diagnosztikai felületet adott ki. Ez a szakasz az új kiadás fejlesztéseit és áttűnési élményét ismerteti.

Milyen fejlesztések történtek?

Az új és továbbfejlesztett diagnosztikai felület a következő kiegészítéseket tartalmazza:

• Teljes szimbolikus felület, amellyel szimbólumokat tölthet fel az App Centerben. További részletekért tekintse meg az alábbi szimbolikus szakaszt.
• Kezelt kivételek támogatása
• Összeomlásonként vagy hibacsoportonként érintett felhasználók száma
• Széljegyzetek hozzáadása összeomlásonként vagy hibacsoportonként
• Összeomlási és hibacsoportok megjelölése nyitottként, bezártként vagy figyelmen kívül hagyvaként
• Összeomlási és hibajelentések letöltésének képessége
• Egy bináris és egy szöveges melléklet csatolásának, megtekintésének és letöltésének lehetősége az összeomlási jelentésekhez.
• Összeomlási és hibajelentési adatok összeomlási példányonként, beleértve az alkalmazás indításának, összeomlásának, valamint az eszköz által használt országnak/régiónak és nyelvnek a részleteit

Az egyes funkciókról az App Center diagnosztikai dokumentációjában olvashat bővebben.

Mi az átmeneti élmény?

Miután frissített az App Center UWP SDK 2.5.0-s verziójára, egy új és továbbfejlesztett felhasználói felületen megjelenik az összeomlási és hibaadatok az App Center diagnosztikai portálján. Az új diagnosztikai felhasználói felületen megjelenő összeomlási és hibaadatokhoz a hibák szakaszban felsorolt API-kat kell használnia. További információ arról, hogy a régi összeomlási API-k hogyan képeznek le az API-k áttűnési dokumentációjában szereplő új hibák API-jaira.

Szimbolika

Az UWP összeomlási jelentései az összeomlást okozó szál veremkövetését mutatják. Ha az alkalmazás .NET Natív verziót használ (általában kiadási buildekben), a verem nyomkövetése az osztálynevek, metódusok, fájlnevek és sorszámok helyett memóriacímeket tartalmazhat az összeomlások olvasásához és megértéséhez.

Nem szimbolizált hibák

A szimbólum nélküli összeomlások az App Center diagnosztika szakaszában jelennek meg, így a szimbólumok feltöltése előtt is megtekintheti néhány részletüket. A hiányzó szimbólumok ezekből az összeomlásokból a "szimbólum nélküliek" fülön jelennek meg. Ha a hiányzó szimbólumok fel vannak töltve, a szimbólum nélküli összeomlási csoportot egy szimbólumokkal ellátott összeomlási csoport váltja fel.

Szimbólumok feltöltése

A memóriacímek lefordításához fel kell töltenie egy .appxsym fájlt az App Centerbe, amely tartalmazza a szimbólumhoz szükséges összes információt.

A szimbólumok helyi létrehozása

A fájlok beszerzéséhez .appxsym létre kell hoznia egy alkalmazáscsomagot az itt leírtak szerint. Miután létrehozta a csomagot, a szimbólumfájlt fájlként .appxsym fogja megtalálni az alkalmazáscsomag mappájában.

Az App Center Buildben beépített alkalmazások szimbólumai

Az App Center buildelési és terjesztési szolgáltatásai automatikusan létrehozhatnak egy érvényes szimbólumfájlt, és feltölthetők a Diagnosztikai szolgáltatásba. Ha az App Center használatával készíti el és osztja el automatikusan az alkalmazást a végfelhasználók között, nem kell manuálisan beszereznie és feltöltenie a szimbólumfájlokat az App Centerbe.

A Microsoft Store-ban közzétett alkalmazások szimbólumai

Amikor közzéteszi az alkalmazást az áruházban, a .NET Native fordítása a kiszolgálóoldalon történik. Ezért le kell töltenie a szimbólumokat a Partnerközpontból.

1. Keresse meg az alkalmazást a listában, és kattintson rá.
2. Bontsa ki a Termékfelügyelet menüt a bal oldali panelről.
3. Kattintson a Csomagok kezelése elemre.
4. Kattintson a Csomagok megjelenítése elemre a jobb felső sarokban annak a beküldésnek (verziónak) a megjelenítéséhez, amelyhez szimbólumokat szeretne használni.
5. Keresse meg annak a verziónak a csomagját, amelyhez szimbólumokra van szüksége, és kattintson az összes támogatott architektúra hivatkozásaira az összes szimbólum letöltéséhez (például a Windows 10-es szimbólumfájl letöltése (x64) hivatkozáshoz).

Megjegyzés:

Az alkalmazásnak deklarálnia kell egy függőséget a .NET natív verziójától a hibakeresési szimbólumok létrehozásához. Ezt a deklarációt be kell foglalni a <Dependencies> szakaszba az ön AppxManifest.xml-jában. Példa:

<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"/>

App Center Portál

1. Jelentkezzen be az App Centerbe, és válassza ki az alkalmazást.
2. A bal oldali menüben lépjen a Diagnosztika szakaszra, és válassza a Szimbólumok lehetőséget.
3. A jobb felső sarokban kattintson a Szimbólumok feltöltése elemre, és töltse fel a fájlt.
4. Miután az App Center indexelte a szimbólumokat, az összeomlások az Ön számára lesznek jelképezve.

App Center API

A szimbólumok API-n keresztüli feltöltésének folyamata három API-hívásból áll: az egyik a háttérrendszeren lévő hely lefoglalása, egy a fájl feltöltése, a másik pedig a feltöltés állapotának frissítése. Az első API-hívás törzsének a következőre kell állítania symbol_type : UWP.

1. Küldjön egy kérést POST a symbol_uploads API-nak. Ez a hívás helyet biztosít a fájl számára a háttérrendszerünkön, és visszaad egy symbol_upload_id és egy upload_url tulajdonságot.

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. Az upload_url tulajdonság használatával küldjön egy PUT kérést a fejléchez: "x-ms-blob-type: BlockBlob" és adja meg a fájl helyét a lemezen. Ez a hívás feltölti a fájlt a háttértárfiókokba. További információ a PUT Blob-kérelem fejléceiről .

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

3. Küldjön kérést PATCH az symbol_uploads API-nak az symbol_upload_id első lépésben visszaadott tulajdonság használatával. A kérelem törzsében adja meg, hogy a feltöltés állapotát a feltöltési committed folyamat (sikeresen befejezett) állapotára szeretné-e beállítani, vagy aborted (sikertelenül befejeződött).

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

Megjegyzés:

A szimbólumfeltöltési API nem működik a 256 MB-nál nagyobb fájlok esetében. Ezeket a fájlokat az App Center parancssori felületével töltheti fel. Az App Center parancssori felületét az App Center CLI-adattár utasításait követve telepítheti.

App Center CLI

A parancssori felülettel szimbólumfájlokat is feltölthet:

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

Szimbólumok figyelmen kívül hagyása

Ha az App Center nem rendelkezik az összes olyan szimbólumfájllal, amely teljes mértékben jelképezi az összeomlási jelentéseket, az összeomlások a Nem található lapon jelennek meg. Ha rendelkezik hozzáféréssel ezekhez a szimbólumokhoz, a rendszer feltölti a szükséges szimbólumokat erről a lapról.

Ha nem tudja feltölteni a szimbólumokat, megjelölheti őket figyelmen kívül hagyvaként , ha kijelöli a táblázat sorait, és a Verziók figyelmen kívül hagyása gombra kattint. Ez a gomb arra utasítja az App Centert, hogy dolgozza fel az összeomlásokat, és a lehető legteljesebben szimbolizálja őket a fájl szimbólumaival. Miután befejezték a feldolgozást, azok részben szimbolizálva jelennek meg az Összeomlások lapon. Az új összeomlások, amelyek ugyanazoktól a figyelmen kívül hagyott szimbólumazonosítóktól függenek, átugorják a szimbólum nélküli lapot, ahogy beérkeznek és keresztülhaladnak a rendszeren.

WinRT, Silverlight és egyéb platformok

Az App Center az UWP, a WPF és a WinForms mellett más Windows-platformokat sem támogat. Ha natív C++ összeomlásokkal rendelkező Windows-alkalmazással rendelkezik, az összeomlásokat az Összeomlások API-val töltheti fel az App Centerbe.