Getting started with UWP app development on Xbox One

Carefully follow these steps to successfully set up your PC and Xbox One for Universal Windows Platform (UWP) development. After you’ve got things set up, you can learn more about Developer Mode on Xbox One and building UWP apps on the UWP for Xbox One page.

Before you start

Before you start you will need to do the following:

  • Set up a PC with Windows 10.
  • Install Microsoft Visual Studio 2015 Update 3.
  • Have at least five gigabytes of free space on your Xbox One console.

Setting up your development PC

  1. Install Visual Studio 2015 Update. Make sure that you choose Custom install and select the Universal Windows App Development Tools check box – it's not part of the default install. If you are a C++ developer, make sure that you choose Custom install and select C++. For more information, see Development environment setup.

  2. Install the latest Windows 10 SDK. You can get this from https://developer.microsoft.com/windows/downloads/windows-10-sdk.

  3. Enable Developer Mode for your development PC (Settings / Update & security / For developers / Developer mode).

Now that your development PC is ready, you can watch this video or continue reading to see how to set up your Xbox One for development and create and deploy a UWP app to it.

Setting up your Xbox One console

  1. Activate Developer Mode on your Xbox One. Download the app, get the activation code, and then enter it into the xboxactivate page in your Dev Center account. For more information, see Enabling Developer Mode on Xbox One.

  2. Go into the Dev Mode Activation app and select Switch and restart. Congratulations, you now have an Xbox One in Developer Mode!

    Note

    Your retail games and apps won’t run in Developer Mode, but the apps or games you create will. Switch back to Retail Mode to run your favorite games and apps.

    Note

    Before you can deploy an app to your Xbox One in Developer Mode, you must have a user signed in on the console. You can either use your existing Xbox Live account or create a new account for your console in Developer Mode.

Creating your first project in Visual Studio 2015

For more detailed information, see Development environment setup.

  1. For C#: Create a new Universal Windows project, go into the project properties and select the Debug tab, change Target device to Remote Machine, type the IP address or hostname of your Xbox One console into the Remote machine field, and select Universal (Unencrypted Protocol) in the Authentication Mode drop-down list.

    You can find your Xbox One IP address by starting Dev Home on your console (the big tile on the right side of Home) and looking at the top left corner. For more information about Dev Home, see Introduction to Xbox One tools.

  2. For C++ and HTML/Javascript projects: You follow a similar path, but in project properties go to the Debugging tab, select Remote Machine in the Debugger to open the drop-down list, type the IP address or hostname of the console into the Machine Name field, and select Universal (Unencrypted Protocol) in the Authentication Type field.

  3. When you press F5, your app will build and start to deploy on your Xbox One.

  4. The first time you do this, Visual Studio will prompt you for a PIN for your Xbox One. You can get a PIN by starting Dev Home on your Xbox One and selecting the Pair with Visual Studio button.

  5. After you have paired, your app will start to deploy. The first time you do this it might be a bit slow (we have to copy all the tools over to your Xbox), but if it takes more than a few minutes, something is probably wrong. Make sure that you have followed all of the steps above (particularly, did you set the Authentication Mode to Universal?) and that you are using a wired network connection to your Xbox One.

  6. Sit back and relax. Enjoy your first app running on the console!

That's it!

Hello World

See also