Configurare l'ambiente di sviluppo UWP in XboxSet up your UWP on Xbox development environment

L'ambiente di sviluppo UWP (Universal Windows Platform) in Xbox è costituito da un PC di sviluppo connesso a una console Xbox One attraverso una rete locale.The Universal Windows Platform (UWP) on Xbox development environment consists of a development PC connected to an Xbox One console through a local network. Il PC di sviluppo richiede Visual Studio 2015 Update 3, Visual Studio 2017 o Visual Studio 2019.The development PC requires Visual Studio 2015 Update 3, Visual Studio 2017, or Visual Studio 2019. Il PC di sviluppo richiede anche Windows 10, Windows 10 SDK build 14393 o versione successiva e una gamma di strumenti di supporto.The development PC also requires Windows 10, the Windows 10 SDK build 14393 or later, and a range of supporting tools.

Questo articolo descrive i passaggi per configurare e testare l'ambiente di sviluppo.This article covers the steps to set up and test your development environment.

Installazione di Visual StudioVisual Studio setup

  1. Installare Visual Studio 2015 Update 3, Visual Studio 2017 o Visual Studio 2019.Install Visual Studio 2015 Update 3, Visual Studio 2017, or Visual Studio 2019. Per altre informazioni e per l’installazione, vedi Download e strumenti per Windows 10.For more information and to install, see Downloads and tools for Windows 10. Si consiglia di usare la versione più recente di Visual Studio per poter ricevere gli aggiornamenti più recenti per sviluppatori e sicurezza.We recommend that you use the latest version of Visual Studio so that you can receive the latest updates for developers and security.

  2. Se si sta installando Visual Studio 2017 o Visual Studio 2019, assicurarsi di scegliere il carico di lavoro di sviluppo piattaforma UWP (Universal Windows Platform) .If you're installing Visual Studio 2017 or Visual Studio 2019, make sure that you choose the Universal Windows Platform development workload. Se sviluppi in C++, assicurati di selezionare anche la casella di controllo Strumenti della piattaforma UWP (Universal Windows Platform) per C++ nel riquadro Riepilogo di destra, in Sviluppo di app per la piattaforma UWP (Universal Windows Platform) .If you're a C++ developer, make sure that you also select the C++ Universal Windows Platform tools checkbox in the Summary pane on the right, under Universal Windows Platform development. Non fa parte dell'installazione predefinita.It's not part of the default installation.

    Installare Visual Studio 2019

    Se installi Visual Studio 2015 Update 3, verifica che la casella di controllo Strumenti per lo sviluppo di app di Windows universale sia selezionata.If you're installing Visual Studio 2015 Update 3, ensure that the Universal Windows App Development Tools check box is selected.

    Installare Visual Studio 2015 Update 2

Installazione di Windows 10 SDKWindows 10 SDK setup

Installa l'ultima versione di Windows 10 SDK.Install the latest Windows 10 SDK. Viene inclusa con l'installazione di Visual Studio, ma se desideri scaricarla separatamente, vedi Windows 10 SDK.This comes with your Visual Studio installation, but if you want to download it separately, see Windows 10 SDK.

Abilitazione della modalità sviluppatoreEnabling Developer Mode

Prima di poter distribuire le app dal PC di sviluppo, devi abilitare la modalità sviluppatore.Before you can deploy apps from your development PC, you must enable Developer Mode. Nell'app Impostazioni passa a Aggiornamento e sicurezza / Per gli sviluppatori e in Usa le funzionalità per sviluppatori seleziona Modalità sviluppatore.In the Settings app, navigate to Update & Security / For developers, and under Use developer features, select Developer mode.

Configurazione della tua Xbox OneSetting up your Xbox One

Prima di distribuire un'app nella tua Xbox One è necessario che un utente abbia effettuato l'accesso alla console.Before you can deploy an app to your Xbox One, you must have a user signed in on the console. Puoi usare il tuo account Xbox Live esistente oppure creare un nuovo account per la tua console in modalità sviluppatore.You can either use your existing Xbox Live account or create a new account for your console in Developer Mode.

Creare la prima appCreate your first app

  1. Assicurati che il PC di sviluppo si trovi nella stessa rete locale della console Xbox One di destinazione.Make sure your development PC is on the same local network as the target Xbox One console. In genere, questo significa che devono usare lo stesso router e trovarsi nella stessa subnet.Typically, this means they should use the same router and be on the same subnet. È consigliabile una connessione di rete cablata.A wired network connection is recommended.

  2. Verifica che la console Xbox One sia in modalità sviluppatore.Ensure that your Xbox One console is in Developer Mode. Per altre informazioni, vedi Attivazione della modalità sviluppatore per Xbox One.For more information, see Xbox One Developer Mode activation.

  3. Scegli il linguaggio di programmazione da usare per l'app UWP.Decide the programming language that you want to use for your UWP app.

  4. Nel PC di sviluppo, in Visual Studio, seleziona Nuovo/Progetto.On your development PC, in Visual Studio, select New / Project.

  5. Nella finestra Nuovo progetto seleziona Universale di Windows/App vuota (Windows universale) .In the New Project window, select Windows Universal / Blank App (Universal Windows).

Avvio di un progetto C#Starting a C# project

