Usare l'emulatore di Surface Duo con Visual StudioUse the Surface Duo emulator with Visual Studio

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.

Per compilare app Android con Novell in C# usando Visual Studio, configurare questi strumenti, quindi seguire le istruzioni in questa pagina:To build Android apps with Xamarin in C# using Visual Studio, set up these tools then follow the instructions on this page:

Installare l'anteprima dell'emulatoreInstall the emulator preview

Ottenere il programma di installazione dall'area download Microsoft:Get the installer from the Microsoft Download Center:

Scegliere il pacchetto zip per Windows o il file con estensione DMG per MacOS.Choose the .zip package for Windows or the .dmg for macOS.

Al termine del download, eseguire il programma di installazione.When the download has completed, run the installer.

Il programma di installazione inserisce le icone nel menu Start , all'interno di una cartella SurfaceDuoEmulator .The installer places icons in the Start menu, inside a SurfaceDuoEmulator folder. Usare l'icona con etichetta Surface Duo Emulator per Visual Studio per aprire l'emulatore prima di provare a eseguire la distribuzione in Visual Studio.Use the icon labelled Surface Duo Emulator for Visual Studio to open the emulator before attempting to deploy inside Visual Studio.

Eseguire l'emulatoreRun the emulator

Visual Studio non avvierà automaticamente l'emulatore di Surface Duo, quindi è necessario aprirlo manualmente prima di provare a distribuire o eseguire il debug dell'app Novell.Visual Studio will not automatically start the Surface Duo emulator, so you should manually open it before attempting to deploy or debug your Xamarin app.

Seguire queste istruzioni per avviare l'emulatore, dopo il quale verrà visualizzata come opzione di distribuzione in Visual Studio:Follow these instructions to start the emulator, after which it will appear as a deployment option in Visual Studio:

Dopo aver completato l'installazione dell'SDK, è possibile avviare l' emulatore di Surface Duo per Visual Studio tramite il collegamento del menu Start .After completing the SDK Setup, you can launch the Surface Duo Emulator for Visual Studio via the Start menu link.

Voce del menu Start per l'emulatore di Surface Duo

Nella cartella di installazione è presente un file batch run_vs.bat che è possibile eseguire direttamente.In the installation folder, there is a batch file run_vs.bat which you can execute directly. Esiste anche un file di run_vs_clean.bat che avvierà l'emulatore in uno stato aggiornato, anziché continuare con una sessione precedente.There is also a run_vs_clean.bat file which will start the emulator in a fresh state (rather than continue a previous session).

Se l'emulatore non viene avviato, potresti dover aggiornare il puntatore in base al percorso di installazione di Android SDK.If the emulator does not start, you might need to update the pointer to your Android SDK installation.

Nota

La cartella di installazione contiene gli script di avvio denominati Run e run_vs.The installation folder contains start-up scripts named run and run_vs. Gli script di esecuzione sono destinati agli sviluppatori che usano Android Studio e gli script di run_vs sono per gli utenti di Visual Studio .The run scripts are intended for developers using Android Studio and the run_vs scripts are for Visual Studio users. Le differenze sono la posizione Android SDK e la porta usata per l'emulatore.The differences are the Android SDK location and the port used for the emulator.

Se l'emulatore è in esecuzione ma non viene visualizzato come opzione di distribuzione in Visual Studio, chiudere l'emulatore e riavviare, confermando che si sta usando lo script con vs nel nome.If the emulator is running but does not appear as a deployment option in Visual Studio, close the emulator and re-start, confirming that you are using the script with vs in the name.

Debug dell'app per Xamarin AndroidDebugging your Xamarin Android App

Apri il progetto in Visual Studio, compilalo, seleziona <build> (Android 10.0 - API 29) (nell'elenco dei dispositivi in esecuzione) e procedi alla distribuzione.Open your Project in Visual Studio, build it, and select <build> (Android 10.0 - API 29) (in the list of Running Devices) and deploy.

Il debug (punti di interruzione, Esegui istruzione, Esegui istruzione/routine e così via) funzionerà come di consueto.Debugging (breakpoints, step into, step over, etc) will all work as usual.

Risoluzione dei problemiTroubleshooting

Aggiornare il puntatore ad Android SDKUpdate the pointer to your Android SDK

Se hai modificato il percorso di installazione predefinito di Android SDK, devi aggiornare lo script run_vs in modo da puntare al percorso di installazione corretto.If you changed the installation location of the Android SDK from the default, you will need to update the run_vs script to point to the correct installation location. In caso contrario, quando fai clic sul collegamento o esegui lo script, l'emulatore non viene eseguito.Otherwise, the emulator will not run when you click the shortcut or run the script.

  1. Trova il percorso di installazione dell'emulatore di Surface Duo.Find the installation location of the Surface Duo Emulator. Il percorso predefinito è %USERPROFILE%\SurfaceDuoEmulator.The default location is %USERPROFILE%\SurfaceDuoEmulator.
  2. Apri la cartella artifacts all'interno della cartella di installazione.Open the artifacts folder inside of the installation folder.
  3. Crea una copia di backup di run_vs.bat: puoi copiarla in un file come run_vs_original.bat.Make a backup copy of run_vs.bat - You can copy it to something like run_vs_original.bat.
  4. Apri il file run_vs.bat in un editor di testo.Open the file run_vs.bat in a text editor.
  5. Verifica che il valore del percorso ANDROID_SDK_LOCATION vicino alla parte superiore del file sia corretto.Verify the ANDROID_SDK_LOCATION path value near the top of the file is correct.
rem ##### ENSURE THE SDK LOCATION BELOW IS CORRECT: #######
set ANDROID_SDK_LOCATION=C:\Program Files (x86)\Android\android-sdk