Korzystanie z narzędzi Visual Studio Tools for Unity

W tej sekcji dowiesz się, jak używać funkcji integracji i produktywności firmy Visual Studio Tools for Unity oraz jak używać debugera Visual Studio do budowania aplikacji Unity.

Otwieranie skryptów aparatu Unity w programie Visual Studio

Po Visual Studio jako zewnętrznego edytora dla aparatu Unitydwukrotne kliknięcie skryptu w edytorze aparatu Unity spowoduje automatyczne uruchomienie lub przełączenie się Visual Studio i otwarcie wybranego skryptu.

Alternatywnie możesz otworzyć plik Visual Studio bez otwierania skryptu w edytorze źródłowym, wybierając menu > Otwórz plik C# Project a aparatu Unity.

Otwieranie projektu C# w programie Visual Studio

Otwieranie projektu C# w programie Visual Studio dla komputerów Mac

Dostęp do dokumentacji aparatu Unity

Możesz szybko uzyskać dostęp do dokumentacji skryptów aparatu Unity z Visual Studio. Jeśli Visual Studio Tools for Unity nie znajdzie dokumentacji interfejsu API lokalnie, spróbuje znaleźć ją w trybie online.

  • W Visual Studio wyróżnij lub umieść kursor na interfejsie API aparatu Unity, którego chcesz się dowiedzieć, a następnie naciśnij klawisze Ctrl + Alt + M, Ctrl + H
  • Możesz również użyć menu Help > Unity API Reference (Dokumentacja interfejsu API aparatu Unity) zamiast po stronie klawiszy. Menu dokumentacja interfejsu API aparatu Unity w Visual Studio
  • W Visual Studio dla komputerów Mac wyróżnij lub umieść kursor na interfejsie API aparatu Unity, którego chcesz się dowiedzieć, a następnie naciśnij klawisz Cmd + '
  • Możesz również użyć menu Help > Unity API Reference (Dokumentacja interfejsu API aparatu Unity) zamiast po stronie klawiszy. Menu dokumentacja interfejsu API aparatu Unity w Visual Studio dla komputerów Mac

Funkcja IntelliSense dla komunikatów interfejsu API aparatu Unity

Uzupełnianie kodu intellisense ułatwia implementowanie komunikatów interfejsu API aparatu Unity w skryptach MonoBehaviour oraz ułatwia uczenie się interfejsu API aparatu Unity. Aby użyć funkcji IntelliSense dla komunikatów Unity:

  1. Umieść kursor w nowym wierszu wewnątrz treści klasy pochodzącej od MonoBehaviour klasy .

  2. Zacznij wpisywać nazwę komunikatu aparatu Unity, na przykład OnTriggerEnter .

  3. Po wpisaniu liter "ontri" zostanie wyświetlona lista sugestii funkcji IntelliSense.

Korzystanie z funkcji IntelliSense w programie Visual Studio

  1. Wybór na liście można zmienić na trzy sposoby:

    • Za pomocą klawiszy strzałek w górę i w dół.

    • Klikając wskaźnik myszy na żądanym elementie.

    • Kontynuując wpisywanie nazwy żądanego elementu.

  2. Funkcja IntelliSense może wstawić wybrany komunikat aparatu Unity, w tym wszelkie niezbędne parametry:

    • Naciskając klawisz Tab.

    • Naciskając klawisz Enter.

    • Klikając dwukrotnie wybrany element.

Wstawianie komunikatu aparatu Unity z funkcji IntelliSense w Visual Studio

Kreator skryptów MonoBehavior aparatu Unity

Za pomocą kreatora MonoBehavior można wyświetlić listę wszystkich metod interfejsu API aparatu Unity i szybko zaimplementować pustą definicję. Ta funkcja, szczególnie z włączoną opcją Generuj komentarze metody, jest przydatna, jeśli nadal uczysz się, co jest dostępne w interfejsie API aparatu Unity.

