Usare l'emulatore MicrosoftUse the Microsoft Emulator

Importante

Recentemente sono state annunciate alcune modifiche apportate alla priorità per Windows 10 e Windows 10X.We recently announced some changes in the prioritization for Windows 10 and Windows 10X. Questi annunci includono modifiche alle priorità del fattore di forma di Windows 10X.These announcements include changes to the Windows 10X form factor priorities. Altre informazioni sono disponibili qui.Read more here.

Importante

Questi articolo descrive le funzionalità e il materiale sussidiario disponibili nell'anteprima pubblica, che potrebbero tuttavia subire modifiche sostanziali prima del rilascio della versione disponibile a livello generale.This article describes functionality and guidance that is in public preview and may be substantially modified before it's generally available. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.Microsoft makes no warranties, express or implied, with respect to the information provided here.

Usare l'emulatore Microsoft con l'anteprima dell'emulatore Windows 10X per testare l'app senza un dispositivo fisico.Use the Microsoft Emulator with the Windows 10X Emulator Image Preview to test your app without a physical device. L'emulatore è integrato nell'ambiente di sviluppo e simula posture, movimenti, angolo di cerniera, imitando il Seam tra le due schermate e altro ancora.The emulator is integrated into your development environment and simulates postures, gestures, hinge angle, mimicking the seam between the two screens, and more.

Modi per eseguire il debug dell'appWays to debug your app

Questo documento illustra come configurare per l'esecuzione e il debug di applicazioni usando l'emulatore Microsoft.This document explains how you can get set up to run and debug applications using the Microsoft Emulator.

La superficie neo e altri dispositivi Windows 10X sono dispositivi "da sviluppare a", vale a dire che si svilupperà sul PC desktop e quindi si effettuerà la distribuzione nel dispositivo.The Surface Neo and other Windows 10X devices are "develop-to" devices, meaning that you will develop on your desktop PC and then deploy to the device. Per eseguire questa operazione, è possibile usare l'emulatore o il debug remoto.You have two options for doing this: using the emulator, or using remote debugging. Questo documento illustra l'emulatore.This document discusses the emulator.

Per ulteriori informazioni sul debug remoto, vedere Remote Debugging nella documentazione di Visual Studio.For more information on remote debugging, see Remote Debugging in the Visual Studio documentation. Alla fine di questo documento è disponibile anche un breve elenco di suggerimenti per il debug remoto di app eseguite nel contenitore Win32.There is also a short list of tips at the end of this document for remote debugging of apps that run in the Win32 container.

Per informazioni sul portale del dispositivo Windows, che fornisce molte funzionalità di debug utili, vedere Panoramica del portale per dispositivi Windows.For information on the Window Device Portal, which provides many useful debugging features, see Windows Device Portal overview.

Informazioni sull'emulatoreAbout the emulator

Microsoft Emulator Preview consente di testare le app nel PC senza usare un dispositivo Windows 10X fisico.The Microsoft Emulator preview lets you test apps on your PC without using a physical Windows 10X device. L'emulatore si integra con Visual Studio e diventa un dispositivo di destinazione per il debug.The emulator integrates with Visual Studio and becomes a target device for debugging. Quando si esegue l'app da Visual Studio, l'emulatore viene avviato e l'app viene distribuita.When you run your app from Visual Studio, the emulator starts and your app is deployed to it.

Barra degli strumenti dell'emulatoreEmulator toolbar

Nell'emulatore sono disponibili pulsanti di alimentazione e volume che funzionano.The emulator has volume and power buttons that work. I pulsanti del volume controlleranno l'output audio.The volume buttons will control the audio output. Il pulsante di alimentazione consente di rieseguire il ciclo del sistema operativo senza riavviare l'emulatore.The power button lets you re-cycle the OS without restarting the emulator.

La barra degli strumenti dell'emulatore consente di scegliere le varie modalità di input supportate dal dispositivo: mouse, tocco, multitocco e input penna.The emulator toolbar lets you to choose the various input modes supported by the device – mouse, touch, multi-touch, and ink. È possibile utilizzare la barra degli strumenti per modificare rapidamente l'orientamento dell'emulatore.You can use the toolbar to quickly change the orientation of the emulator.

