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

v této části se dozvíte, jak používat funkce integrace a produktivity Visual Studio Tools for Unity a jak používat Visual Studio ladicí program pro vývoj Unity.

Otevřete skripty Unity v Visual Studio

jakmile Visual Studio nastavíte jako externí editor pro unity, dvakrát klikněte na skript v editoru Unity, automaticky se spustí nebo přepne na Visual Studio a otevře vybraný skript.

případně můžete otevřít Visual Studio bez skriptu otevřeného v editoru zdrojového kódu, a to tak, že vyberete položku assets > otevřete v Unity nabídku Project C#.

Otevřít projekt C# v Visual Studio

otevřít projekt C# v Visual Studio pro Mac

Přístup k dokumentaci Unity

K rychlé dokumentaci ke skriptování Unity můžete přistupovat z Visual Studio. pokud Visual Studio Tools for Unity nenalezne dokumentaci k rozhraní API místně, pokusí se ji najít online.

  • v Visual Studio zvýrazněte nebo umístěte kurzor na rozhraní Unity API, se kterým chcete získat informace, a pak stiskněte kombinaci kláves ctrl + + + M, ctrl + H .
  • Místo vazby klíčů můžete použít také nabídku Reference k rozhraní API Unity > . Referenční nabídka rozhraní API Unity v Visual Studio
  • v Visual Studio pro Mac zvýrazněte nebo umístěte kurzor na rozhraní Unity API, se kterým chcete získat informace, a potom stiskněte klávesu Cmd + .
  • Místo vazby klíčů můžete použít také nabídku Reference k rozhraní API Unity > . referenční nabídka rozhraní API Unity v Visual Studio pro Mac

IntelliSense pro zprávy rozhraní API Unity

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

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

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

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

Použití IntelliSense v Visual Studio

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

    • Pomocí šipek nahoru a dolů .

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

    • Tím, že budete pokračovat zadáním názvu požadované položky.

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

    • Stisknutím klávesy TAB.

    • Stisknutím klávesy ENTER.

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

Vložení zprávy Unity z IntelliSense v Visual Studio

Průvodce skriptováním Unity MonoBehavior

Průvodce MonoBehavior můžete použít k zobrazení seznamu všech metod rozhraní API Unity a k rychlé implementaci prázdné definice. Tato funkce, zejména v případě, že je povolená možnost vygenerovat komentáře k metodám , je užitečná, pokud stále víte, co je k dispozici v rozhraní API Unity.

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 přidat metody, a pak stisknutím kombinace kláves Ctrl + Shift + M spusťte průvodce MonoBehavior. v Visual Studio pro Mac stiskněte kombinaci kláves Cmd + Shift + M.

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

  3. Pomocí rozevíracího seznamu verze rozhraní vyberte požadovanou verzi.

  4. Ve výchozím nastavení jsou metody vloženy do pozice kurzoru. Alternativně můžete zvolit, aby byly vloženy po libovolné metodě, která je již implementována ve vaší třídě, změnou hodnoty rozevíracího seznamu míst vložení do umístění, které chcete.

  5. Chcete-li, aby průvodce vygeneroval komentáře pro vybrané metody, označte zaškrtávací políčko generovat komentáře metody . Tyto komentáře jsou určeny k tomu, aby vám pomohly 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.

Dialog Průvodce MonoBehavior v Visual Studio.

dialog průvodce monobehavior v Visual Studio pro Mac.

průzkumník Project Unity

v průzkumníkovi Project se zobrazí všechny soubory projektu unity a adresáře stejným způsobem jako v editoru Unity. to je jiné než navigace ve skriptech Unity s normálním Visual Studio Průzkumník řešení, které je uspořádá do projektů a řešení vygenerovaného Visual Studio.

  • v hlavní nabídce Visual Studio vyberte zobrazit > průzkumníkovi Project. klávesová zkratka: Alt + Shift + +  zobrazit okno Project průzkumníku Unity.
  • v Visual Studio pro Mac se Oblast řešení automaticky chová jako při otevření projektu Unity.

Ladění Unity

Visual Studio Tools for Unity vám umožní ladit jak editor, tak herní skripty pro svůj projekt Unity pomocí výkonného ladicího programu Visual Studio.

Ladění v editoru Unity

Spustit ladění

  1. Připojení Visual Studio do unity kliknutím na tlačítko přehrát přidaných k unity nebo pomocí klávesové zkratky F5. Klikněte na tlačítko Přehrát v Visual Studio
  1. kliknutím na tlačítko přehrát Připojení Visual Studio na Unity nebo zadejte příkaz + Return nebo F5. klikněte na tlačítko přehrát v Visual Studio pro Mac
  1. Přepněte na Unity a kliknutím na tlačítko Přehrát spusťte hru v editoru.

Klikněte na tlačítko Přehrát v Unity v Windows

Kliknutí na tlačítko Přehrát v Unity v macOS

  1. když hra běží v editoru Unity, zatímco je připojená k Visual Studio, všechny zjištěné zarážky pozastaví provádění hry a zobrazí řádek kódu, kde hra narazí na zarážku v Visual Studio.

Zastavit ladění

klikněte na tlačítko zastavit v Visual Studio nebo použijte klávesovou zkratku Shift + F5. Klikněte na zastavit v Visual Studio

