6. Verpacken und Bereitstellen auf einem Gerät oder in einem Emulator6. Packaging & deploying to device or emulator

ÜbersichtOverview

Im vorhergehenden Tutorial haben Sie eine einfache Schaltfläche hinzugefügt, mit der die Schachfigur an ihre ursprüngliche Position zurückgesetzt wird.In the previous tutorial, you added a simple button that resets the chess piece to its original position. In diesem letzten Abschnitt führen Sie die App auf HoloLens 2 oder in einem Emulator aus.In this final section, you'll get the app ready to run on a HoloLens 2 or an Emulator. Wenn Sie über ein HoloLens 2 verfügen, können Sie die App entweder von Ihrem Computer t streamen oder verpacken, um sie direkt auf dem Gerät auszuführen.If you have a HoloLens 2, you can either stream from your computer or package the app to run directly on the device. Wenn Sie kein Gerät haben, verpacken Sie die App, um Sie auf dem Emulator auszuführen.If you don't have a device, you'll be packaging the app to run on the Emulator. Am Ende dieses Abschnitts verfügen Sie über eine bereitgestellte Mixed Reality-App mit Interaktionen und Benutzeroberfläche, die Sie abspielen können.By the end of this section, you'll have a deployed mixed reality app that you can play, complete with interactions and UI.

ZieleObjectives

  • Streamen der App an HoloLens 2 mit holografischem App-Remoting (nur Gerät)[Device only] Streaming to HoloLens 2 with holographic app remoting
  • Verpacken und Bereitstellen der App auf einem HoloLens 2-Gerät oder in einem EmulatorPackaging and deploying the app to a HoloLens 2 device or emulator

Streamen (nur Gerät)[Device Only] Streaming

Holografisches Remoting bedeutet in diesem Fall das Streamen von Daten von einem PC oder einem eigenständigen UWP-Gerät auf die HoloLens 2, ohne den Kanal zu wechseln.Holographic Remoting in this case means streaming data from a PC or standalone UWP device to the HoloLens 2, not switching the channel. Dabei empfängt die Remotinghost-App einen Eingabedatenstrom von einer HoloLens, rendert die Inhalte in einer virtuellen Rundumsicht und streamt die Inhaltsframes über WLAN zurück an die HoloLens.The way this works is a remoting host app receives an input data stream from a HoloLens, renders content in a virtual immersive view, and streams content frames back to HoloLens over Wi-Fi. Streaming ermöglicht es Ihnen, Remoteansichten mit der vorhandenen Desktop-PC-Software zu generieren und mehr Systemressourcen zu nutzen.Streaming allows you to add remote immersive views into existing desktop PC software and has access to more system resources.

Um diese Möglichkeit für die Schach-App zu nutzen, müssen einige Voraussetzungen erfüllt sein:If you're going this route with the chess app, you'll need a few things:

  1. Installieren Sie den Holographic Remoting-Player aus dem Microsoft Store auf Ihrem HoloLens 2-Gerät, und führen Sie die App aus.Install the Holographic Remoting Player from the Microsoft Store on your HoloLens 2 and run the app. Notieren Sie die in der App angezeigte IP-Adresse.Note your IP address displayed in the app.

  2. Klicken Sie wieder im Unreal-Editor auf Edit > Project Settings (Bearbeiten > Projekteinstellungen), und aktivieren Sie im Abschnitt Holographic Remoting (Holografisches Remoting) die Option enable remoting (Remoting aktivieren).Back in the Unreal editor, go to Edit > Project Settings and check Enable Remoting in the Holographic Remoting section.

  3. Führen Sie einen Neustart des Editors durch, geben Sie dann die IP-Adresse Ihres Geräts ein (wie in der Holographic Remoting Player-App angezeigt), und klicken Sie dann auf Connect (Verbinden).Restart the editor, then enter your device's IP address (as displayed in the Holographic Remoting Player app), then click Connect.