Finestra di dialogo Nuovo progetto

  1. Nella finestra di dialogo Nuovo progetto Windows universale seleziona la build 14393 o successiva nell'elenco a discesa Versione minima.In the New Universal Windows Project dialog, select build 14393 or later in the Minimum Version dropdown. Seleziona l'SDK più recente nell'elenco a discesa Versione di destinazione.Select the latest SDK in the Target Version dropdown. Se viene visualizzata la finestra di dialogo Modalità sviluppatore, fai clic su OK.If the Developer Mode dialog appears, click OK. Verrà creata una nuova app vuota.A new blank app is created.

  2. Configura l'ambiente di sviluppo per il debug remoto:Configure your development environment for remote debugging:

    a.a. In Esplora soluzioni fai clic con il pulsante destro del mouse sul progetto e quindi seleziona Proprietà.Right-click the project in the Solution Explorer, and then select Properties.

    b.b. Nella scheda Debug modifica Piattaforma in x64.On the Debug tab, change Platform to x64. La piattaforma x86 non è più supportata in Xbox.(x86 is no longer a supported platform on Xbox.)

    c.c. In Opzioni di avvio imposta Dispositivo di destinazione su Computer remoto.Under Start options, change Target device to Remote Machine.

    d.d. In Computer remoto immetti il nome host o l'indirizzo IP di sistema della console Xbox One.In Remote machine, enter the system IP address or hostname of the Xbox One console. Per informazioni su come ottenere il nome host o l’indirizzo IP, vedi Introduzione agli strumenti di Xbox One.For information about obtaining the IP address or hostname, see Introduction to Xbox One tools.

    e.e. Nell'elenco a discesa Modalità di autenticazione seleziona Universale (protocollo non crittografato) .In the Authentication Mode drop-down list, select Universal (Unencrypted Protocol).

    Pagine delle proprietà di un'app vuota C#

Avvio di un progetto C++Starting a C++ project

Progetto C++

  1. Nella finestra di dialogo Nuovo progetto Windows universale seleziona la build 14393 o successiva nell'elenco a discesa Versione minima.In the New Universal Windows Project dialog, select build 14393 or later in the Minimum Version dropdown. Seleziona l'SDK più recente nell'elenco a discesa Versione di destinazione.Select the latest SDK in the Target Version dropdown. Se viene visualizzata la finestra di dialogo Modalità sviluppatore, fai clic su OK.If the Developer Mode dialog appears, click OK. Verrà creata una nuova app vuota.A new blank app is created.

  2. Configura l'ambiente di sviluppo per il debug remoto:Configure your development environment for remote debugging:

    a.a. In Esplora soluzioni fai clic con il pulsante destro del mouse sul progetto e quindi seleziona Proprietà.Right-click the project in the Solution Explorer, and then select Properties.

    b.b. Nella scheda Debug imposta Debugger da avviare su Computer remoto.On the Debugging tab, change Debugger to launch to Remote Machine.

    c.c. In Nome computer immetti il nome host o l’indirizzo IP di sistema della console Xbox One.In Machine Name, enter the system IP address or hostname of the Xbox One console. Per informazioni su come ottenere il nome host o l’indirizzo IP, vedi Introduzione agli strumenti di Xbox One.For information about obtaining the IP address or hostname, see Introduction to Xbox One tools.

    d.d. Nell’elenco a discesa Tipo di autenticazione seleziona Universale (protocollo non crittografato) .In the Authentication Type drop-down list, select Universal (Unencrypted Protocol).

    e.e. Nell'elenco a discesa Piattaforma seleziona x64.In the Platform drop-down, select x64.

    Pagine delle proprietà di un'app vuota C++

Associare il dispositivo a Visual Studio con un PINPIN-pair your device with Visual Studio

  1. Salva le impostazioni e verifica che la console Xbox One sia in modalità sviluppatore.Save your settings, and make sure your Xbox One console is in Developer Mode.

  2. Con il progetto aperto in Visual Studio, premi F5.With your project open in Visual Studio, press F5.

  3. Se questa è la prima distribuzione, verrà visualizzata una finestra di dialogo di Visual Studio che chiede di associare il dispositivo usando un PIN.If this is your first deployment, you will get a dialog from Visual Studio asking to PIN-pair your device.

    a.a. Per ottenere un PIN, apri la home page di sviluppo dalla schermata iniziale della console Xbox One.To obtain a PIN, open Dev Home from the Home screen on your Xbox One console.

    b.b. Nella scheda Home, in Azioni rapide seleziona Mostra il pin di Visual Studio.On the Home tab, under Quick actions, select Show Visual Studio pin.

    Finestra di dialogo di associazione a Visual Studio

    c.c. Immetti il PIN nella finestra di dialogo di associazione aVisual Studio.Enter your PIN into the Pair with Visual Studio dialog. Il PIN seguente è solo un esempio. Il tuo sarà diverso.The following PIN is just an example; yours will differ.

    Finestra di dialogo del PIN di associazione a Visual Studio

    d.d. Eventuali errori di distribuzione verranno visualizzati nella finestra Output.Deployment errors, if any, will appear in the Output window.

Complimenti, hai creato e distribuito la tua prima app UWP in Xbox.Congratulations, you've successfully created and deployed your first UWP app on Xbox!

Vedi ancheSee also