Wdrażanie i debugowanie przy użyciu programu Visual Studio
Niezależnie od tego, czy używasz programu DirectX, czy aparatu Unity do tworzenia aplikacji rzeczywistości mieszanej, program Visual Studio to narzędzie do debugowania i wdrażania. W tej sekcji dowiesz się, jak wykonywać następujące działania:
- Wdróż aplikacje na urządzeniu HoloLens lub Windows Mixed Reality immersywny zestaw słuchawkowy za pośrednictwem programu Visual Studio.
- Użyj emulatora urządzenia HoloLens wbudowanego w program Visual Studio.
- Debugowanie aplikacji rzeczywistości mieszanej.
Wymagania wstępne
- Aby uzyskać instrukcje instalacji, zobacz Instalowanie narzędzi .
- Utwórz nowy projekt rzeczywistości mieszanej w środowisku Unity lub Visual Studio.
- Kompilowanie projektu aparatu Unity zgodnie z naszymi instrukcjami
Włączanie trybu dewelopera
Zacznij od włączenia trybu dewelopera na urządzeniu, aby program Visual Studio mógł się z nim połączyć.
Tryb dewelopera na urządzeniu HoloLens
- Włącz urządzenie HoloLens i umieść je na urządzeniu.
- Użyj gestu startowego , aby uruchomić menu główne.
- Wybierz kafelek Ustawienia , aby uruchomić aplikację w środowisku.
- Wybierz element menu Aktualizuj .
- Wybierz element menu Dla deweloperów .
- Włącz używanie funkcji dla deweloperów do wdrażania aplikacji z programu Visual Studio na urządzeniu HoloLens. Jeśli na urządzeniu działa system Windows Holographic w wersji 21H1 lub nowszej, włącz również odnajdywanie urządzeń.
- Opcjonalnie: Przewiń w dół, a także włącz portal urządzeń, który umożliwia nawiązanie połączenia z portalem urządzeń z systemem Windows na urządzeniu HoloLens z poziomu przeglądarki internetowej.
Tryb dewelopera na komputerze z systemem Windows
Jeśli pracujesz z zestawem słuchawkowym Windows Mixed Reality podłączonym do komputera, musisz włączyć tryb dewelopera na komputerze.
- Przejdź do obszaru Settings (Ustawienia).
- Wybierz pozycję Aktualizuj i zabezpieczenia.
- Wybierz pozycję Dla deweloperów.
- Włącz tryb dewelopera, przeczytaj zastrzeżenie dotyczące wybranego ustawienia, a następnie wybierz pozycję Tak , aby zaakceptować zmianę.
Wdrażanie aplikacji HoloLens za pośrednictwem Wi-Fi lub USB
Opcje kompilacji
Otwieranie projektu w programie Visual Studio
Kliknij listę rozwijaną Opcje kompilacji, a następnie wykonaj jedną z następujących czynności:
- W przypadku projektów aparatu Unity wybierz pozycję Release (Wydanie ) lub Master (Wzorzec)
- W przypadku wszystkich innych projektów wybierz pozycję Zwolnij
Poniżej przedstawiono definicje opcji kompilacji:
| Konfigurowanie | Wyjaśnienie |
|---|---|
| Debugowanie | Wszystkie optymalizacje wyłączone i profiler jest włączony. Służy do debugowania skryptów. |
| Główny | Wszystkie optymalizacje są włączone, a profiler jest wyłączony. Służy do przesyłania aplikacji do Sklepu. |
| Release | Wszystkie optymalizacje są włączone i profiler jest włączony. Służy do oceny wydajności aplikacji. |
Konfiguracja kompilacji
Wybierz konfigurację kompilacji na podstawie urządzenia.
Wybierz opcję konfiguracji ARM lub ARM64
Aby dowiedzieć się więcej na temat konfiguracji kompilacji, zobacz tabelę "Typy konfiguracji kompilacji" w dokumentacji aparatu Unity.
Uwaga
Aby przeprowadzić wdrożenie na urządzeniu HoloLens 2, wybierz architekturę ARM64 lub ARM.
Jeśli nie widzisz opcji Urządzenie jako element docelowy, może być konieczne zmianę projektu startowego dla rozwiązania programu Visual Studio z projektu IL2CPP na projekt platformy UWP. W tym celu w Eksplorator rozwiązań kliknij prawym przyciskiem myszy projekt, a następnie wybierz polecenie Ustaw jako projekt startowy.
Kliknij listę rozwijaną docelową wdrożenia, a następnie wykonaj jedną z następujących czynności:
- Jeśli tworzysz i wdrażasz za pośrednictwem sieci Wi-Fi, wybierz pozycję Maszyna zdalna.
- Jeśli tworzysz i wdrażasz za pośrednictwem portu USB, wybierz pozycję Urządzenie.
Połączenie zdalne
Aby ustawić połączenie zdalne:
Na pasku menu wybierz pozycję > Właściwości projektu Właściwości >> konfiguracji Debugowanie.
Uwaga
W przypadku projektu w języku C# powinno być automatycznie wyświetlane okno dialogowe.
Kliknij listę rozwijaną Debuger, aby uruchomić , a następnie wybierz pozycję Maszyna zdalna.
W polu Nazwa komputera wprowadź adres IP urządzenia.
Adres IP można znaleźć na urządzeniu HoloLens w obszarze Ustawienia > Sieci & opcje zaawansowane Internetu>.
Zalecamy ręczne wprowadzenie adresu IP, a nie zależności od funkcji "Automatycznie wykryte".
Ustaw opcję Tryb uwierzytelniania na uniwersalny (protokół niezaszyfrowany).
Skompiluj, wdróż i debuguj aplikację na podstawie Twoich potrzeb:
Aby skompilować, wdrożyć i rozpocząć debugowanie, wybierz pozycję Debuguj > Rozpocznij debugowanie.
Aby skompilować i wdrożyć bez debugowania, wybierz pozycję Kompiluj > rozwiązanie wdróż.
Przy pierwszym wdrożeniu aplikacji na urządzeniu HoloLens z komputera zostanie wyświetlony monit o podanie numeru PIN. Postępuj zgodnie z poniższymi instrukcjami dotyczącymi parowania urządzenia .
Uwaga
Jeśli błędy wymienione poniżej występują podczas debugowania zainstalowanej aplikacji platformy UWP na HoloLens 2, spróbuj zmienić nazwę pakietu lub odinstalowanie aplikacji platformy UWP.
"Nie można rozpocząć debugowania"
"Operacja nie jest obsługiwana. Nieznany błąd: 0x80070057"
Wdrażanie aplikacji w emulatorze urządzenia HoloLens (1. generacji)
- Upewnij się, że zainstalowano emulator urządzenia HoloLens.
- Wybierz konfigurację kompilacji x86 dla aplikacji.
- Wybierz pozycję Emulator urządzenia HoloLens w menu
rozwijanym
- Wybierz pozycję Debuguj Rozpocznij debugowanie>, aby wdrożyć aplikację i rozpocząć debugowanie bez debugowania
Wdrażanie aplikacji w emulatorze HoloLens 2
- Upewnij się, że zainstalowano emulator urządzenia HoloLens.
- Wybierz konfigurację kompilacji x86 lub x64 dla aplikacji.
- Wybierz pozycję HoloLens 2 Emulator w docelowym menu
rozwijanym
- Wybierz pozycję Debuguj Rozpocznij debugowanie>, aby wdrożyć aplikację i rozpocząć debugowanie bez debugowania
Wdrażanie aplikacji VR na komputerze lokalnym
Aby użyć Windows Mixed Reality immersywnego zestawu nagłownego łączącego się z komputerem lub symulatorem Mixed Reality:
- Wybierz konfigurację kompilacji x86 lub x64 dla aplikacji
- Wybierz pozycję Maszyna lokalna w menu rozwijanym miejsca docelowego wdrożenia
- Kompilowanie, wdrażanie i debugowanie aplikacji na podstawie Twoich potrzeb
- Wybierz pozycję Debuguj > Rozpocznij debugowanie , aby wdrożyć aplikację i rozpocząć debugowanie
- Wybieranie pozycji Kompiluj > wdróż w celu kompilowania i wdrażania bez debugowania
Parowanie urządzenia
Przy pierwszym wdrożeniu aplikacji z programu Visual Studio na urządzeniu HoloLens zostanie wyświetlony monit o podanie numeru PIN. Na urządzeniu HoloLens wygeneruj numer PIN, uruchamiając aplikację Ustawienia, przejdź do pozycji Aktualizuj > dla deweloperów i naciśnij pozycję Para. Po wyświetleniu numeru PIN na urządzeniu HoloLens wpisz go w programie Visual Studio. Po zakończeniu parowania naciśnij pozycję Gotowe na urządzeniu HoloLens, aby zamknąć okno dialogowe. Ten komputer jest teraz sparowany z urządzeniem HoloLens i można automatycznie wdrażać aplikacje. Powtórz te kroki dla każdego komputera, który jest używany do wdrażania aplikacji na urządzeniu HoloLens.
Aby rozłączyć urządzenie HoloLens ze wszystkich sparowanych komputerów:
- Uruchom aplikację Ustawienia , przejdź do pozycji Aktualizuj > dla deweloperów i naciśnij pozycję Wyczyść.
Debuger grafiki dla urządzenia HoloLens (1. generacja)
Narzędzia do diagnostyki grafiki programu Visual Studio są przydatne podczas pisania i optymalizowania aplikacji holograficznej. Aby uzyskać szczegółowe informacje, zobacz Diagnostyka grafiki programu Visual Studio w witrynie MSDN .
Aby uruchomić debuger grafiki
- Postępuj zgodnie z powyższymi instrukcjami, aby wskazać urządzenie lub emulator
- Przejdź do pozycji Debugowanie > diagnostyki uruchamiania grafiki >
- Przy pierwszym uruchomieniu diagnostyki za pomocą urządzenia HoloLens może zostać wyświetlony błąd "odmowa dostępu". Uruchom ponownie urządzenie HoloLens, aby umożliwić zastosowanie zaktualizowanych uprawnień i spróbuj ponownie.
Profilowanie
Narzędzia profilowania programu Visual Studio umożliwiają analizowanie wydajności i użycia zasobów aplikacji. Obejmuje to narzędzia do optymalizowania użycia procesora CPU, pamięci, grafiki i sieci. Aby uzyskać szczegółowe informacje, zobacz Uruchamianie narzędzi diagnostycznych bez debugowania w witrynie MSDN .
Aby uruchomić narzędzia profilowania za pomocą urządzenia HoloLens
- Postępuj zgodnie z powyższymi instrukcjami, aby wskazać urządzenie lub emulator
- Przejdź do pozycji Debuguj > uruchamianie narzędzi diagnostycznych bez debugowania...
- Wybierz narzędzia, których chcesz użyć
- Wybierz pozycję Start
- Przy pierwszym uruchomieniu diagnostyki bez debugowania za pomocą urządzenia HoloLens może zostać wyświetlony błąd "odmowa dostępu". Uruchom ponownie urządzenie HoloLens, aby umożliwić zastosowanie zaktualizowanych uprawnień i spróbuj ponownie.
Debugowanie zainstalowanej lub uruchomionej aplikacji
Za pomocą programu Visual Studio można debugować zainstalowaną aplikację uniwersalną systemu Windows bez wdrażania z projektu programu Visual Studio. Jest to przydatne, jeśli chcesz debugować zainstalowany pakiet aplikacji lub debugować aplikację, która jest już uruchomiona.
- Przejdź do pozycji Debugowanie —> inne elementy docelowe debugowania —> debugowanie zainstalowanego pakietu aplikacji
- Wybierz docelową maszynę zdalną dla urządzenia HoloLens lub komputera lokalnego dla immersywnych zestawów nagłownych.
- Wprowadź adres IP urządzenia
- Wybieranie trybu uwierzytelniania uniwersalnego
- W oknie są wyświetlane zarówno uruchomione, jak i nieaktywne aplikacje. Wybierz ten, który chcesz debugować.
- Wybierz typ kodu do debugowania (zarządzany, natywny, mieszany)
- Wybierz pozycję Dołącz lub Rozpocznij
Następny punkt kontrolny programowania
Jeśli obserwujesz określoną podróż do punktu kontrolnego tworzenia aparatu Unity, jesteś w trakcie etapu wdrażania. W tym miejscu możesz przejść do następnego tematu:
Możesz też przejść bezpośrednio do dodawania usług zaawansowanych:
Zawsze możesz wrócić do punktów kontrolnych tworzenia aparatu Unity w dowolnym momencie.