Barra degli strumenti dell'emulatore Microsoft

Strumenti aggiuntiviAdditional tools

La freccia di espansione nella parte inferiore della barra degli strumenti apre la finestra strumenti aggiuntivi.The chevron at the bottom of the toolbar opens the Additional Tools window. Questa finestra contiene le schede che forniscono supporto per le varie funzionalità dell'emulatore.This window contains tabs that provide support for various features of the emulator.

DiagnosticaDiagnostics

La scheda diagnostica fornisce l'indirizzo IP da usare per il portale del dispositivo Windows.The Diagnostics tab provides the IP address to use for the Windows Device Portal. È possibile fare clic sul collegamento ipertestuale indirizzo IP per avviarlo.You can click the IP address hyperlink to launch it. Questa scheda indica anche se l'emulatore rileva una GPU virtuale.This tab also indicates whether or not the emulator detects a virtual GPU.

Scheda diagnostica strumenti aggiuntivi

ReteNetwork

La scheda rete fornisce la configurazione di rete, utile per la diagnosi dei problemi di connessione.The Network tab provides the networking configuration, which is useful when diagnosing connection problems.

Scheda rete strumenti aggiuntivi

OrientamentoOrientation

La scheda orientamento fornisce un modello 3D che consente di visualizzare il comportamento dell'app e del sistema operativo in molti orientamenti diversi.The Orientation tab provides a 3D model for you to see how your app and the OS behaves in many different orientations.

Scheda orientamento strumenti aggiuntivi

SchermataScreenshot

La scheda screenshot consente di scattare facilmente una schermata e di salvarla nel computer host.The Screenshot tab lets you easily take a screen shot and save it to the host machine.

Scheda screenshot strumenti aggiuntivi

Gestione emulatori MicrosoftMicrosoft Emulator Manager

Gestione emulatori è uno strumento per sviluppatori che elenca tutti gli emulatori Microsoft installati nel computer.The Emulator Manager is a developer tool that lists all the Microsoft Emulators installed on your machine. Consente di visualizzare lo stato e avviare un determinato emulatore indipendentemente da Visual Studio.It allows you to see their status, and start a given emulator independent of Visual Studio. È possibile avviare Gestione emulatori dalla voce dell' emulatore Microsoft nel menu Start.You can start the Emulator Manager from the Microsoft Emulator entry in the Start menu.

Scheda rete strumenti aggiuntivi

È anche possibile configurare diverse impostazioni per un emulatore.You can also configure various settings for an emulator. Fare clic sul pulsante modifica nella voce dell'immagine dell'emulatore selezionata per aprire la finestra modifica dispositivo emulatore .Click the Edit button on the selected emulator image entry to open the Edit Emulator Device window. Per Windows 10X, le immagini sono preconfigurate per l'uso di 4 GB di RAM.For Windows 10X, the images are pre-configured to use 4GB of ram. Per migliorare la velocità di risposta dell'emulatore, è consigliabile aumentare questo aspetto con la memoria consentita.To improve the responsiveness of the emulator, we recommend increasing this as your memory allows.

Scheda rete strumenti aggiuntivi

Disinstallare l'emulatore e le immaginiUninstall the emulator and images

Ogni immagine dell'emulatore è di diversi gigabyte.Each emulator image is several gigabytes. Se è necessario liberare spazio su disco, è possibile disinstallare le immagini scaricate nell'app impostazioni in app.If you need to free up disk space, you can uninstall downloaded images in the Settings app, under Apps. Trovare l'emulatore Microsoft nell'elenco di app e fare clic su Opzioni avanzate.Find Microsoft Emulator in the app list and click Advanced Options.

elenco delle app dell'emulatore in impostazioni

Nella parte inferiore della pagina Opzioni avanzate sono disponibili le immagini dell'emulatore.At the bottom of this advanced options page, you'll find your emulator images. È sufficiente fare clic su "Disinstalla" in un'immagine per rimuoverla.Just click "Uninstall" under an image to remove it.

