Kdy a jak mám oznámit chybu?

  • Článek

Tip

Použijte položku nabídky Nahlásit problém v sadě Visual Studio – tím se posílají diagnostické informace spolu se zprávou o chybách, které vám pomůžou problém vyřešit.

Existují podrobné pokyny pro Visual Studio 2019 nebo Visual Studio 2017 a Visual Studio pro Mac.

Existující sestavy můžete vyhledat na webu komunity vývojářů sady Visual Studio.

Vytvořte chybu, pokud...

Máte sadu kroků, které si myslíte, že technici budou moci použít k reprodukci problému.

NEBO

Můžete pečlivě popsat viditelné příznaky problému, zejména pokud můžete také popsat některé přesné okolnosti související s problémem.[1]

Osvědčené postupy pro rychlé a efektivní řešení chyb

  1. V komunitě vývojářů sady Visual Studio a na webu vyhledejte existující sestavy chyb nebo návrhy využití, které by mohly problém vyřešit přímo.[2][3]

  2. Popište problém co nejjasněji a výstižněji, včetně popisu toho, co se stalo a co se očekávalo.

  3. Zahrňte všechny relevantní trasování zásobníku, text chybové zprávy nebo protokoly chybových ukončení (pokud použijete funkci Nahlásit problém , dají se zahrnout automaticky). [4]

  4. Poznamenejte si také všechny důležité chybové zprávy, které se zobrazují na snímcích obrazovky jako prostý text.

  5. Zahrňte malý samostatný testovací případ, který chybu reprodukuje s co nejmenším kódem. Pokud nemůžete reprodukovat problém s úplně novým projektem (vytvořeným pomocí některé z předdefinovaných šablon), zazipujte projekt, který tento problém demonstruje, a připojte ho ke zprávě o chybě. Před připojením vytvořte ukázkový projekt co nejjednodušším způsobem.[5][6]

  6. Popište prostředí, ve kterém došlo k chybě, včetně operačního systému a verzí Xamarinu a všech závislostí.

Další podrobnosti

  1. ^ V ideálním případě by měl popis "viditelných příznaků" obsahovat dostatek podrobností, aby ostatní zákazníci mohli ověřit, jestli se zobrazí stejný problém (stejné chybové zprávy, stejné snížení výkonu, stejné trasování zásobníku z chybového ukončení atd.). Pro "přesné okolnosti", jeden dobrý příklad by byl, kdybyste mohli říct něco jako: "Normálně jsem narazil na problém 75% času, ale pokud změním tuto věc, pak se mohu vyhnout problému úplně." Dalším podobným příkladem "přesných okolností" je, že downgradování na předchozí verzi Xamarinu problém zastaví.

  2. ^ Jak byste očekávali, fragmenty textu chyby (nebo jiného jedinečně popisného textu) jsou obvykle nejlepší hledané termíny. Pokud je existující zpráva o chybě neúplná, můžete přidat podrobnosti nebo vytvořit novou, lepší zprávu o chybách.

  3. ^ Další dobrou otázkou je, jestli byl stejný problém nahlášený pro jakékoli aplikace v Javě Objective-Cnebo Swiftu. Pokud ano, problém je velmi pravděpodobné, že je součástí Androidu nebo iOSu sám, a ne součástí Xamarinu.

  4. ^ Několik příkladů informací, které se mají zahrnout:

    1. V případě chyb, ke kterým dochází při sestavování projektu, uveďte úplný výstup sestavení diagnostiky do zprávy o chybě.

    2. V případě chyb, ke kterým dochází při sestavování nebo ladění projektu iOS ze sady Visual Studio, spusťte po dosažení chyby protokoly Xamarin > Zip nápovědy > a zahrňte výsledný soubor .zip do zprávy o chybě.

    3. V případě výjimek nebo chybových ukončení v aplikacích pro Android nebo iOS uveďte příslušné protokoly ladění pro aplikace Xamarin.Android a Xamarin.iOS.

  5. ^ Pokud je to možné u vašeho konkrétního problému, jednou z možností je znovu vytvořit problém přidáním malého počtu souborů z původního řešení do zcela nového řešení. Tým Xamarinu bude často schopen prozkoumat problémy i u větších testovacích případů (za předpokladu, že jsou kroky k reprodukci jasně vysvětleny), ale jednodušší testovací případy poskytují nejlepší šanci, že se chyba rychle vyřeší.

  6. ^ Pokud problém není možné reprodukovat přidáním malého počtu souborů do úplně nového řešení, můžete zazipovat a připojit celou složku řešení pro celou aplikaci. Odstraňte soubor binZIP , Componentsobja packages složky, aby byl menší. (Integrované vývojové prostředí a proces sestavení obvykle obnoví nebo znovu vytvoří obsah těchto složek podle potřeby.) Můžete také odstranit tolik souborů kódu a zdrojů z projektu, kolik chcete, pokud výsledné řešení stále ukazuje původní problém.