Wenn die Verbindung hergestellt wurde, klicken Sie rechts neben der Schaltfläche Play (Wiedergeben) auf den Dropdownpfeil, und wählen Sie VR Preview (VR-Vorschau) aus.Once you’re connected, click the drop-down arrow to the right of the Play button and select VR Preview. Dadurch wird die App im VR-Vorschaufenster ausgeführt, das an das HoloLens-Headset gestreamt wird.This will run the app in the VR Preview window, which is streamed to the HoloLens headset.

Packen und Bereitstellen der App über das GeräteportalPackaging and deploying the app via device portal

Hinweis

Wenn Sie zum ersten Mal eine Unreal-App für HoloLens verpacken, müssen Sie unterstützende Dateien aus dem Epic-Startprogramm herunterladen.If this is your first time packaging an Unreal app for HoloLens, you'll need to download supporting files from the Epic Launcher.

  • Wechseln Sie zu Editor-Einstellungen > Allgemein > Quellcode > Quellcode-Editor, und vergewissern Sie sich, dass Visual Studio 2019 ausgewählt ist.Go to Editor Preferences > General > Source Code > Source Code Editor and check that Visual Studio 2019 is selected.
  • Wechseln Sie im Epic Games-Startprogramm zur Registerkarte Library (Bibliothek), klicken Sie neben Launch (Starten) auf den Dropdownpfeil und dann auf Options (Optionen).Go to the Library tab in the Epic Games Launcher, select the dropdown arrow next to Launch >and click Options.
  • Wählen Sie unter Target Platforms (Zielplattformen) HoloLens 2 aus, und klicken Sie auf Apply (Übernehmen).Under Target Platforms, select HoloLens 2 and click Apply. Ändern der Zielplattform in den ProjekteinstellungenChange target platform in project settings
  1. Navigieren Sie zu Edit > Project Settings („Bearbeiten“ > „Projekteinstellungen“).Go to Edit > Project Settings.
    • Fügen Sie unter Project > Description > About > Project Name (Projekt > Beschreibung > Info > Projektname) einen Namen für Ihr Projekt hinzu.Add a project name under Project > Description > About > Project Name.
    • Fügen Sie unter Project > Description > Publisher > Company Distinguished Name (Projekt > Beschreibung > Herausgeber > Definierter Name des Unternehmens) Folgendes ein: CN=IhrFirmenname.Add CN=YourCompanyName under Project > Description > Publisher > Company Distinguished Name.

Wichtig

Eins dieser Felder leer zu lassen, führt zu einem Fehler, wenn Sie in Schritt 3 versuchen, ein neues Zertifikat zu generieren.Leaving either of these fields blank will result in an error when you try and generate a new certificate in step 3.

Wichtig

Der Name des Ausstellers muss im LADPv3-Format für definierte Namen vorliegen.The publisher's name must be in LADPv3 Distinguished Names Format. Ein Ausstellername in ungültigem Format führt beim Verpacken zum Fehler „Signaturschlüssel nicht gefunden.A malformed publisher's name leads to the "Signing key not found. Die App konnte nicht digital signiert werden“The app could not be digitally signed." .error upon packaging.

Projekteinstellungen: Beschreibung

  1. Aktivieren Sie unter Platforms > HoloLens (Plattformen > HoloLens) die Optionen Build for HoloLens Emulation (Build für HoloLens-Emulation) und/oder Build for HoloLens Device (Build für HoloLens-Gerät).Enable Build for HoloLens Emulation and/or Build for HoloLens Device under Platforms > HoloLens.

  2. Klicken Sie im Abschnitt Packaging (Verpacken) neben Signing Certificate (Signaturzertifikat) auf Generate new (Neu generieren).Click Generate new in the Packaging section (next to Signing Certificate).

Wichtig

Wenn Sie ein bereits generiertes Zertifikat verwenden, muss der Name des Zertifikatausstellers gleich dem Namen des Herausgebers der Anwendung sein.If you're using an already generated certificate, then the certificate's publisher name must be the same as the application's publisher name. Andernfalls führt dies zum „Signaturschlüssel nicht gefunden.Otherwise it leads to the "Signing key not found. Die App konnte nicht digital signiert werden“-The app could not be digitally signed." Fehler.error.