Aby utworzyć puste definicje metod MonoBehavior za pomocą kreatora MonoBehavior:

  1. W Visual Studio umieść kursor w miejscu, w którym mają zostać wstawione metody, a następnie naciśnij klawisze Ctrl Shift M, aby uruchomić + + kreatora MonoBehavior. W Visual Studio dla komputerów Mac naciśnij klawisz Cmd + Shift + M.

  2. W oknie Tworzenie metod skryptu zaznacz pole wyboru obok nazwy każdej metody, którą chcesz dodać.

  3. Użyj listy rozwijanej Wersja struktury, aby wybrać odpowiednią wersję.

  4. Domyślnie metody są wstawiane w miejscu kursora. Alternatywnie można wstawić je po dowolnej metodzie, która jest już zaimplementowana w klasie, zmieniając wartość listy rozwijanej Punkt wstawiania na inną lokalizację.

  5. Jeśli chcesz, aby kreator generował komentarze dla wybranych metod, zaznacz pole wyboru Generuj komentarze metody. Te komentarze mają ułatwić zrozumienie, kiedy jest wywoływana metoda i jakie są jej ogólne obowiązki.

  6. Wybierz przycisk OK, aby zamknąć kreatora i wstawić metody do kodu.

Okno dialogowe kreatora monobehavior w Visual Studio.

Okno dialogowe kreatora monobehavior w Visual Studio dla komputerów Mac.

Eksplorator Project Unity

Eksplorator Project Unity pokazuje wszystkie pliki i katalogi projektu aparatu Unity w taki sam sposób, jak edytor aparatu Unity. Różni się to od nawigowania po skryptach aparatu Unity przy użyciu normalnego Visual Studio Eksplorator rozwiązań, który organizuje je w projekty i rozwiązanie generowane przez Visual Studio.

  • W głównym menu Visual Studio wybierz pozycję View (Wyświetl) > Unity Project Explorer. Skrót klawiaturowy: Alt + Shift + E  View the Unity Project Explorer (Widok eksploratora aplikacji Project Unity).
  • W Visual Studio dla komputerów Mac projekt okienko rozwiązania automatycznie zachowuje się tak po otwarciu projektu aparatu Unity.

Debugowanie aparatu Unity

Visual Studio Tools for Unity umożliwia debugowanie skryptów edytora i gier dla projektu aparatu Unity przy Visual Studio zaawansowanego debugera aparatu Visual Studio.

Debugowanie w edytorze aparatu Unity

Rozpocznij debugowanie

  1. Połączenie Visual Studio do aparatu Unity, klikając przycisk Odtwarzania z etykietą Dołącz do aparatu Unity lub użyj skrótu klawiaturowego F5. Kliknij przycisk Odtąd w Visual Studio
  1. Połączenie Visual Studio do aparatu Unity, klikając przycisk Odtąd lub wpisz Polecenie + return lub F5. Kliknij przycisk Odtąd w Visual Studio dla komputerów Mac
  1. Przejdź do aparatu Unity i kliknij przycisk Play (Odt play), aby uruchomić grę w edytorze.

