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

  1. Aby uzyskać instrukcje instalacji, zobacz Instalowanie narzędzi .
  2. Utwórz nowy projekt rzeczywistości mieszanej w środowisku Unity lub Visual Studio.
  3. 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

  1. Włącz urządzenie HoloLens i umieść je na urządzeniu.
  2. Użyj gestu startowego , aby uruchomić menu główne.
  3. Wybierz kafelek Ustawienia , aby uruchomić aplikację w środowisku.
  4. Wybierz element menu Aktualizuj .
  5. Wybierz element menu Dla deweloperów .
  6. 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ń.
  7. 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.

  1. Przejdź do obszaru Settings (Ustawienia).
  2. Wybierz pozycję Aktualizuj i zabezpieczenia.
  3. Wybierz pozycję Dla deweloperów.
  4. 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

  1. Otwieranie projektu w programie Visual Studio

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

    Zrzut ekranu przedstawiający opcje kompilacji w programie Visual Studio

    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

  1. Wybierz konfigurację kompilacji na podstawie urządzenia.

    Wybierz opcję konfiguracji ARM lub ARM64

    Konfiguracja kompilacji ARM64 w programie Visual Studio

    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.

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

    Wybierz pozycję

    • Jeśli tworzysz i wdrażasz za pośrednictwem portu USB, wybierz pozycję Urządzenie.

    Wybierz pozycję

Połączenie zdalne

Aby ustawić połączenie zdalne:

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

  2. Kliknij listę rozwijaną Debuger, aby uruchomić , a następnie wybierz pozycję Maszyna zdalna.

  3. W polu Nazwa komputera wprowadź adres IP urządzenia.

    Okno dialogowe Połączenia zdalnego w programie Visual Studio

    • Adres IP można znaleźć na urządzeniu HoloLens w obszarze Ustawienia > Sieciowe & opcje zaawansowane Internetu>.

    • Zalecamy ręczne wprowadzenie adresu IP, a nie zależności od funkcji "Automatycznie wykryte".

  4. Ustaw opcję Tryb uwierzytelniania na uniwersalny (protokół niezaszyfrowany).

  5. 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óż.

  6. 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 urządzeniu 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)

  1. Upewnij się, że zainstalowano emulator urządzenia HoloLens.
  2. Wybierz konfigurację kompilacji x86 dla aplikacji. Wybieranie konfiguracji kompilacji x86 w programie Visual Studio
  3. Wybierz pozycję Emulator urządzenia HoloLens w menu
    rozwijanymDocelowy element docelowy wdrożenia Emulator w programie Visual Studio
  4. Wybierz pozycję Debuguj Rozpocznij debugowanie>, aby wdrożyć aplikację i rozpocząć debugowanie bez debugowania
    w programie Visual Studio

Wdrażanie aplikacji w emulatorze urządzenia HoloLens 2

  1. Upewnij się, że zainstalowano emulator urządzenia HoloLens.
  2. Wybierz konfigurację kompilacji x86 lub x64 dla aplikacji.
    Konfiguracja ustawienia kompilacji x86 w programie Visual Studio
  3. Wybierz pozycję HoloLens 2 Emulator w menu
    rozwijanymDocelowy emulator wdrożenia w aplikacji programu Visual Studio
  4. Wybierz pozycję Debuguj Rozpocznij debugowanie>, aby wdrożyć aplikację i rozpocząć debugowanie bez debugowania
    w programie Visual Studio

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:

  1. Wybierz konfigurację kompilacji x86 lub x64 dla aplikacji
  2. Wybierz pozycję Maszyna lokalna w menu rozwijanym miejsca docelowego wdrożenia
  3. 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

  1. Postępuj zgodnie z powyższymi instrukcjami, aby wskazać urządzenie lub emulator
  2. Przejdź do pozycji Debugowanie > diagnostyki uruchamiania grafiki >
  3. 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

  1. Postępuj zgodnie z powyższymi instrukcjami, aby wskazać urządzenie lub emulator
  2. Przejdź do pozycji Debuguj > uruchamianie narzędzi diagnostycznych bez debugowania...
  3. Wybierz narzędzia, których chcesz użyć
  4. Wybierz pozycję Start
  5. 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.

  1. Przejdź do pozycji Debugowanie —> inne elementy docelowe debugowania —> debugowanie zainstalowanego pakietu aplikacji
  2. Wybierz docelową maszynę zdalną dla urządzenia HoloLens lub komputera lokalnego dla immersywnych zestawów nagłownych.
  3. Wprowadź adres IP urządzenia
  4. Wybieranie trybu uwierzytelniania uniwersalnego
  5. W oknie są wyświetlane zarówno uruchomione, jak i nieaktywne aplikacje. Wybierz ten, który chcesz debugować.
  6. Wybierz typ kodu do debugowania (zarządzany, natywny, mieszany)
  7. 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.

Zobacz też