Introduzione all'emulatore di Surface DuoGet started with the Surface Duo emulator

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.

Con l'immagine di Surface Duo e l'emulatore Android puoi testare un'app senza accedere a un dispositivo fisico.With the Surface Duo image and the Android Emulator you can test your app without access to a physical device. L'emulatore simula le posture, i movimenti, l'angolo della cerniera, la giunzione tra i due schermi e altro ancora.The emulator simulates postures, gestures, hinge angle, mimicking the seam between the two screens, and more. Continueremo ad aggiungere funzionalità nel tempo.We'll continue to add functionality over time.

Se gli strumenti non sono ancora stati installati, vedere Get the Surface Duo emulator (Scaricare l'emulatore Surface Duo).See Get the Surface Duo emulator if you don't yet have the tools installed.

Come eseguire il debug dell'app nell'emulatoreHow to debug your app on the emulator

  • Apri il progetto in Android Studio.Open your project in Android Studio.
  • Compila il progetto: scegli Build > Make Project (Compila > Crea progetto) oppure premi CTRL+F9.Build your project: Build > Make Project or Ctrl+F9.
  • Selezionare " Microsoft SurfaceDuoEmulator API 29 " dall'elenco dei dispositivi in esecuzione.Select " Microsoft SurfaceDuoEmulator API 29 " from the list of running devices.
  • Esegui il progetto per distribuirlo nell'emulatore: scegli Run > Run " nome progetto " (Esegui > Esegui) oppure premi MAIUSC+F10.Run your project to deploy it to the emulator: Run > Run ' project name ' or Shift+F10.
  • Per arrestare il debug, scegli Run > Stop " nome progetto " (Esegui > Arresta) oppure premi CTRL+F2.To stop debugging: Run > Stop ' project name ' or Ctrl+F2.

È anche possibile eseguire il debug usando ADB.You can also debug using ADB. Gli utenti di Visual Studio devono fare riferimento alle istruzioni di Xamarin relative all'emulatore.Visual Studio users should refer to the Xamarin instructions for the emulator.

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

Per estendere l'app nell'emulatore, trascina l'app dalla barra bianca nella parte inferiore della schermata verso il centro del dispositivo.To span your app in the emulator, drag the app from the white bar at the bottom of the app screen towards the middle of the device. Quando lo sfondo diventa bianco su entrambi gli schermi, rilascia l'app.When the background turns white across both screens, release the app.

Passaggi per estendere un'app nell'emulatore di Surface Duo

Ruotare l'app nell'emulatoreRotate your app in the emulator

È possibile ruotare l'emulatore usando questi pulsanti nella casella degli strumenti dell'emulatore. In alternativa, è possibile usare i tasti di scelta rapida CTRL+freccia sinistra e CTRL+freccia destra :You can rotate the emulator using these buttons in the emulator toolbox, or use Control+Left arrow and Control+Right arrow keyboard shortcuts:

Ruotare i pulsanti negli strumenti dell'emulatore

Se gli elementi dello schermo non ruotano, verificare che l'opzione Auto-rotate (Ruota automaticamente) sia abilitata.If the screen elements don't rotate, check that Auto-rotate is enabled. È possibile usare Settings > Display > Auto-rotate screen (Impostazioni > Schermo > Ruota automaticamente) o abbassare la barra di stato e verificare che l'opzione Auto-rotate (Ruota automaticamente) sia abilitata (blu):You can use Settings > Display > Auto-rotate screen or pull down from the status bar and ensure the Auto-rotate option is enabled (blue):

Verificare che la rotazione automatica sia abilitata

Spostare, ruotare e visualizzare in anteprima la posizione del dispositivoMove, rotate, and preview the device posture

La versione più recente 2020.1014.2 dell'emulatore supporta la visualizzazione Device Pose (Posizione dispositivo) nella finestra Extended controls (Controlli estesi).The latest version 2020.1014.2 of the emulator supports the Device Pose view in the Extended controls window. Usare i pulsanti di opzione Rotate (Ruota) e Move (Sposta) per visualizzare i dispositivi di scorrimento per la regolazione della posizione del dispositivo. In alternativa, fare clic e trascinare nella finestra di anteprima:Use the Rotate and Move radio buttons to show sliders to adjust the device's position, or click and drag in the preview window:

Finestra di anteprima Posizione dispositivo con dispositivo Surface Duo simulato

È anche possibile usare i pulsanti Rotation (Rotazione) per centrare il dispositivo e impostare la rotazione su 0, 90, 180 o 270 gradi.You can also use the Rotation buttons to center the device and set the rotation to 0, 90, 180, or 270 degrees.

Simulare la modifica dell'angolo della cernieraSimulate the hinge angle changing

La versione più recente 2020.1014.2 dell'emulatore include un dispositivo di scorrimento relativo all'angolo della cerniera.The latest version 2020.1014.2 of the emulator has a hinge angle slider. Accedere al dispositivo di scorrimento nella finestra Extended controls (Controlli estesi), sezione Virtual sensors (Sensori virtuali), scegliendo il pulsante di opzione Fold (Piega):Access the slider in the Extended controls window, Virtual sensors section, by choosing the Fold radio button:

Dispositivo di scorrimento del sensore dell'angolo della cernieraHinge angle sensor slider

Quando l'angolo della cerniera supera i 235 gradi, il dispositivo entra in modalità Flip (Gira) e viene disabilitato uno schermo.When the hinge angle exceeds 235 degrees the device will enter Flip mode and one screen will be turned off.

Simulare diverse posizioni del dispositivoSimulate different device postures

Surface Duo può essere disposto in una serie di posizioni diverse, alcune delle quali avranno effetto sull'app (ad esempio se l'app è estesa, ma il dispositivo viene piegato in modalità tenda o girato e uno schermo è disattivato).The Surface Duo can be placed in a number of different postures, some of which will affect your app (such as if the app is spanned but the device is folded into tent or flip mode, and one screen is turned off).

