Använda Visual Studio för att distribuera och felsöka
Oavsett om du använder DirectX eller Unity för att utveckla din mixed reality-app är Visual Studio ditt verktyg för felsökning och distribution. I det här avsnittet får du lära dig att:
- Distribuera program till HoloLens eller Windows Mixed Reality integrerande headset via Visual Studio.
- Använd HoloLens-emulatorn som är inbyggd i Visual Studio.
- Felsöka appar för mixad verklighet.
Förutsättningar
- Installationsinstruktioner finns i Installera verktygen .
- Skapa ett nytt projekt för mixad verklighet i Unity eller Visual Studio.
- Skapa ditt Unity-projekt enligt våra instruktioner
Aktivera utvecklarläge
Börja med att aktivera Utvecklarläge på enheten så att Visual Studio kan ansluta till den.
Utvecklarläge på HoloLens
- Aktivera HoloLens och sätt på enheten.
- Använd startgesten för att starta huvudmenyn.
- Välj panelen Inställningar för att starta appen i din miljö.
- Välj menyalternativet Uppdatera .
- Välj menyalternativet För utvecklare .
- Aktivera Använd utvecklarfunktioner för att distribuera appar från Visual Studio till holoLens. Om enheten kör Windows Holographic version 21H1 eller senare aktiverar du även Enhetsidentifiering.
- Valfritt: Rulla nedåt och aktivera även Enhetsportal, som gör att du kan ansluta till Windows-enhetsportalen på HoloLens från en webbläsare.
Utvecklarläge på en Windows-dator
Om du arbetar med ett Windows Mixed Reality headset som är anslutet till datorn måste du aktivera utvecklarläge på datorn.
- Gå till Inställningar.
- Välj Uppdatera och säkerhet.
- Välj För utvecklare.
- Aktivera utvecklarläge, läs ansvarsfriskrivningen för den inställning du har valt och välj sedan Ja för att acceptera ändringen.
Distribuera en HoloLens-app via Wi-Fi eller USB
Kompileringsalternativ
Öppna projektet i Visual Studio
Klicka på listrutan Kompileringsalternativ och gör sedan något av följande:
- För Unity-projekt väljer du antingen Release (Version) eller Master (Huvudversion)
- För alla andra projekt väljer du Släpp
Här är definitioner för kompileringsalternativen:
Konfiguration | Förklaring |
---|---|
Felsöka | Alla optimeringar av och profileraren är aktiverad. Används för att felsöka skript. |
Huvudserver | Alla optimeringar är aktiverade och profileraren är inaktiverad. Används för att skicka appar till Store. |
Frisläpp | Alla optimeringar är aktiverade och profileraren är aktiverad. Används för att utvärdera appens prestanda. |
Skapa konfiguration
Välj din byggkonfiguration baserat på din enhet.
Välj konfigurationsalternativet ARM eller ARM64
Mer information om byggkonfigurationerna finns i tabellen "Typer av byggkonfigurationer" i Unity-dokumentationen.
Anteckning
För distribution till HoloLens 2 enhet väljer du ARM64- eller ARM-arkitekturen.
Om du inte ser alternativet Enhet som mål kan du behöva ändra startprojektet för Visual Studio-lösningen från IL2CPP-projektet till UWP-projektet. Det gör du genom att högerklicka på projektet i Solution Explorer och sedan välja Ange som startprojekt.
Klicka på listrutan distributionsmål och gör sedan något av följande:
- Om du skapar och distribuerar via Wi-Fi väljer du Fjärrdator.
- Om du skapar och distribuerar via USB väljer du Enhet.
Fjärranslutning
Så här ställer du in fjärranslutningen:
På menyraden väljer du Konfigurationsegenskaper >> för projektegenskaper > Felsökning.
Anteckning
För ett C#-projekt bör en dialogruta visas automatiskt.
Klicka på felsökningsprogrammet för att starta listrutan och välj sedan Fjärrdator.
I fältet Datornamn anger du ENHETENs IP-adress.
Du hittar IP-adressen på din HoloLens under Inställningar > Nätverk & Internet > Avancerade alternativ.
Vi rekommenderar att du anger din IP-adress manuellt i stället för att vara beroende av funktionen "Identifierad automatiskt".
Ställ in autentiseringsläget på Universell (okrypterat protokoll).
Skapa, distribuera och felsök din app baserat på dina behov:
Om du vill skapa, distribuera och börja felsöka väljer du Felsöka > Starta felsökning.
Om du vill skapa och distribuera utan felsökning väljer du Skapa > distribuera lösning.
Första gången du distribuerar en app till HoloLens från datorn uppmanas du att ange en PIN-kod. Följ instruktionerna för att koppla ihop enheten nedan.
Anteckning
Om felen som anges nedan inträffar när du börjar felsöka ett installerat UWP-program på HoloLens 2 kan du prova att byta namn på paketet eller avinstallera UWP-programmet.
"Det går inte att starta felsökningen"
"Åtgärden stöds inte. Okänt fel: 0x80070057"
Distribuera en app till HoloLens-emulatorn (första generationen)
- Kontrollera att du har installerat HoloLens-emulatorn.
- Välj en x86-byggkonfiguration för din app.
- Välj HoloLens-emulatorn i den nedrullningsbara menyn
- Välj Felsök > Starta felsökning för att distribuera din app och börja felsöka
Distribuera en app till HoloLens 2-emulatorn
- Kontrollera att du har installerat HoloLens-emulatorn.
- Välj en x86 - eller x64-byggkonfiguration för din app.
- Välj HoloLens 2 emulatorn i den nedrullningsbara menyn
- Välj Felsök > Starta felsökning för att distribuera din app och börja felsöka
Distribuera en VR-app till din lokala dator
Så här använder du ett Windows Mixed Reality integrerande headset som ansluter till datorn eller Mixed Reality-simulatorn:
- Välj en x86 - eller x64-byggkonfiguration för din app
- Välj Lokal dator i listrutan distributionsmål
- Skapa, distribuera och felsöka din app baserat på dina behov
- Välj Felsök > Starta felsökning för att distribuera din app och börja felsöka
- Välj Skapa > distribution för att skapa och distribuera utan felsökning
Koppla ihop enheten
Första gången du distribuerar en app från Visual Studio till HoloLens uppmanas du att ange en PIN-kod. Generera en PIN-kod på HoloLens genom att starta appen Inställningar, gå till Uppdatera > för utvecklare och tryck på Par. När PIN-koden visas på HoloLens skriver du den i Visual Studio. När parkopplingen är klar trycker du på Klar i HoloLens för att stänga dialogrutan. Den här datorn är nu kopplad till HoloLens och du kan distribuera appar automatiskt. Upprepa de här stegen för varje dator som används för att distribuera appar till HoloLens.
Så här löser du in HoloLens från alla parkopplade datorer:
- Starta appen Inställningar , gå till Uppdatera > för utvecklare och tryck på Rensa.
Grafikfelsökare för HoloLens (första generationen)
Visual Studio-grafikdiagnostikverktygen är användbara när du skriver och optimerar en holografisk app. Fullständig information finns i Visual Studio-grafikdiagnostik på MSDN .
Starta grafikfelsökaren
- Följ anvisningarna ovan för att rikta in dig på en enhet eller emulator
- Gå till Felsöka > startdiagnostik för grafik >
- Första gången du startar diagnostik med en HoloLens kan du få felet "åtkomst nekad". Starta om HoloLens så att de uppdaterade behörigheterna börjar gälla och försök igen.
Profilering
Med Visual Studio-profileringsverktygen kan du analysera appens prestanda och resursanvändning. Detta omfattar verktyg för att optimera PROCESSOR, minne, grafik och nätverksanvändning. Fullständig information finns i Köra diagnostikverktyg utan felsökning på MSDN .
Starta profileringsverktygen med HoloLens
- Följ anvisningarna ovan för att rikta in dig på en enhet eller emulator
- Gå till Felsöka > startdiagnostikverktyg utan felsökning...
- Välj de verktyg som du vill använda
- Välj Start
- Första gången du startar diagnostik utan att felsöka med en HoloLens kan du få felet "åtkomst nekad". Starta om HoloLens så att de uppdaterade behörigheterna börjar gälla och försök igen.
Felsöka en installerad eller körande app
Du kan använda Visual Studio för att felsöka en installerad Universell Windows-app utan att distribuera från ett Visual Studio-projekt. Detta är användbart om du vill felsöka ett installerat appaket eller felsöka en app som redan körs.
- Gå till Felsökning –> Andra felsökningsmål –> Felsöka installerat appaket
- Välj målet Fjärrdator för HoloLens eller Lokal dator för integrerande headset.
- Ange enhetens IP-adress
- Välj universellt autentiseringsläge
- Fönstret visar både aktiva och inaktiva appar. Välj det du vill felsöka.
- Välj vilken typ av kod som ska felsökas (hanterad, intern, blandad)
- Välj Bifoga eller Starta
Nästa kontrollpunkt för utveckling
Om du följer vägspärren för Unity-utveckling som vi har lagt fram befinner du dig mitt i distributionsfasen. Härifrån kan du fortsätta till nästa avsnitt:
Eller gå direkt till att lägga till avancerade tjänster:
Du kan alltid gå tillbaka till unity-utvecklingskontrollpunkterna när som helst.