Přispívání do projektu World Locking Tools for Unity
Nejužitečnější způsob, jak v tuto chvíli přispět k projektu World Locking Tools, je vytvoření problémů. Jakákoli a veškerá zpětná vazba k lepšímu sladění projektu World Locking Tools for Unity s potřebami projektu je velmi cenná.
I když je jakákoli zpětná vazba, kterou publikujete, cenná, tady je několik tipů, jak lépe reagovat.
Vhodné použití popisků
Při počátečním odeslání problému a při sledování problému jako přispěvatele je velmi užitečné správné použití popisků při koordinaci s ostatními přispěvateli.
Snažte se přesně rozlišovat mezi tím, co je chyba, co je žádost o funkci a co je širší návrh. Všechny jsou cenné, ale jsou cennější, jakmile jsou identifikovány jako takové.
Podobně platí, že pokud se problém v jeho aktuální podobě zdá být nedostupný, může použití příslušného popisku (například "nejasné") pomoct vylepšit, aby se zlepšila tam, kde je možné reagovat. Konkrétní komentáře v samotném problému jsou samozřejmě velmi cenné. Správný popisek ale může vést ostatní k zobrazení komentáře, který by jinak nemusel být nepoznaný.
Hlášení chyby
Problémy se můžou odeslat z portálu problémů na GitHubu. Mějte čas na nahlášení problému nebo vytvořte návrh, ze kterého budou mít prospěch i ostatní.
Každá zpráva o chybách má svůj vlastní kontext, ale obecně platí, že čím více následujících, tím rychleji se problém vyřeší.
Soubory protokolu ze zařízení
Soubory protokolů ze zařízení můžou být velmi užitečné při zkoumání problémů, zejména ve spojení s snímky obrazovky navrhovanými níže. Mohou být získány pomocí portálu zařízení s Windows při připojení k vašemu zařízení, v části System > File explorer > User Folders \ LocalAppData \ WorldLockingTools
Soubor protokolu aplikace Unity
UnityPlayer.log se nachází v podsložce TempState. Jedná se o soubor ve formátu prostého textu.
Záznam diagnostiky nástroje World Locking Tools
Diagnostický soubor se nachází v podsložce LocalState . Název souboru se automaticky vygeneruje podle následujícího vzoru:
FrozenWorld-<device name>-<capture date and time>.hkfwJedná se o binární soubor, který potřebuje specializovaný software k prozkoumání.
Všimněte si, že k zachycení záznamu diagnostiky je potřeba povolit záznam diagnostiky na komponentě World Locking Tools Manager ve vaší scéně. Podrobnosti najdete v dokumentaci k diagnostice .
Kroky pro reprodukci
Určete, jak snadno k problému dochází. Ideální je mít chybu, která nastane 100 % času po určité sadě kroků. Ale i u chyby, kterou jste viděli, se stane jen jednou, tím podrobnější můžete spojit kroky vedoucí k problému, tím lépe.
Kroky pro reprodukci by měly postupovat podle následujícího obecného formuláře:
- Počínaje tímto normálním stabilním stavem...
- Pak jsem to udělal (nebo jsem si všiml této neobvyklé věci)...
- Systém pak začal zobrazovat toto nesprávné chování...
Snímky obrazovky
Snímky obrazovky vám pomůžou identifikovat celý kontext, ve kterém k problému došlo. Konkrétně vám diagnostika nástroje World Locking Tools zobrazená na obrazovce může pomoct s korelací vašich zkušeností s informacemi v protokolech. Snímky obrazovek můžou být snímky nebo snímky videa.
Informace o zařízení
- Jaký typ zařízení?
- Používáte verzi operačního systému?
Sestavení prostředí
- Verze Unity
- Verze sady Visual Studio
Návrh funkce
Když zjistíte, že nástroje World Locking Tools téměř dělá to, co potřebujete, je pravděpodobné, že někdo jiný trpí stejným omezením. Stejně jako nás zajímá oprava mezer v naší dokumentaci a příkladech jako při poskytování nových funkcí.
Při navrhování nové funkce je nejužitečnější zjistit, co se snažíte udělat. I když nápady na to, jak ji implementovat, mohou být užitečné, návrhy, které ujasní přidanou hodnotu, s větší pravděpodobností získat trakci. Zřetěžte problém, který funkce řeší, nejlépe s tím, co byste s ní mohli dosáhnout ve skutečném scénáři.
Nezapomeňte k odeslanému problému s návrhem připojit popisek "vylepšení".
Přispívání kódu
Jedná se o opensourcový projekt, takže samozřejmě každý může vytvořit fork pro vývoj kdykoli. Pokud je někdo dostatečně velkorysý na sdílení práce, pak je velmi ocení, ať se přeloží zpět do hlavního úložiště, nebo ne.
Během tohoto počátečního období zavedení budeme mít omezené prostředky ke kontrole a přijetí žádostí o přijetí změn do hlavního úložiště. Doporučuje se vyhnout investicím velkého času do forku za předpokladu, že se sloučí zpět do hlavního úložiště.
Jedním ze způsobů, jak riziko zmírnit, je odeslat problém, který navrhuje, co je určené (označované jako "vylepšení"), než do implementace investovat hodně času. To je také zvažovat u ostatních přispěvatelů, kteří se mohou dívat na stejnou oblast problému.