Megosztás a következőn keresztül:

iOS-szimbólum

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.

a macOS, a tvOS és az iOS összeomlási jelentései az alkalmazás összes futó szálának veremnyomait jelenítik meg az összeomlás időpontjában. A verem nyomkövetései csak memóriacímeket tartalmaznak; nem osztálynevek, metódusok, fájlnevek vagy sorszámok szükségesek az összeomlások megértéséhez.

A memóriacímek lefordításához fel kell töltenie egy dSYM-csomagot az App Centerbe, amely tartalmazza a szimbólumokhoz szükséges összes információt. A szimbolikus ábrázolásról az Apple hivatalos fejlesztői dokumentációjából tudhat meg többet.

Az App Center buildelési és terjesztési szolgáltatása automatikusan létrehozhat egy érvényes dSYM- és forrástérképfájlt .zip , és feltöltheti a fájlt 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.

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.

A csomag megkeresése .dSYM

  1. Az Xcode-ban nyissa meg az Ablak menüt, majd válassza a Szervező lehetőséget.
  2. Válassza az Archívum fület.
  3. Válassza ki az alkalmazást a bal oldali oldalsávon.
  4. Kattintson a jobb gombbal a legújabb archívumra, és válassza a Megjelenítés a Finderben lehetőséget.
  5. Kattintson a jobb gombbal a fájlra a .xcarchive Finderben, és válassza a Csomagtartalom megjelenítése lehetőséget.
  6. Látnia kell egy mappát dSYMs , amely tartalmazza a dSYM-csomagot.
  7. Hozzon létre egy zip-fájlt a dSYM-csomagból.

Ha Xcode helyett Visual Studiót használ, a dSYM-fájl megkereséséhez tekintse meg a dSYM-fájlt az iOS-összeomlási naplók szimbolikus megjelenítéséhez .

Szimbólumok feltöltése

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.

React natív iOS-alkalmazások

A React natív iOS-fájlok szimbólumfájljainak beszerzéséhez hozzon létre egy ZIP-fájlt a mac dSYM-csomaggal és az alkalmazás JavaScript-forrástérképével. A forrástérképet el kell nevezni index.ios.map. Az alábbi parancsok létrehoznak egy forrástérképet a kiadási buildekhez:

react-native bundle --entry-file index.ios.js --platform ios --dev false --reset-cache --bundle-output unused.jsbundle --sourcemap-output index.ios.map

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 : Apple.

  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}'
  1. 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}'
  1. 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 --symbol {symbol file}

Bitkód

Az Apple bevezette a Bitcode-ot, hogy lehetővé tegye az App Store-ba küldött alkalmazások újrafordítását az Apple számára, és alkalmazza a legújabb optimalizálást. Ha a Bitcode engedélyezve van, az áruházban az alkalmazáshoz létrehozott szimbólumok eltérnek a saját buildrendszerétől.

Az App Center összeomlási jelentéskészítése még nem támogatja teljesen a bitkód-kompatibilis alkalmazások összeomlásainak szimbolikus megjelenítését. Addig is javasoljuk, hogy tiltsa le a bitkódot. A bitkód letiltása jelentősen leegyszerűsíti a szimbólumok kezelését, és jelenleg nincsenek ismert hátrányai az iOS-alkalmazásoknak.

Az alkalmazás bitkódjának letiltása

  1. Az Xcode-ban nyissa meg a projektbeállításokat a Project Navigátor felső szintű elemére kattintva
  2. Ugrás a Buildbeállítások lapra
  3. Keressen a bitcode kifejezésre.
  4. Az eredményben módosítsa az értéket Igenről Nem értékre
  5. Az alkalmazás újraépítése

Ezekkel az egyszerű lépésekkel az App Center összeomlási jelentéskészítése a szokásos módon fog viselkedni.

Szimbólumok lekérése bitkóddal kompatibilis alkalmazásokhoz

Ha engedélyezni szeretné a bitkód használatát, az alábbi lépések végrehajtásával letöltheti a megfelelő dSYM-fájlokat:

  1. Az Xcode szervezőjének megnyitása
  2. Válassza ki az iTunes Connectbe feltöltött alkalmazás adott archívumát
  3. Kattintson a "dSYMs letöltése" gombra. Ez a lépés beszúrja a Bitcode által lefordított dSYM-fájlokat az eredeti archívumba.
  4. A szimbólumok feltöltése a megfelelő alkalmazásba és verzióba az App Centerben

Ha az Xcode szervezője nem ad meg új szimbólumokat, az alábbi lépések végrehajtásával le kell töltenie a dSYM-fájlokat az iTunes Connect portálról:

  1. Az alkalmazás kiválasztása az iTunes Connect portálon
  2. Válassza ki a tevékenység fület a tetején
  3. Válassza ki az alkalmazás hiányzó szimbólumokat tartalmazó buildverzióját
  4. Kattintson a dSYM letöltése hivatkozásra
  5. Töltse fel a letöltött fájlt az App Centerbe. Ez a fájl tartalmazza azokat a szimbólumokat, amelyekre az App Centernek szüksége van az összeomlások szimbolikázásához.

Szimbólumokkal kapcsolatos problémák elhárítása

Ha az összeomlások a szimbólumok feltöltése és a bitkód letiltása után is változatlanul jelennek meg, annak az lehet az oka, hogy a feltöltött dSYM-fájlok nem egyeznek az App Center által igényeltekkel. DSYM-fájlok feltöltésekor az App Center az UUID-k alapján a megfelelő alkalmazásverzióhoz társítja őket.

A dwarfdump nevű parancssor-eszközzel újra ellenőrizheti, hogy a dSYM-fájlok rendelkeznek-e a megfelelő UUID-kkel.

  1. Keresse meg az UUID-t a dSYM fájlban:
dwarfdump --u CrashProbeiOS.app.dSYM
  1. Az eredménynek így kell kinéznie:
UUID:ADF53C85-4638-3EFF-A33C-42C13A18E915 (armv7)CrashProbeiOS.app.dSYM/Contents/Resources/DWARF/CrashProbeiOS
UUID:D449E33D-7E74-379D-8B79-15EE104ED1DF (arm64)CrashProbeiOS.app.dSYM/Contents/Resources/DWARF/CrashProbeiOS
  1. Ellenőrizze, hogy a visszaadott UUID megegyezik-e a hibakeresési szimbólumok párbeszédpanelen látható UUID-kkal:

Az App Center megjeleníti a szükséges szimbólumok UUID azonosítóját

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.

  • Last updated on