Projekteinstellungen: Plattformen (HoloLens)

  1. Klicken Sie für Testzwecke auf Keins, wenn Sie aufgefordert werden, ein Kennwort für den privaten Schlüssel zu erstellen.Click None for testing purposes when you're prompted to create a Private Key Password.

Generieren eines neuen Zertifikats

  1. Navigieren Sie zu File > Package Project („Datei“ > „Projekt verpacken“), und wählen Sie HoloLens aus.Go to File > Package Project and select HoloLens.

    • Erstellen Sie einen neuen Ordner zum Speichern Ihres Pakets, und klicken Sie auf Select Folder (Ordner auswählen).Create a new folder to save your package in and click Select Folder.
  2. Öffnen Sie nach dem Verpacken der App das Windows-Geräteportal, navigieren Sie zu Views > Apps (Ansichten > Apps), und suchen Sie nach dem Abschnitt Deploy apps (Apps bereitstellen).Open the Windows Device Portal once the app is packaged, go to Views > Apps and find the Deploy apps section.

  3. Klicken Sie auf Durchsuchen... , navigieren Sie zur Datei ChessApp.appxbundle, und klicken Sie auf Öffnen.Click Browse..., go to your ChessApp.appxbundle file and click Open.

    • Aktivieren Sie das Kontrollkästchen neben Allow me to select framework packages (Auswählen von Framework-Paketen zulassen), wenn Sie die App zum ersten Mal auf Ihrem Gerät installieren.Check the box next to Allow me to select framework packages if this is the first time you're installing the app on your device.
    • Schließen Sie im nächsten Dialogfeld die entsprechenden VCLibs- und appx-Dateien ein („arm64“ für Gerät, „x64“ für Emulator).In the next dialogue, include the appropriate VCLibs and appx files (arm64 for device, x64 for emulator). Sie finden diese in dem Ordner, in dem Sie das Paket gespeichert haben, unter HoloLens.You can find these under HoloLens inside the folder where you saved your package.
  4. Klicken Sie auf Install (Installieren).Click Install

    • Sie können jetzt zu All Apps (Alle Apps) wechseln und auf die neu installierte App tippen, um sie auszuführen. Sie können die App jedoch auch direkt über das Windows-Geräteportal starten.You can now go to All Apps and tap the newly installed app to run it, or you can start the app directly from the Windows Device Portal.

Herzlichen Glückwunsch!Congratulations! Ihre Mixed Reality-Anwendung für HoloLens ist fertig und einsatzbereit.Your HoloLens mixed reality application is finished and ready to go. Das ist aber noch nicht alles.However, this isn't the end of the road. MRTK verfügt über viele eigenständige Features, die Sie zu Ihren Projekten hinzufügen können, einschließlich räumlicher Zuordnung, Anvisieren und Spracheingabe und sogar QR-Codes.MRTK has lots of standalone features that you can add to your projects, including spatial mapping, gaze and voice input, and even QR codes. Weitere Informationen zu diesen Features finden Sie unter Unreal-Entwicklung: Übersicht.More information on these features can be found in the Unreal development overview.

Nächster EntwicklungsprüfpunktNext Development Checkpoint

Wenn Sie dem Weg der Unreal-Entwicklungsprüfpunkte folgen, den wir entworfen haben, befinden Sie sich mitten im Kennenlernen der MRTK-Grundbausteine.If you're following the Unreal development checkpoint journey we've laid out, you're in the midst of exploring the MRTK core building blocks. Von hier aus können Sie mit dem nächsten Baustein fortfahren:From here, you can proceed to the next building block:

Oder fahren Sie mit den Funktionen und APIs der Mixed Reality-Plattform fort:Or jump to Mixed Reality platform capabilities and APIs:

Sie können jederzeit zu den Prüfpunkten für die Unreal-Entwicklung zurückkehren.You can always go back to the Unreal development checkpoints at any time.