pacchetti facoltativi elencati nell'app Emulator

Eseguire il debug di app UWPDebug UWP apps

Visual Studio 2019 16,5 o versione successivaVisual Studio 2019 16.5 or later

Dopo aver installato l'immagine dell'emulatore Microsoft emulatore e Windows 10X, la versione più recente di Visual Studio 2019 (versione 16,5 o successiva) riconosce che l'emulatore è installato.After you've installed the Microsoft Emulator and Windows 10X Emulator Image, the latest Visual Studio 2019 (version 16.5 or later) recognizes that the emulator is installed. È possibile scegliere la destinazione dal menu a discesa destinazione di debug .You can target it from the Debugging target drop down menu. Visual Studio distribuirà quindi l'app nell'emulatore, la avvierà e collegherà un debugger.Visual Studio will then deploy the app to the emulator, launch it, and attach a debugger.

Elenco a discesa destinazione di debug di Visual Studio che mostra la destinazione dell'emulatore

Versioni precedenti di Visual Studio 2008Earlier versions of Visual Studio

Se si usa Visual Studio 2017 o 2019 (versione 16,4 o precedente), selezionare l'immagine dell'emulatore in Gestione emulatori Microsoft, fare clic sul pulsante "Aggiungi integrazione di Visual Studio", quindi riavviare Visual Studio.If you're using Visual Studio 2017 or 2019 (version 16.4 or earlier), select the emulator image in Microsoft Emulator Manager, click the "Add Visual Studio Integration" button, then restart Visual Studio. Per eseguire questa operazione, sono necessari i diritti di amministratore.You'll need admin rights to do this. In caso di problemi con l'elenco a discesa dell'emulatore in Visual Studio che non si comporta come previsto, provare a deselezionare l'elenco a discesa dal menu strumenti in Gestione emulatori.If you have trouble with the emulator drop-down in Visual Studio not behaving as expected, try clearing the drop-down from the Tools menu in Emulator Manager.

È anche possibile usare l'emulatore come destinazione come dispositivo remoto.You can also target the emulator by targeting it as a remote device. Questa configurazione è descritta in dettaglio nella sezione app in pacchetto di MSIX .This configuration is detailed in the MSIX packaged apps section.

Eseguire il debug di app Win32Debug Win32 apps

App in pacchetto MSIXMSIX packaged apps

La soluzione consigliata per lo sviluppo di app Win32 in Windows 10X è il formato di creazione di pacchetti MSIX, che consente di eseguire il debug e la distribuzione delle app in modo semplice.The recommended solution for developing Win32 apps on Windows 10X is the MSIX packaging format, which makes it easy to both debug and distribute your apps. I pacchetti MSIX supportano le stesse lingue già utilizzate in Visual Studio, tra cui C#, C++ e Visual Basic.MSIX packages support the same languages you already work with in Visual Studio, including C#, C++, and Visual Basic. Per ulteriori informazioni sul formato MSIX Packaging, vedere la documentazione di MSIX.For more info about the MSIX packaging format, see the MSIX documentation.

Per eseguire il debug di applicazioni distribuite con il progetto di creazione pacchetti di applicazioni Windows, è necessario considerare l'emulatore come destinazione di debug remoto.To debug applications deployed with the Windows Application Packaging project, you will need to treat the emulator as a remote debugging target.

  • Per prima cosa, ottenere l'indirizzo IP da Gestione emulatori.First, get the IP Address from the Emulator Manager. È possibile selezionarlo e copiarlo come testo normale dall'app.You can select and copy this as normal text from the app.

Gestione emulatori che Visualizza l'indirizzo IP per l'emulatore

  • Nelle proprietà del progetto del pacchetto:In the Project Properties of the packaging project:
    • Trovare la sezione "opzioni di avvio" nella scheda debug.Find the "Start options" section on the Debug tab.
    • Impostare il dispositivo di destinazione su computer remoto.Set the Target device to Remote Machine.
    • Immettere l'indirizzo IP dell'emulatore.Enter the IP address of the emulator.
    • Impostare la modalità di autenticazione su universale.Set the Authentication Mode to Universal.