klikněte na tlačítko zastavit v Visual Studio pro Mac nebo stiskněte Shift + Command + Return. klikněte na zastavit v Visual Studio pro Mac

další informace o ladění v Visual Studio naleznete v tématu první pohled na Visual Studio ladicí program.

Připojit k Unity a hrát

Pro zvýšení pohodlí můžete změnit tlačítko připojit k Unity pro připojení k režimu Unity a Play .

  1. Klikněte na šipku dolů vedle tlačítka připojit k Unity .
  2. V rozevírací nabídce vyberte připojit k Unity a stiskněte tlačítko Přehrát. Připojit a přehrát v Visual Studio

Tlačítko Přehrát je označeno jako připojit k Unity a hrát. kliknutím na toto tlačítko nebo pomocí klávesové zkratky F5 nyní automaticky přepnete do editoru Unity a spustíte hru v editoru, a navíc připojíte Visual Studio ladicí program.

spuštění ladění a přehrání editoru Unity můžete provést v jednom kroku přímo z Visual Studio pro Mac výběrem možnosti připojit k Unity a přehrání .

vyberte možnost připojit k Unity a přehrát v Visual Studio pro Mac

Poznámka

Pokud jste zahájili ladění pomocí konfigurace připojit k Unity a Play , tlačítko zastavit také zastaví Editor Unity.

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

Můžete ladit vývojové buildy přehrávačů Unity pomocí Visual Studio.

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

  1. v Unity otevřete Nastavení sestavení tak, že vyberete soubor > sestavení Nastavení.

  2. v okně sestavit Nastavení označte zaškrtávací políčka vývojové sestavení a ladění skriptu .

    ![Nakonfigurujte nastavení sestavení Unity pro ladění.](../media/vs/vstu-debugging-build-settings.png "vstu_debugging_build_settings")

Vyberte instanci Unity pro připojení ladicího programu k

  • v Visual Studio v hlavní nabídce vyberte ladit > připojit ladicí program Unity.

    Připojte ladicí program Unity.

    V dialogovém okně Vybrat instanci Unity se zobrazí některé informace o jednotlivých instancích Unity, ke kterým se můžete připojit.

    Vyberte instanci Unity, ke které se chcete připojit.

    Projekt

    Název projektu Unity, který je spuštěný v této instanci Unity.

    Počítač Název počítače nebo zařízení, ve kterém je tato instance Unity spuštěná.

    Editor typů, pokud je tato instance Unity spuštěná jako součást editoru Unity; Přehrávač , pokud je tato instance Unity samostatným přehrávačem.

    Port Číslo portu soketu UDP, přes který tato instance Unity komunikuje.

Důležité

vzhledem k tomu, že Visual Studio Tools for Unity a instance Unity komunikují přes síťový soket UDP, může brána firewall vyžadovat pravidlo k jeho povolení. V případě potřeby se může zobrazit výzva k ověření připojení, aby VSTU a Unity mohl komunikovat.

  • v Visual Studio pro Mac v horní nabídce vyberte možnost spustit > připojit k procesu.
  • V dialogovém okně připojit k procesu vyberte v rozevírací nabídce ladicího programu možnost ladicí program Unity .
  • V seznamu vyberte instanci Unity a klikněte na tlačítko připojit .

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.

Poznámka

v tuto chvíli Visual Studio Tools for Unity podporuje jenom spravované knihovny dll. Nepodporuje ladění knihoven DLL nativního kódu, jako jsou například ty, které byly napsány v jazyce C++.

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.

    Přidejte svůj existující projekt knihovny DLL do řešení.

    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.

Poznámka

Toto je nutné jenom v případě, že používáte starší verzi modulu runtime Unity. Pokud používáte nový modul runtime Unity, nemusíte už tyto vyhrazené profily 3,5 používat. Použijte profil .NET 4. x kompatibilní s vaší verzí Unity.

Nastavte cílové rozhraní knihovny DLL na architekturu Unity.

  1. 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ý.

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

Příkaz Zástupce Název příkazu zástupce
Otevřít Průvodce MonoBehavior CTRL + Posun + M EditorContextMenus. CodeWindow. ImplementMonoBehaviours
otevření průzkumníka Project Unity ALT + Posun + E Zobrazit. UnityProjectExplorer
Přístup k dokumentaci Unity CTRL + ALT + M, CTRL + H Help. UnityAPIReference
Připojení k ladicímu programu Unity (přehrávač nebo Editor) žádná výchozí Debug. AttachUnityDebugger

Pokud nechcete používat výchozí hodnoty, můžete změnit kombinace klávesových zkratek. Informace o tom, jak ho změnit, najdete v tématu určení a přizpůsobení klávesových zkratek v Visual Studio.

Příkaz Zástupce Název příkazu zástupce
Otevřít Průvodce MonoBehavior Příkaz cmd + Posun + M EditorContextMenus. CodeWindow. ImplementMonoBehaviours
Přístup k dokumentaci Unity Cmd + ' Help. UnityAPIReference

Pokud nechcete používat výchozí hodnoty, můžete změnit kombinace klávesových zkratek. Informace o tom, jak ho změnit, najdete v tématu Přizpůsobení integrovaného vývojového prostředí (IDE).