Používání Visual Studio Tools for Unity

V této části se dozvíte, jak používat Visual Studio Tools for Unity a produktivitu a jak používat ladicí program pro Visual Studio Unity.

Otevřete skripty Unity v Visual Studio

Jakmile Visual Studio jako externí editor Unity,poklikáním na skript v editoru Unity se automaticky spustí nebo přepne na Visual Studio a vybraný skript se otevře.

Alternativně můžete otevřít Visual Studio bez otevřeného skriptu ve zdrojovém editoru tak, že v Unity vyberete > nabídky Project C#.

Přístup k dokumentaci k Unity

Dokumentaci ke skriptování Unity můžete rychle získat z Visual Studio. Pokud Visual Studio Tools for Unity rozhraní API nenajde místně, pokusí se ji najít online.

IntelliSense pro zprávy rozhraní API Unity

Dokončování kódu v IntelliSense usnadňuje implementaci zpráv rozhraní Unity API ve skriptech MonoBehaviour a pomáhá se seznamovat s rozhraním Unity API. Použití Technologie IntelliSense pro zprávy Unity:

1. Umístěte kurzor na nový řádek uvnitř těla třídy, která je odvozena z MonoBehaviour .

2. Začněte psát název zprávy Unity, například OnTriggerEnter .

3. Po zadání písmen "ontri" se zobrazí seznam návrhů IntelliSense.

4. Výběr v seznamu lze změnit třemi způsoby:

   • Pomocí kláves se šipkami nahoru a dolů.

   • Kliknutím myší na požadovanou položku.

   • Pokračujeme v psaní názvu požadované položky.

5. IntelliSense může vložit vybranou zprávu Unity, včetně všech nezbytných parametrů:

   • Stisknutím tabulátoru.

   • Stisknutím klávesy Enter

   • Dvojím kliknutím na vybranou položku.

Průvodce skriptování Unity MonoBehavior

Pomocí průvodce MonoBehavior můžete zobrazit seznam všech metod rozhraní API Unity a rychle implementovat prázdnou definici. Tato funkce, zejména s povolenou možností Generovat komentáře k metodě, je užitečná, pokud se stále učíte, co je k dispozici v rozhraní Unity API.

Vytvoření prázdných definic metod MonoBehavior pomocí průvodce MonoBehavior:

1. V Visual Studio umístěte kurzor na místo, kam chcete metody vložit, a potom stisknutím kláves Ctrl + Shift + M spusťte průvodce MonoBehavior. V Visual Studio pro Mac stiskněte Klávesu Cmd + Shift + M.

2. V okně Vytvořit metody skriptu zaškrtněte políčko vedle názvu každé metody, kterou chcete přidat.

3. K výběru požadované verze použijte rozevírací seznam Verze architektury.

4. Ve výchozím nastavení jsou metody vloženy na pozici kurzoru. Alternativně můžete zvolit jejich vložení za libovolnou metodu, která je již implementována ve vaší třídě, a to změnou hodnoty rozevíracího seznamu Kurzor na umístění, které chcete.

5. Pokud chcete, aby průvodce vygeneroval komentáře pro metody, které jste vybrali, zaškrtněte políčko Generovat komentáře metody. Tyto komentáře vám mají pomoct pochopit, kdy je metoda volána a jaké jsou její obecné zodpovědnosti.

6. Kliknutím na tlačítko OK ukončete průvodce a vložte metody do kódu.

Unity Project Explorer

Unity Project Explorer zobrazuje všechny soubory a adresáře projektu Unity stejným způsobem jako Editor Unity. To se liší od procházení skriptů Unity pomocí normálního Visual Studio Průzkumník řešení, který je uspořádá do projektů a řešení vygenerovaných Visual Studio.

Ladění Unity

Visual Studio Tools for Unity umožňuje ladit editorové i herní skripty pro projekt Unity pomocí výkonného Visual Studio ladicího programu.

Ladění v editoru Unity

Spuštění ladění

2. Přepněte na Unity a kliknutím na tlačítko Play (Přehrát) spusťte hru v editoru.

3. Když hra běží v editoru Unity a je připojená k Visual Studio, všechny zarážek pozastaví spuštění hry a zobrazí řádek kódu, ve kterém hra narazí na zarážku v Visual Studio.

Zastavení ladění

Další informace o ladění v Visual Studio najdete v tématu První pohled na Visual Studio Debugger.

Připojení k Unity a přehrávání

Pro usnadnění můžete změnit tlačítko Attach to Unity (Připojit k Unity) na Attach to Unity and Play mode (Připojit k Unity a režim přehrávání).

<a name="debug-unity-player-builds">Ladění sestavení přehrávače Unity

Můžete ladit vývojová sestavení hráčů Unity pomocí Visual Studio.

Povolení ladění skriptů v přehrávači Unity