creazione del pacchetto di proprietà del progetto che mostrano le 3 impostazioni

  • Premere F5 per distribuire l'applicazione in un emulatore in esecuzione e associare il debug senza ulteriori passaggi.Press F5 to deploy the application to a running emulator and hook up debugging without additional steps.

App non in pacchettoNon-packaged apps

Se si sta eseguendo il debug di un'app che non usa la creazione di pacchetti MSIX, è necessario usare il Visual Studio Remote Debugger.If you're debugging an app that doesn't use MSIX packaging, you need to use the Visual Studio Remote Debugger. Per informazioni e collegamenti per il download, vedere la pagina debug remoto .For info and download links, see the Remote Debugging page. Assicurarsi di usare il debugger remoto corretto per la versione di Visual Studio.Make sure to use the right remote debugger for your version of Visual Studio. Il debugger deve essere installato nell' emulatoree non nel computer di sviluppo.The debugger needs to be installed in the emulator, not on your development machine.

Dopo aver installato il debugger in Windows 10, avviarlo dal menu Start.Once you've installed the debugger in Windows 10X, launch it from the Start menu. In strumenti > opzioni selezionare Nessuna autenticazione e selezionare la casella accanto a Consenti a qualsiasi utente di eseguire il debug.Under Tools > Options, select No Authentication and check the box next to Allow any user to debug.

Proprietà del debugger remoto che mostrano la configurazione anonima

È anche necessario configurare Windows 10X per consentire l'esecuzione di applicazioni non attendibili nel contenitore Win32.You also need to configure Windows 10X to allow untrusted applications to run in the Win32 container. Questa impostazione è in app.This setting is under Apps. Modificare l'elenco a discesa in scegliere le app da installare da app verificate e attendibili a tutte le app (scelta non consigliata).Change the dropdown under Choose which apps to install from Verified and reputable apps to All apps (not recommended).

progetti C++C++ projects

I progetti C++ non in pacchetto devono usare la funzionalità di debug remoto incorporata nel sistema del progetto C++ di Visual Studio.Non-packaged C++ projects should use the remote debugging feature built into the Visual Studio C++ project system. Questa configurazione è supportata in Visual Studio 2017 e 2019.This config is supported on both Visual Studio 2017 and 2019.

  • Avviare l'emulatore e aprire il portale del dispositivo Windows (WDP).Launch the emulator and open Windows Device Portal (WDP). Il collegamento per avviare WDP si trova nella scheda diagnostica della finestra strumenti aggiuntivi dell'emulatore.The link to launch WDP is in the Diagnostics tab of the emulator's Additional Tools window.

  • Selezionare Esplora file dal menu di navigazione in WDP.Select File explorer from the navigation menu in WDP.

  • Fare clic sulla cartella denominata DevelopmentFiles.Click the folder named DevelopmentFiles. Qui viene distribuito il progetto per il debug.This is where your project is deployed for debugging.

  • In percorso directoryverrà visualizzato il percorso completo della cartella.Under Directory path, you'll see the full path of this folder. Copiare e incollare questo valore.Copy and paste this value.

    WDP che Visualizza il percorso completo della directory

  • Nella soluzione fare clic con il pulsante destro del mouse sul progetto C++ e scegliere Proprietà.In your solution, right-click your C++ project and select Properties.

  • Nella sezione debug impostare la directory di lavoro e la directory di distribuzione sul percorso copiato da WDP.Under the Debugging section, set both Working Directory and Deployment Directory to the path you copied from WDP.

  • Impostare comando remoto su questo percorso, più il nome del file eseguibile.Set Remote Command to this path, plus the name of your executable.

  • Impostare nome server remoto sull'indirizzo IP dell'emulatore in esecuzione.Set Remote Server Name to the IP address of the running emulator.

La configurazione dovrebbe essere simile all'esempio seguente:Your configuration should look similar to this example:

