Nach der Einrichtung der Xbox kommt nun die Entwicklungsumgebung dran.
- Einrichten von Visual Studio
- Einrichten des Windows 10 SDK
- Die Konsole mittels Pin an Visual Studio koppeln
Die Abbildungen zeigen Windows 10 und eine Xbox One im lokalen Netzwerk (2018). Für die Bereitstellung eines UWP-Projekts benötigt ihr weiterhin die passenden Visual-Studio-Komponenten, ein Windows SDK und eine Xbox im Entwicklermodus.
Für die Entwicklungsumgebung benötigt ihr:
- Ein Windows-System, das von der gewählten Visual-Studio-Version unterstützt wird.
- Visual Studio mit UWP-Werkzeugen. Bei neueren Installern findet ihr diese als zusätzliche Komponenten; der frühere Workloadname ist nicht überall unverändert.
- Ein Windows SDK, das zum Ziel-SDK eures Projekts passt.
Für eine neue Installation gelten die Systemanforderungen der gewählten Visual-Studio-Version und ihrer Komponenten.
Einrichten des Windows 10 SDK
Prüft in den Projekteigenschaften, welche Windows-SDK-Version als Ziel eingetragen ist. Installiert die benötigte Version über den Visual Studio Installer oder die Windows-SDK-Downloads. Eine Änderung des Ziel-SDKs kann Anpassungen am Projekt erfordern; prüft anschließend Build und Bereitstellung.
Einrichten von Visual Studio
Wählt im Visual Studio Installer die für UWP benötigten Werkzeuge aus. Microsoft ersetzte die frühere Workload Universal Windows Platform development in Visual Studio 17.10 durch Windows application development. Die UWP-Werkzeuge sind zusätzliche Komponenten; für C++ benötigt ihr auch die C++-UWP-Werkzeuge. Die Änderung beschreibt Microsoft im Visual-Studio-Blog. Wählt für die Xbox-Anleitung weiterhin ein UWP-Projekt, keine WinUI-3-Desktopvorlage.
Die Konsole mittels Pin an Visual Studio koppeln
- Verbindet PC und Xbox mit demselben lokalen Netzwerk. Die Konsole muss im Entwicklermodus laufen; meldet dort einen Benutzer an.
- Öffnet euer UWP-Projekt und wählt die Plattform x64 sowie die Konfiguration Debug.
- Wählt in den Debugging-Einstellungen Remote Machine und gebt die IP-Adresse der Xbox ein. Falls die automatische Suche nichts findet, verwendet die in Dev Home angezeigte Adresse.
- Für den Xbox-UWP-Workflow dokumentiert Microsoft Universal (Unencrypted Protocol) als Authentifizierungsmodus. Verwendet diesen unverschlüsselten Debugging-Zugang nur in einem vertrauenswürdigen lokalen Netzwerk. Erlaubt Visual Studio in der Firewall für dieses Netzwerk den erforderlichen Zugriff.
- Speichert die Einstellungen und drückt F5. Visual Studio baut das Projekt, stellt es bereit und startet es mit Debugger. Bei der ersten Verbindung fordert Visual Studio die Kopplungs-PIN an.
Öffnet auf der Xbox in Dev Home den Bereich Quick Actions und wählt Show Visual Studio pin.
Gebt die auf der Xbox angezeigte PIN in den Kopplungsdialog von Visual Studio ein.
Bereitstellungsfehler werden im Fenster Ausgabe angezeigt. Microsoft beschreibt den Ablauf in der Xbox-UWP-Einrichtung; Hinweise zum Verbindungsaufbau stehen unter Remote-Debugging von UWP-Apps.
Nach erfolgreicher Kopplung könnt ihr weitere Änderungen aus Visual Studio auf der Xbox testen.
Häufige Fragen:
Q:Meine Xbox wird nicht im Netzwerk gefunden?
A:Überprüfe ob sie im selben Netzwerk ist, Windows die Netzwerkfreigabe erteilt hat und ob die Firewall Visual Studio durchlässt.
Q:Er verlangt Windows 10 Mobile Installationen, ist das richtig?
A:Dann hast du einfach auf Device umgestellt, statt Remote Computer.
Q:DEP3308: Das Bereitstellungsziel „192.168.177.54“ unterstützt keine Projekte mit „X86“ als Zielplattform. Unterstützte Plattformen: X64.
A:Ganz einfach, beim Ausführen ist er auf eine X86 Platform ausgestellt, die Xbox ist aber nicht 32 sondern 64 bit.
Q:Mein Pin geht nicht und jedes mal wechselt er auf der Xbox.
A:Ruft „Show Visual Studio pin“ erneut auf und verwendet die aktuell angezeigte PIN. Achtet darauf, dass Visual Studio mit der richtigen Xbox verbunden ist.