1. V Unity otevřete soubor Build Nastavení výběrem možnosti File > Build Nastavení.

2. V okně Nastavení sestavení zaškrtněte políčka Vývojový build a ladění skriptů.

   

Výběr instance Unity pro připojení ladicího programu k

Ladění knihovny DLL v projektu Unity

Mnoho vývojářů Unity napisuje komponenty kódu jako externí knihovny DLL, aby bylo možné funkce, které vyvíjejí, snadno sdílet s ostatními projekty. Visual Studio Tools for Unity usnadňuje ladění kódu v těchto knihovnách dll plynule s jiným kódem v projektu Unity.

Všimněte si, že zde popsaný scénář předpokládá, že máte zdrojový kód – to znamená, že vyvíjíte nebo znovu používáte vlastní kód první strany, nebo máte zdrojový kód do knihovny třetích stran a naplánujete ho nasadit do projektu Unity jako knihovnu DLL. Tento scénář nepopisuje ladění knihovny DLL, pro kterou nemáte zdrojový kód.

Ladění projektu spravované knihovny DLL použitého v projektu Unity

1. přidejte svůj existující projekt knihovny DLL do řešení Visual Studio vygenerovaného pomocí Visual Studio Tools for Unity. Méně často, možná spouštíte nový projekt spravovaných knihoven DLL, který bude obsahovat komponenty kódu v projektu Unity; pokud je to tento případ, můžete místo toho přidat nový projekt spravovaných knihoven DLL do řešení Visual Studio.

   

   v obou případech Visual Studio Tools for Unity udržuje odkaz na projekt, a to i v případě, že má znovu vygenerovat projekt a soubory řešení, takže je třeba provést tyto kroky pouze jednou.

2. Odkaz na správný profil rozhraní Unity v projektu knihovny DLL. v Visual Studio ve vlastnostech projektu knihovny DLL nastavte vlastnost cílová architektura na verzi architektury Unity, kterou používáte. Jedná se o knihovnu tříd Unity Base, která odpovídá kompatibilitě rozhraní API, na kterou váš projekt cílí, jako je například třída Full, Micro nebo webová knihovna základních tříd. To brání vaší knihovně DLL v volání metod rozhraní, které existují v jiných rozhraních nebo úrovních kompatibility, ale které nemusí existovat v verzi rozhraní Unity, kterou používáte.

3. Zkopírujte knihovnu DLL do složky assetů vašeho projektu Unity. V Unity jsou prostředky soubory, které jsou zabaleny a nasazeny společně s vaší aplikací Unity, aby je bylo možné načíst za běhu. Vzhledem k tomu, že knihovny DLL jsou propojeny v době běhu, knihovny DLL musí být nasazeny jako prostředky. Aby bylo možné nasadit jako prostředek, Editor Unity vyžaduje, aby byly knihovny DLL vloženy do složky assets v projektu Unity. Můžete to provést dvěma způsoby:

   • Upravte nastavení sestavení projektu knihovny DLL tak, aby zahrnovalo sestavený úkol, který kopíruje výstupní knihovnu DLL a soubory PDB z výstupní složky do složky assety vašeho projektu Unity.

   • Upravte nastavení sestavení projektu knihovny DLL tak, aby výstupní složka byla nastavena na složku assets vašeho projektu Unity. Soubory DLL a PDB budou umístěny do složky assets (prostředky ).

   Soubory PDB jsou nutné pro ladění, protože obsahují symboly ladění knihovny DLL a mapují kód knihovny DLL na formulář zdrojového kódu. pokud cílíte na starší verzi modulu runtime, Visual Studio Tools for Unity použije informace z knihovny dll a PDB k vytvoření souboru DLL. MDB, což je formát symbolu ladění používaný starším skriptovacím modulem Unity. pokud cílíte na nový modul runtime a použijete přenositelného PDB, Visual Studio Tools for Unity se nebude pokoušet provést žádný převod symbolů, protože nový modul runtime Unity dokáže nativně spotřebovávat přenosné-soubory pdb.

   Další informace o generování PDB najdete tady. Pokud cílíte na nový modul runtime, ujistěte se, že je "ladicí informace" nastavené na "přenosné", aby bylo možné správně vygenerovat přenosné soubor PDB. Pokud cílíte na starší verzi modulu runtime, je nutné použít úplný.

4. Ladění kódu. Nyní můžete ladit zdrojový kód vaší knihovny DLL společně se zdrojovým kódem vašeho projektu Unity a použít všechny funkce ladění, které jste použili pro, například zarážky a krokování prostřednictvím kódu.

Klávesové zkratky

pomocí klávesových zkratek můžete rychle získat přístup k nástrojům Unity pro Visual Studio funkce. Tady je souhrn zástupců, které jsou k dispozici.