Einrichten der UWP-Entwicklungsumgebung auf Xbox

Artikel
10/24/2023

Die UWP-Entwicklungsumgebung auf Xbox besteht aus einem Entwicklungs-PC, der über ein lokales Netzwerk mit einem Xbox One Konsole verbunden ist. Für diesen Entwicklungs-PC wird Visual Studio 2015 Update 3, Visual Studio 2017 oder Visual Studio 2019 vorausgesetzt. Der Entwicklungs-PC erfordert auch Windows 10, das Windows 10 SDK Build 14393 oder höher erfordert als auch eine Reihe von unterstützenden Tools.

Dieser Artikel beschreibt die Schritte zum Einrichten und Testen der Entwicklungsumgebung.

Setup von Visual Studio

Installieren Sie Visual Studio 2015 Update 3, Visual Studio 2017 oder Visual Studio 2019. Weitere Informationen und die Installation finden Sie unter Downloads und Tools für Windows 10. Es wird empfohlen, die neueste Version von Visual Studio zu verwenden, damit Sie die neuesten Updates für Entwickler und Sicherheit erhalten können.
Wenn Sie Visual Studio 2017 oder Visual Studio 2019 installieren, stellen Sie sicher, dass Sie die Entwicklung der universellen Windows-Plattform Workload auswählen. Wenn Sie C++-Entwickler sind, stellen Sie im Bereich Zusammenfassung auf der rechten Seite unter Entwicklung der universellen Windows-Plattformsicher, dass Sie auch das Kontrollkästchen C++-Tools für die universelle Windows-Plattform aktivieren. Es ist nicht Teil der Standardinstallation.

Wenn Sie Visual Studio 2015 Update 3 installieren, stellen Sie sicher, dass das Kontrollkästchen Entwicklungstools für universelle Windows-Apps aktiviert ist.

Setup von Windows 10 SDK

Installieren Sie das aktuelle Windows 10 SDK. Es wird mit Ihrer Visual Studio-Installation geliefert. Wenn Sie es jedoch separat herunterladen möchten, lesen Sie Windows 10 SDK.

Aktivieren des Entwicklermodus

Bevor Sie Apps von Ihrem Entwicklungs-PC bereitstellen können, müssen Sie den Entwicklermodus aktivieren. Navigieren Sie in der App Einstellungen zu Sicherheit Update & Sicherheit / Für Entwickler und wählen Sie unter Entwicklerfeatures verwenden die Option Entwicklermodus aus.

Einrichten Ihrer Xbox One

Bevor Sie eine App auf Ihrer Xbox One bereitstellen können, müssen Sie einen Benutzer auf der Konsole angemeldet haben. Sie können entweder Ihr vorhandenes Xbox Live-Konto verwenden oder ein neues Konto für Ihre Konsole im Entwicklermodus erstellen.

Erstellen Ihrer ersten App

Stellen Sie sicher, dass sich Ihr Entwicklungs-PC im selben lokalen Netzwerk wie die Xbox One-Zielkonsole befindet. In der Regel bedeutet dies, dass sie denselben Router verwenden und sich im selben Subnetz befinden sollten. Es wird eine kabelgebundene Netzwerkverbindung empfohlen.
Stellen Sie sicher, dass sich Ihre Xbox One-Konsole im Entwicklermodus befindet. Weitere Informationen finden Sie unter Aktivierung des Xbox-Entwicklermodus.
Entscheiden Sie sich für die Programmiersprache, die Sie für Ihre UWP-App verwenden möchten.
Wählen Sie auf Ihrem Entwicklungs-PC in Visual Studio die Option Neu/Projekt aus.
Wählen Sie im Fenster Neues ProjektWindows Universal /Leere App (Universal Windows) aus.

Starten eines C#-Projekts

New Project dialog

Wählen Sie im Dialogfeld Neues universelles Windows-Projekt Version 14393 oder höher in der Dropdownliste Mindestversion aus. Wählen Sie das neueste SDK im Dropdownmenü Zielversion aus. Wenn das Dialogfeld Entwicklermodus angezeigt wird, klicken Sie auf OK. Eine neue leere App wird erstellt.
Konfigurieren Sie Ihre Entwicklungsumgebung für das Remotedebugging:

a. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt und wählen Sie dann Eigenschaften aus.

b. Ändern Sie auf der Registerkarte DebuggenPlattform in x64. (x86 ist keine unterstützte Plattform mehr auf Xbox.)

c. Ändern Sie unter StartoptionenZielgerät in Remotecomputer.

d. Geben Sie in Remotecomputer die System-IP-Adresse oder den Hostnamen der Xbox One-Konsole ein. Informationen zum Abrufen der IP-Adresse oder des Hostnamens finden Sie unter Einführung in Xbox One-Tools.

e. Wählen Sie in der Dropdownliste AuthentifizierungsmodusUniverselles (unverschlüsseltes Protokoll) aus.

Starten eines C++-Projekts

C++ project

Wählen Sie im Dialogfeld Neues universelles Windows-Projekt Version 14393 oder höher in der Dropdownliste Mindestversion aus. Wählen Sie das neueste SDK im Dropdownmenü Zielversion aus. Wenn das Dialogfeld Entwicklermodus angezeigt wird, klicken Sie auf OK. Eine neue leere App wird erstellt.
Konfigurieren Sie Ihre Entwicklungsumgebung für das Remotedebugging:

a. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt und wählen Sie dann Eigenschaften aus.

b. Ändern Sie auf der Registerkarte DebuggenDebugger, um zu Remotecomputer zu starten.

c. Geben Sie unter Computername die System-IP-Adresse oder den Hostnamen der Xbox One-Konsole ein. Informationen zum Abrufen der IP-Adresse oder des Hostnamens finden Sie unter Einführung in Xbox One-Tools.

d. Wählen Sie in der Dropdownliste AuthentifizierungstypUniverselles (unverschlüsseltes Protokoll) aus.

e. Wählen Sie in der Dropdownliste Plattformx64aus.

Koppeln des Geräts per PIN mit Visual Studio

Speichern Sie Ihre Einstellungen und stellen Sie sicher, dass sich Ihre Xbox One-Konsole im Entwicklermodus befindet.
Drücken Sie F5, wenn Ihr Projekt in Visual Studio geöffnet ist.
Wenn dies Ihre erste Bereitstellung ist, erhalten Sie ein Dialogfeld von Visual Studio, in dem Sie aufgefordert werden, Ihr Gerät mit einer PIN zu koppeln.

a. Um eine PIN zu erhalten, öffnen Sie Dev Home über den Startbildschirm auf Ihrer Xbox One-Konsole.

b. Wählen Sie auf der Registerkarte Start unter Schnelle Aktionen die Option Visual Studio-Pin anzeigen aus.

c. Geben Sie Ihre PIN in das Dialogfeld Koppeln mit Visual Studio ein. Die folgende PIN ist nur ein Beispiel; Ihre werden unterschiedlich sein.

d. Bereitstellungsfehler werden gegebenenfalls im Ausgabefenster angezeigt.

Herzlichen Glückwunsch, Sie haben Ihre erste UWP-App auf Xbox erfolgreich erstellt und bereitgestellt!