esempio di configurazione di debug c++

  • In generazione codice C/C++ > Code Generationimpostare libreria di runtime su debug multithread (/MTD).Under C/C++ > Code Generation, set Runtime Library to Multi-threaded Debug (/MTd).
  • Premere F5 per distribuire il progetto nel debugger remoto.Press F5 to deploy your project to the remote debugger.
    Non verrà visualizzata un'icona del menu Start per l'app.(You won't see a Start menu icon for your app. Quando l'app dispone di un programma di installazione, verrà creata un'icona di avvio quando l'app viene installata normalmente.Once your app has an installer, a Start icon will be created when the app is installed normally.)

Progetti .NET.NET projects

Il supporto per i progetti .NET non in pacchetto sarà presto disponibile.Support for non-packaged .NET projects is coming soon. Verificarne con regolarità il contenuto.Stay tuned!

SuggerimentiTips

  • Lasciare l'emulatore operativo per evitare il riavvio.Leave the emulator up and running to avoid restart. L'anteprima dell'emulatore richiede un po' di tempo per l'avvio in un computer di classe desktop.The emulator preview takes a while to start on a desktop class machine.
  • Usare il portale per dispositivi Windows dell'emulatore per:Use the emulator's Windows Device Portal to:
    • Distribuire il contenuto nelle librerie e in LocalAppData.Deploy content to your libraries and LocalAppData.
    • Gestire i processi in esecuzione.Manage running processes.
    • App di debug remoto nei contenitori Win32.Remote debug apps in Win32 containers.
  • È possibile usare il pulsante di alimentazione per "riavviare" più velocemente rispetto al riavvio dell'emulatore e non si perderà lo stato, ad esempio gli elementi installati nell'emulatore.You can use the power button to "reboot" faster than restarting the emulator and you won't lose your state, such as things you've installed inside the emulator.
  • Gli aggiornamenti di VisualStudio possono perdere l'emulatore: per ripristinarlo, eliminare la cache di Corecon nella cartella di dati dell'app locale di Visual Studio ( C:\Users\<user>\AppData\Local\Microsoft\VisualStudio\{ad75a28f}\CoreCon ).VisualStudio updates can lose the emulator – to restore it, delete the CoreCon cache in Visual Studio's local app data folder (C:\Users\<user>\AppData\Local\Microsoft\VisualStudio\{ad75a28f}\CoreCon).

Estendere l'app nell'emulatoreSpan your app in the emulator

Per estendere l'app nell'emulatore, trascinare l'app dalla barra del titolo nella parte superiore della schermata dell'app verso la metà del dispositivo.To span your app in the emulator, drag the app from the title bar at the top of the app screen towards the middle of the device. Quando lo sfondo risulta sfocato in entrambe le schermate, rilasciare l'app.When the background turns blurred across both screens, release the app.

Passaggi per estendere un'app nell'emulatore

Invio di bug e commentiSubmitting bugs and feedback

Sono necessari commenti e suggerimenti.We need your feedback! Se si verificano bug in Windows 10X durante il test delle app, inviare commenti e suggerimenti dall'hub feedback nell'emulatore.If you run into bugs in Windows 10X while testing your apps, please file feedback from Feedback Hub in the emulator. In questo modo vengono raccolti i log appropriati e altri dati di risoluzione dei problemi.This will ensure the appropriate logs and other troubleshooting data is collected. Se non è possibile inviare commenti e suggerimenti direttamente da Windows 10, è sufficiente consultare il menu? in Gestione emulatori per passare all'hub feedback nel PC Windows 10 desktop.If you can't submit feedback directly from Windows 10X, just look under the Help menu in the emulator manager to jump to Feedback Hub on your Windows 10 desktop PC.

Nota

L'immagine dell'emulatore Microsoft e dell'emulatore Windows 10X viene fornita come anteprima pubblica.The Microsoft Emulator and Windows 10X Emulator image are being provided as a public preview. Si tratta di una versione preliminare degli strumenti di sviluppo per fornire agli sviluppatori l'accesso per creare, testare, eseguire il debug e migliorare le applicazioni per Windows 10 e concentrarsi sui commenti e suggerimenti in queste aree verrà assegnato un ordine di priorità.This is an early release of the developer tools geared towards providing developers access to build, test, debug, and enhance their applications for Windows 10X and focus on feedback in these areas will be prioritized.