Använda Visual Studio för att distribuera och felsöka

  • Artikel

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

  1. Installationsinstruktioner finns i Installera verktygen .
  2. Skapa ett nytt projekt för mixad verklighet i Unity eller Visual Studio.
  3. 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

  1. Aktivera HoloLens och sätt på enheten.
  2. Använd startgesten för att starta huvudmenyn.
  3. Välj panelen Inställningar för att starta appen i din miljö.
  4. Välj menyalternativet Uppdatera .
  5. Välj menyalternativet För utvecklare .
  6. 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.
  7. 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.

  1. Gå till Inställningar.
  2. Välj Uppdatera och säkerhet.
  3. Välj För utvecklare.
  4. 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

  1. Öppna projektet i Visual Studio

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

    Skärmbild som visar kompileringsalternativ i Visual Studio

    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

  1. Välj din byggkonfiguration baserat på din enhet.

    Välj konfigurationsalternativet ARM eller ARM64

    ARM64-byggkonfiguration i Visual Studio

    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.

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

    Välj

    • Om du skapar och distribuerar via USB väljer du Enhet.

    Välj

Fjärranslutning

Så här ställer du in fjärranslutningen:

  1. På menyraden väljer du Konfigurationsegenskaper >> för projektegenskaper > Felsökning.

    Anteckning

    För ett C#-projekt bör en dialogruta visas automatiskt.

  2. Klicka på felsökningsprogrammet för att starta listrutan och välj sedan Fjärrdator.

  3. I fältet Datornamn anger du ENHETENs IP-adress.

    Dialogrutan Fjärranslutning i Visual Studio

    • 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".

  4. Ställ in autentiseringsläget på Universell (okrypterat protokoll).

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

  6. 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)

  1. Kontrollera att du har installerat HoloLens-emulatorn.
  2. Välj en x86-byggkonfiguration för din app. Välj en x86-byggkonfiguration i Visual Studio
  3. Välj HoloLens-emulatorn i den nedrullningsbara menyn
    Emulatormål för distributionsmål i Visual Studio
  4. Välj Felsök > Starta felsökning för att distribuera din app och börja felsöka
    Starta utan felsökning i Visual Studio

Distribuera en app till HoloLens 2-emulatorn

  1. Kontrollera att du har installerat HoloLens-emulatorn.
  2. Välj en x86 - eller x64-byggkonfiguration för din app.
    konfiguration av x86-bygginställning i Visual Studio
  3. Välj HoloLens 2 emulatorn i den nedrullningsbara menyn
    Emulatormål för distributionsmål i Visual Studio-programmet
  4. Välj Felsök > Starta felsökning för att distribuera din app och börja felsöka
    Starta utan felsökning i Visual Studio

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:

  1. Välj en x86 - eller x64-byggkonfiguration för din app
  2. Välj Lokal dator i listrutan distributionsmål
  3. 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

  1. Följ anvisningarna ovan för att rikta in dig på en enhet eller emulator
  2. Gå till Felsöka > startdiagnostik för grafik >
  3. 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

  1. Följ anvisningarna ovan för att rikta in dig på en enhet eller emulator
  2. Gå till Felsöka > startdiagnostikverktyg utan felsökning...
  3. Välj de verktyg som du vill använda
  4. Välj Start
  5. 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.

  1. Gå till Felsökning –> Andra felsökningsmål –> Felsöka installerat appaket
  2. Välj målet Fjärrdator för HoloLens eller Lokal dator för integrerande headset.
  3. Ange enhetens IP-adress
  4. Välj universellt autentiseringsläge
  5. Fönstret visar både aktiva och inaktiva appar. Välj det du vill felsöka.
  6. Välj vilken typ av kod som ska felsökas (hanterad, intern, blandad)
  7. 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:

Distribuera till HoloLens-emulatorn

Eller gå direkt till att lägga till avancerade tjänster:

Avancerade tjänster

Du kan alltid gå tillbaka till unity-utvecklingskontrollpunkterna när som helst.

Se även