Kdy a jak mám oznámit chybu?

Tip

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

K dispozici jsou podrobné pokyny pro Visual Studio 2019 nebo Visual Studio 2017a Visual Studio pro Mac.

Existující sestavy můžete vyhledat na Visual Studio Developer Community webu.

Zakašte chybu, pokud...

Máte sadu kroků, které by podle vás technici mohli použít k reprodukování problému.

NEBO

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

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

  1. Vyhledejte Visual Studio Developer Community a na webu existující zprávy o chybách nebo návrhy využití, které by mohly problém vyřešit přímo. [2][3]

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

  3. Zahrnout příslušná trasování zásobníku, text chybové zprávy nebo protokoly chyb (pokud použijete funkci Nahlásit problém, můžete je zahrnout automaticky). [4]

  4. Zapište si všechny důležité chybové zprávy, které se zobrazují také v přílohách snímku obrazovky jako prostý text.

  5. Zahrnovat malý samostatný testovací případ, který reprodukuje chybu s co nejmenším možným kódem. Pokud problém nemůžete reprodukovat u zcela nového projektu (vytvořeného pomocí jedné z předdefinované šablony), zazipujte projekt, který demonstruje problém, a připojte ho ke zprávě o chybě. Než ho připojíte, udělejte z příkladu projekt co nejjednodušší. [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 dochází ke stejnému problému (stejné chybové zprávy, stejné snížení výkonu, stejné trasování zásobníku při selhání atd.). V případě "přesných okolností" by jedním z dobrých příkladů bylo, kdybyste mohli říct něco jako: "Normálně se problému 75 % času dotáhnem, ale když tohle změním, můžu se problému úplně vyhnout." Dalším podobným příkladem "přesných okolností" je situace, kdy se problém zastaví downgradem na předchozí verzi Xamarinu.

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

  3. ^ Další dobrou otázkou je, jestli se stejný problém nahlásil u aplikací v Javě nebo Objective-CNebo Swiftu. Pokud ano, problém je pravděpodobně součástí samotného Androidu nebo iOSu, a ne součástí Xamarinu.

  4. ^ Několik příkladů informací, mezi které patří:

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

    2. V případě chyb, ke kterým dochází při sestavování nebo ladění projektu pro iOS z Visual Studio, > spusťte po zobrazení chyby help Xamarin ZIP Logs (Nápověda k protokolům ZIP) Xamarinu > a do zprávy o chybě .zip výsledný soubor .zip souboru.

    3. V případě výjimek nebo chyb 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 pro váš konkrétní problém možné, jednou z možností je problém znovu vytvořit přidáním malého počtu souborů z původního řešení do zcela nového řešení. Xamarinový tým bude často schopný zkoumat 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 dávají 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 zcela nového řešení, můžete zazipovat a připojit celou složku řešení pro celou aplikaci. Odstraňte složky bin, objComponents, packages a , aby byl soubor zip menší. (Integrované vývojové prostředí (IDE) a proces sestavení obvykle obnoví nebo znovu vytvoří obsah těchto složek podle potřeby.) Můžete také z projektu odstranit tolik souborů kódu a prostředků, kolik chcete, pokud výsledné řešení stále ukazuje původní problém.