Kliknij pozycję Play in Unity on Windows (Odtąd w a aparatu Unity na platformie Windows

Klikanie przycisku Play in Unity on macOS (Odtąd w a unity w systemie macOS)

  1. Gdy gra jest uruchomiona w edytorze aparatu Unity, gdy jest połączona z platformą Visual Studio, wszelkie napotkane punkty przerwania wstrzymają wykonywanie gry i wyzszą wiersz kodu, w którym gra trafi punkt przerwania w Visual Studio.

Zatrzymywanie debugowania

Kliknij przycisk Zatrzymaj w Visual Studio lub użyj skrótu klawiaturowego Shift + F5. Kliknij przycisk Zatrzymaj w Visual Studio

Kliknij przycisk Zatrzymaj w Visual Studio dla komputerów Mac lub naciśnij klawisze Shift + Command + Return. Kliknij przycisk Zatrzymaj w Visual Studio dla komputerów Mac

Aby dowiedzieć się więcej na temat debugowania w programie Visual Studio, zobacz Pierwsze spojrzenie na Visual Studio debugera.

Dołączanie do aparatu Unity i odtwarzanie

Aby uzyskać dodatkową wygodę, możesz zmienić przycisk Attach to Unity (Dołącz do aparatu Unity) na Attach to Unity and Play mode (Dołączanie do aparatu Unity i tryb odtwarzania).

  1. Kliknij małą strzałkę w dół obok przycisku Attach to Unity (Dołącz do aparatu Unity).
  2. Wybierz pozycję Attach to Unity and Play (Dołącz do aparatu Unity i odtąd ) z menu rozwijanego. Dołączanie i odtwarzanie w Visual Studio

Przycisk odtwarzania staje się oznaczony etykietą Attach to Unity and Play (Dołącz do aparatu Unity i odt odtwarzania). Kliknięcie tego przycisku lub użycie skrótu klawiaturowego F5 powoduje teraz automatyczne przełączenie do edytora aparatu Unity i uruchomienie gry w edytorze, oprócz dołączenia Visual Studio debugera.

Uruchamianie debugowania i odtwarzanie edytora aparatu Unity można zakończyć w jednym kroku bezpośrednio z Visual Studio dla komputerów Mac, wybierając konfigurację Dołącz do aparatu Unity i Odtwarzania.

Wybierz pozycję Attach to Unity and Play in Visual Studio dla komputerów Mac (Dołącz do aparatu Unity i odtów w Visual Studio dla komputerów Mac

Uwaga

Jeśli rozpoczęto debugowanie przy użyciu konfiguracji Dołącz do aparatu Unity i odtwarzania, przycisk Zatrzymaj spowoduje również zatrzymanie edytora aparatu Unity.

<a name="debug-unity-player-builds">Debugowanie kompilacji odtwarzacza Unity

Kompilacje programowe odtwarzaczy Unity można debugować za pomocą Visual Studio.

Włączanie debugowania skryptu w odtwarzaczu aparatu Unity

  1. W a aparatu Unity otwórz okno Ustawienia, wybierając pozycję Plik > kompilacji Ustawienia.

  2. W oknie Ustawienia zaznacz pola wyboru Kompilacja programistyka i Debugowanie skryptów.

    ![Skonfiguruj ustawienia kompilacji aparatu Unity na potrzeby debugowania.](../media/vs/vstu-debugging-build-settings.png "vstu_debugging_build_settings")

Wybierz wystąpienie aparatu Unity, do których chcesz dołączyć debuger

  • W Visual Studio menu głównym wybierz pozycję Debuguj i > debugera aparatu Unity.

    Dołącz debuger aparatu Unity.

    W oknie dialogowym Select Unity Instance (Wybieranie wystąpienia aparatu Unity) są wyświetlane pewne informacje o każdym wystąpieniu aparatu Unity, z którym można nawiązać połączenie.

    Wybierz wystąpienie aparatu Unity, z które chcesz nawiązać połączenie.

    Project

    Nazwa projektu aparatu Unity, który jest uruchomiony w tym wystąpieniu aparatu Unity.

    Maszyna Nazwa komputera lub urządzenia, na których jest uruchomione to wystąpienie aparatu Unity.

    Typ Editor, jeśli to wystąpienie aparatu Unity jest uruchomione jako część edytora aparatu Unity; Player ( Odtwarzacz), jeśli to wystąpienie aparatu Unity jest odtwarzaczem autonomicznym.

    Port Numer portu gniazda UDP, za pośrednictwem których komunikuje się to wystąpienie aparatu Unity.

Ważne

Ponieważ Visual Studio Tools for Unity i wystąpienie aparatu Unity komunikują się za pośrednictwem gniazda sieciowego UDP, zapora może wymagać reguły zezwalania na to. W razie potrzeby może zostać wyświetlony monit, musisz autoryzować połączenie, aby program VSTU i unity mogą się komunikować.

  • W Visual Studio dla komputerów Mac górnym menu wybierz pozycję Uruchom, > dołącz do procesu.
  • W oknie dialogowym Dołączanie do procesu wybierz opcję Debuger aparatu Unity z menu rozwijanego debugera u dołu.
  • Wybierz z listy wystąpienie aparatu Unity i kliknij przycisk Attach (Dołącz).

Debugowanie biblioteki DLL w projekcie aparatu Unity

Wielu deweloperów aparatu Unity pisze składniki kodu jako zewnętrzne biblioteki DLL, aby tworzyć funkcje, które mogą łatwo udostępniać innym projektom. Visual Studio Tools for Unity ułatwia debugowanie kodu w tych plikach DLL z innym kodem w projekcie aparatu Unity.

Uwaga

Obecnie program Visual Studio Tools for Unity tylko zarządzane biblioteki DLL. Nie obsługuje debugowania bibliotek DLL kodu natywnego, takich jak biblioteki napisane w języku C++.

Należy pamiętać, że w scenariuszu opisanym w tym miejscu przyjęto założenie, że masz kod źródłowy — oznacza to, że opracowujesz lub ponownie używasz własnego kodu albo masz kod źródłowy do biblioteki innej firmy i planujesz wdrożyć go w projekcie aparatu Unity jako bibliotekę DLL. W tym scenariuszu nie opisano debugowania biblioteki DLL, dla której nie ma kodu źródłowego.

Aby debugować projekt zarządzanej biblioteki DLL używany w projekcie aparatu Unity

  1. Dodaj istniejący projekt DLL do rozwiązania Visual Studio wygenerowanego przez Visual Studio Tools for Unity. Rzadziej można uruchamiać nowy projekt zarządzanej biblioteki DLL, aby zawierał składniki kodu w projekcie aparatu Unity. W takim przypadku możesz zamiast tego dodać nowy projekt zarządzanej biblioteki DLL do Visual Studio projektu.

    Dodaj istniejący projekt DLL do rozwiązania.

    W obu przypadkach Visual Studio Tools for Unity odwołanie do projektu, nawet jeśli konieczne jest ponowne ponowne wygenerowanie plików projektu i rozwiązania, więc wystarczy wykonać te kroki tylko raz.

  2. Odwołaj się do poprawnego profilu struktury Aparatu Unity w projekcie DLL. W Visual Studio właściwości projektu DLL ustaw właściwość Target framework na używaną wersję struktury aparatu Unity. Jest to biblioteka klas bazowych aparatu Unity, która odpowiada zgodności interfejsów API przeznaczonych dla projektu, takich jak pełne, mikro lub internetowe biblioteki klas bazowych aparatu Unity. Uniemożliwia to bibliotece DLL wywoływanie metod struktury, które istnieją w innych platformach lub na poziomach zgodności, ale które mogą nie istnieć w wersji struktury aparatu Unity, której używasz.

Uwaga

Poniższe elementy są wymagane tylko w przypadku korzystania ze starszego środowiska uruchomieniowego aparatu Unity. Jeśli używasz nowego środowiska uruchomieniowego aparatu Unity, nie musisz już używać tych dedykowanych profilów 3.5. Użyj profilu .NET 4.x zgodnego z wersją aparatu Unity.

Ustaw platformę docelową biblioteki DLL na platformę Unity.

  1. Skopiuj bibliotekę DLL do folderu Asset projektu aparatu Unity. W a aparatu Unity zasoby to pliki, które są spakowane i wdrażane razem z aplikacją aparatu Unity, aby można je było ładować w czasie rzeczywistym. Ponieważ biblioteki DLL są połączone w czasie uruchamiania, biblioteki DLL muszą być wdrażane jako zasoby. Aby można było wdrożyć go jako element zawartości, edytor aparatu Unity wymaga, aby biblioteki DLL zostały wprowadzone w folderze Assets w projekcie aparatu Unity. Istnieją dwa sposoby, aby to zrobić:

    • Zmodyfikuj ustawienia kompilacji projektu DLL, aby uwzględnić zadanie po kompilacji, które kopiuje wyjściowe pliki DLL i PDB z folderu wyjściowego do folderu Assets projektu aparatu Unity.

    • Zmodyfikuj ustawienia kompilacji projektu DLL, aby ustawić jego folder wyjściowy jako folder Assets projektu aparatu Unity. Zarówno pliki DLL, jak i PDB zostaną umieszczone w folderze Assets.

    Pliki PDB są potrzebne do debugowania, ponieważ zawierają symbole debugowania biblioteki DLL i mapują kod biblioteki DLL na formularz kodu źródłowego. Jeśli używasz starszego środowiska uruchomieniowego, program Visual Studio Tools for Unity użyje informacji z bibliotek DLL i PDB do utworzenia pliku DLL.MDB, który jest formatem symboli debugowania używanym przez starszy aparat skryptów aparatu Unity. Jeśli używasz nowego środowiska uruchomieniowego jako docelowego i używasz pliku Portable-PDB, program Visual Studio Tools for Unity nie będzie próbował wykonać żadnej konwersji symboli, ponieważ nowe środowisko uruchomieniowe aparatu Unity może natywnie korzystać z plików Portable-PDB.

    Więcej informacji na temat generowania plików PDB można znaleźć tutaj. Jeśli używasz nowego środowiska uruchomieniowego jako docelowego, upewnij się, że opcja "Informacje o debugowaniu" jest ustawiona na wartość "Portable", aby prawidłowo wygenerować plik Portable-PDB. Jeśli używasz starszego środowiska uruchomieniowego jako docelowego, musisz użyć opcji "Pełne".

  2. Debugowanie kodu. Teraz można debugować kod źródłowy biblioteki DLL wraz z kodem źródłowym projektu aparatu Unity i korzystać ze wszystkich funkcji debugowania, które są używane, takich jak punkty przerwania i przechodzenie przez kod.

Skróty klawiaturowe

Możesz szybko uzyskać dostęp do narzędzi Unity Tools for Visual Studio, używając ich skrótów klawiaturowych. Oto podsumowanie dostępnych skrótów.

Polecenie Skrót Nazwa polecenia skrótu
Otwieranie kreatora MonoBehavior Ctrl + Shift (Przesunięcie) + M EditorContextMenus.CodeWindow.ImplementMonoBehaviours
Otwieranie eksploratora Project Unity Alt (Alt) + Shift (Przesunięcie) + E View.UnityProjectExplorer
Uzyskiwanie dostępu do dokumentacji aparatu Unity Ctrl + Alt (Alt) + M, Ctrl + H Help.UnityAPIReference
Dołączanie do debugera aparatu Unity (odtwarzacz lub edytor) brak wartości domyślnej Debug.AttachUnityDebugger

Jeśli nie podoba Ci się ustawienie domyślne, możesz zmienić kombinacje klawiszy skrótów. Aby uzyskać informacje na temat sposobu jego zmiany, zobacz Identyfikowanie idostosowywanie skrótów klawiaturowych w Visual Studio .

Polecenie Skrót Nazwa polecenia skrótu
Otwieranie kreatora MonoBehavior Cmd + Shift (Przesunięcie) + M EditorContextMenus.CodeWindow.ImplementMonoBehaviours
Uzyskiwanie dostępu do dokumentacji aparatu Unity Cmd+' Help.UnityAPIReference

Jeśli nie podoba Ci się ustawienie domyślne, możesz zmienić kombinacje klawiszy skrótów. Aby uzyskać informacje na temat sposobu jego zmiany, zobacz Dostosowywanie środowiska IDE.