La versione più recente dell'emulatore (2020.1014.2) include un set di pulsanti che consentono di scegliere velocemente una posizione.The latest version of the emulator (2020.1014.2) has a set of buttons to all you to quickly choose a posture. Accedere a questi pulsanti nella finestra Extended controls (Controlli estesi), sezione Virtual sensors (Sensori virtuali), scegliendo il pulsante di opzione Fold (Piega):Access these buttons in the Extended controls window, Virtual sensors section, by choosing the Fold radio button:

Pulsanti per la modifica della posizioneChange posture buttons

Con questi pulsanti viene impostato un angolo della cerniera specifico.These buttons will set a specific hinge angle. Usare i pulsanti di opzione Rotate (Ruota) e Move (Sposta) per modificare la posizione e l'orientamento del dispositivo, che influiscono anche sul modo in cui viene visualizzata l'app.Use the Rotate and Move radio buttons to adjust the device position and orientation, which also affects how the app displays. È anche possibile modificare la rotazione del dispositivo trascinando l'anteprima della posizione 3D.You can also change the rotation of the device by dragging on the 3D posture preview.

Nome posizionePosture name Intervallo angolo della cerniera *Hinge angle range *
ChiusoClosed 0-22,50 - 22.5
Tenda ^Tent ^ 22,5-107,522.5 - 107.5
SemiapertaHalf-Open 107,5-125107.5 - 125
ApriOpen 125-240125 - 240
Girata ^Flipped ^ 240-360240 - 360

* Questi intervalli riflettono il comportamento dell'anteprima dell'emulatore corrente, ma sono soggetti a modifiche in una versione futura. Per simulare in modo preciso una posizione specifica, usare il dispositivo di scorrimento relativo all'angolo della cerniera.* these ranges reflect the current emulator preview behavior but are subject to change in a future release. To accurately simulate a specific posture use the hinge-angle slider.

^ Le posizioni Tenda e Girata devono presentare un solo schermo attivo. Il secondo schermo viene disabilitato in presenza di angoli superiori a 235 gradi.^ both Tent and Flipped postures should only have one active screen. The second screen is disabled at angles greater than 235 degrees.

Usare la fotocameraUse the camera

Per impostazione predefinita, l'emulatore usa un'immagine da fotocamera "emulata", un po' simile a un'immagine animata.By default, the emulator uses an “emulated” camera image, which looks a bit cartoonish. È invece possibile configurare l'emulatore per il passaggio da una fotocamera collegata al computer, eseguendo prima il comando seguente per ottenere un elenco di fotocamere disponibili:Instead you can configure the emulator to pass through a camera attached to your computer, by first running this command to get a list of available cameras:

PiattaformaPlatform ComandoCommand
WindowsWindows %LOCALAPPDATA%\Android\Sdk\emulator\emulator -webcam-list
MacMac ~/Library/Android/sdk/emulator/emulator -webcam-list
LinuxLinux ~/Android/Sdk/emulator/emulator -webcam-list

I nomi delle fotocamere saranno simili a "webcam0".The camera names will be similar to "webcam0".

Aprire il file config.ini nella directory di installazione dell'emulatore.Open the config.ini file in the emulator's installation directory. I valori predefiniti della fotocamera saranno simili ai seguenti:The default camera values will look similar to this:

 hw.camera.back=virtualscene
 hw.camera.front=emulated

Sostituire una delle fotocamere con il valore restituito da -webcam-list, come la fotocamera anteriore nell'esempio seguente:Change one of the cameras to the value returned from -webcam-list, such as the front camera in this example:

 hw.camera.back=virtualscene
 hw.camera.front=webcam0

Riavviare l'emulatore per rendere effettive le impostazioni della fotocamera aggiornate.Restart the emulator for the updated camera settings to take effect.

Aggiungere file all'emulatoreAdd files to the emulator

È possibile trascinare i tipi di file supportati (ad esempio, immagini) nella finestra dell'emulatore. Tali file verranno copiati nella file system dell'emulatore.You can drag supported file types (such as images) into the emulator window, and they will be copied into the emulator's file system. È anche possibile usare Device File Explorer in Android Studio.You can also use the Device File Explorer in Android Studio.

Se si trascina un file APK compatibile nella finestra dell'emulatore, tale file verrà automaticamente installato e sarà pronto per l'uso.If you drag a compatible APK into the emulator window, it will automatically be installed and ready to use.