Symbolika pro iOS

Důležité

Visual Studio App Center bylo vyřazeno 31. března 2025 s výjimkou funkcí Analýzy a diagnostiky, které se budou dál podporovat až do 30. června 2026. Další informace.

V hlášení o pádech systému macOS, tvOS a iOS se zobrazují trasování zásobníku pro všechna spuštěná vlákna vaší aplikace při pádu. Trasování zásobníku obsahuje pouze adresy paměti; neobsahuje názvy tříd, metody, názvy souborů ani čísla řádků, které jsou potřeba k pochopení chybových ukončení.

Abyste získali přeložené adresy paměti, musíte nahrát balíček dSYM do App Center, který obsahuje všechny informace potřebné pro symboliku. Další informace o symbolizaci najdete v oficiální dokumentaci apple pro vývojáře.

Služba Sestavení a distribuce App Center může automaticky vygenerovat platný soubor dSYM a soubor zdrojové mapy .zip 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ů získávat a nahrávat ručně.

Nesymbolikované pády

Nesymbolikované pády jsou zobrazeny v sekci Diagnostika v App Center, takže můžete vidět některé podrobnosti, i když ještě nebyly nahrány symboly. Chybějící symboly z těchto chyb se zobrazí na kartě "Neznaménkované". Pokud se chybějící symboly nahrají, neskupinová skupina havárií bude nahrazena skupinou havárií, která je symbolikovaná.

Vyhledání .dSYM sady

  1. V Xcode otevřete nabídku Okno a pak vyberte Organizátor.
  2. Vyberte kartu Archivy .
  3. Vyberte aplikaci na levém bočním panelu.
  4. Klikněte pravým tlačítkem na nejnovější archiv a vyberte Zobrazit ve Finderu.
  5. Klikněte pravým tlačítkem myši na soubor ve Finderu .xcarchive a vyberte Zobrazit obsah balíčku.
  6. Měla by se zobrazit složka s názvem dSYMs , která obsahuje sadu dSYM.
  7. Vytvořte soubor ZIP sady dSYM.

Pokud používáte Visual Studio místo Xcode, podívejte se na Kde najdu soubor dSYM, abych mohl symbolikovat záznamy o pádech iOS? a vyhledejte soubor dSYM.

Nahrání symbolů

Portál centra aplikací

  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 jsou symboly indexovány App Centerem, chybová hlášení budou pro vás symbolizována.

Aplikace React Native pro iOS

Pokud chcete získat soubory symbolů pro soubory React Native pro iOS, vytvořte soubor ZIP s balíčkem dSYM na macu a na mapě zdroje JavaScriptu vaší aplikace. Zdrojová mapa by měla mít název index.ios.map. Následující příkazy vygenerují zdrojovou mapu pro sestavení finálních verzí.

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

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

  1. Aktivujte POST požadavek na rozhraní API symbol_uploads. Toto volání přidělí místo na našem serverovém systému pro váš soubor a vrátí symbol_upload_id vlastnost 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}'
  1. 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 úložiště na našem backendu. 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}'
  1. Vytvořte požadavek na API PATCH pomocí vrácené vlastnosti 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ávání symbolů nefunguje u souborů větších 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 --symbol {symbol file}

Bitcode

Společnost Apple zavedla bitcode, aby umožnila, že aplikace odesílané do App Store může samotná přepracovat a aplikovat nejnovější optimalizaci. Pokud je povolen Bitcode, symboly vygenerované pro vaši aplikaci v obchodě se budou lišit od symbolů z vašeho vlastního systému sestavení.

Hlášení pádů v App Center zatím nepodporuje kompletní symbolizaci pádů z aplikací s podporou bitového kódu. Mezitím vám doporučujeme zakázat bitcode. Zakázání bitcode výrazně zjednodušuje správu symbolů a v současné době nemá žádné známé nevýhody pro aplikace pro iOS.

Zakázání bitového kódu pro vaši aplikaci

  1. V Xcode otevřete nastavení projektu kliknutím na prvek nejvyšší úrovně v Navigátoru projektu.
  2. Přejděte na stránku Nastavení sestavení
  3. Vyhledejte bitcode.
  4. Ve výsledku změňte hodnotu z Ano na Ne.
  5. Opětovné sestavení aplikace

S těmito jednoduchými kroky se hlášení chyb v App Center bude chovat obvyklým způsobem.

Načtení symbolů pro aplikace, které mají povolený bitcode

Pokud chcete zachovat povolený bitový kód, můžete stáhnout správné soubory dSYM pomocí následujícího postupu:

  1. Otevřete organizátor Xcode
  2. Vyberte konkrétní archiv aplikace, kterou jste nahráli do iTunes Connect.
  3. Klikněte na tlačítko Stáhnout dSYMs. Tento krok vloží zkompilované soubory dSYM Bitcode do původního archivu.
  4. Nahrajte symboly do odpovídající aplikace a verze do služby App Center

Pokud organizátor Xcode neposkytuje žádné nové symboly, musíte stáhnout soubory dSYM z portálu iTunes Connect pomocí následujícího postupu:

  1. Výběr aplikace na portálu iTunes Connect
  2. Vyberte záložku Aktivita nahoře
  3. Vyberte verzi buildu aplikace, která obsahuje chybějící symboly.
  4. Klikněte na odkaz Stáhnout dSYM.
  5. Nahrajte stažený soubor do App Center. Tento soubor obsahuje symboly potřebné k tomu, aby App Center symbolizoval vaše chybové ukončení.

Řešení potíží se symboly

Pokud se po nahrání symbolů a zakázání bitového kódu stále zobrazují chyby, může to být proto, že nahrané soubory dSYM neodpovídají souborům požadovaným službou App Center. Když nahrajete soubory dSYM, App Center je přiřazuje ke správné verzi aplikace na základě jejich identifikátorů UUID.

Při použití nástroje CLI nazvaného dwarfdump můžete znovu zkontrolovat, jestli mají vaše soubory dSYM správné identifikátory UUID.

  1. Vyhledejte UUID v souboru dSYM:
dwarfdump --u CrashProbeiOS.app.dSYM
  1. Výsledek by měl vypadat přibližně takto:
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. Pečlivě zkontrolujte, jestli vrácený identifikátor UUID odpovídá identifikátorům UUID zobrazeným v dialogovém okně symbolů ladění:

App Center zobrazuje UUID požadovaných symbolů.

Ignorování symbolů

Pokud App Center neobsahuje všechny soubory symbolů potřebné ke kompletní symbolizaci hlášení o chybách, jsou chyby uvedeny na kartě Nesymbolizované. Požadované symboly mohou být nahrány 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 instruuje App Center, aby zpracovával pády a symbolikoval je s využitím dostupných symbolů. Jakmile zpracování dokončí, zobrazí se na záložce Pády částečně symbolizováno. Nové chyby, které také závisejí na stejných ID symbolů označených jako ignorované, vynechají kartu Unsymbolicated, jakmile projdou systémem.

  • Last updated on