Scaricare e installare l'emulatore Surface Duo per AndroidDownload and install the Surface Duo Android 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.

L'immagine di anteprima dell'emulatore Surface Duo (utilizzabile con l'emulatore Android) può essere usata per sviluppare e testare le app.The Surface Duo emulator preview image (to use with the Android Emulator) can be used to develop and test your apps.

Configurare l'ambiente di sviluppo di Surface DuoSet up the Surface Duo development environment

Prima di installare Surface Duo SDK, l'ambiente di sviluppo Android deve essere configurato e aggiornato.You should have your Android development environment set-up and up to date before you install the Surface Duo SDK. Se non hai installato Android Studio, scarica la versione più recente e gli strumenti della riga di comando da developer.android.com.If you don't have Android Studio installed, download the latest version and Command line tools from developer.android.com. Devi includere l'emulatore Android di Google, da installare usando SDK Manager disponibile nel menu Tools di Android Studio.You must include Google's Android emulator which you install using the SDK manager in the Android Studio Tools menu. Per le nuove installazioni, le opzioni predefinite eseguiranno questa operazione automaticamente.For new installs, the default options will do this automatically.

Prerequisiti di Surface Duo SDK PreviewSurface Duo SDK preview prerequisites

  • Usa Gestione SDK per assicurarti che tutti gli strumenti di sviluppo necessari (strumenti di compilazione di Android SDK, strumenti della piattaforma di Android SDK e l'emulatore Android) siano aggiornati.Use the SDK manager to ensure all the required dev tools (Android SDK Build-Tools, Android SDK Platform-Tools, and Android Emulator) are up to date.

    SDK Manager

  • (Facoltativo) Verifica che la virtualizzazione hardware sia abilitata.(Optional) Hardware virtualization is enabled. Per una procedura di emulazione rapida, segui le linee guida descritte nell'argomento sull'accelerazione dell'emulatore nella documentazione di Android Studio.For speedy emulation, follow the guidelines outlined in emulator acceleration in the Android Studio docs.

Microsoft Visual Studio/XamarinMicrosoft Visual Studio/Xamarin

Ubuntu/DebianUbuntu/Debian

  • Completa i prerequisiti di installazione.Complete the installation prerequisites.

  • Il pacchetto software KVM è obbligatorio.The KVM software package is required. Completa la procedura descritta in Configure VM acceleration on Linux (Configurare l'accelerazione della macchina virtuale in Linux) per installare KVM.Complete the steps at Configure VM acceleration on Linux to install KVM.

    • Dopo l'installazione di KVM, assicurati che l'utente corrente (connesso) venga aggiunto al gruppo KVM.After installing KVM, ensure the current (logged in) user is added to the KVM group.

      $ groups
      <current user> sudo plugdev kvm libvirt
      
    • Se l'utente corrente non è presente nel gruppo KVM, esegui il comando seguente per aggiungerlo.If the current user is not in the KVM group, run the following command to add them.

      sudo usermod -a -G kvm <current user>
      
    • Riavvia il computer.Reboot the machine.

  • Per installare l'emulatore e l'SDK, esegui il comando seguente.To install the emulator and SDK, run the following command. Se necessario, aggiorna il nome del pacchetto in modo che corrisponda a quello scaricato.(If necessary, update the package name to match what you downloaded).

    sudo dpkg -i SurfaceDuoSDKPreview_EmulatorOSImage_and_APIs_ubuntu_debian_2020.117.2.deb
    

Apple MacApple Mac

Sono necessarie solo le istruzioni di installazione di Android Studio con le impostazioni predefinite.The Android Studio installation instructions with default settings are all that is required. Se hai già installato Android Studio, esegui gli aggiornamenti.Be sure to perform updates if you already have Android Studio installed.

Scaricare e installare l'immagine dell'emulatore Surface DuoDownload and install the Surface Duo emulator image

Scaricare l'immagine di anteprima dell'emulatore Surface Duo dall'Area download Microsoft.Download the Surface Duo emulator image preview from the Microsoft Download Center. I file sono denominati "SurfaceDuoEmulator versione ".The files are named "SurfaceDuoEmulator version ". Seleziona quello corretto per il tuo sistema di sviluppo.Select the right one for your development system.

Scaricare Surface Duo SDK Preview nell'Area download Microsoft.Download Surface Duo SDK preview on the Microsoft Download Center.

Dopo aver scaricato il file, tornare a questa pagina.Return to this page when you have downloaded the file.

Installare ed eseguire l'SDK e l'emulatoreInstall and run the SDK and emulator

  1. Decomprimi il file scaricato e avvia il programma di installazione.Unzip the downloaded file, and launch the installer.
  2. Dopo aver completato l'installazione dell'SDK, puoi avviare l'emulatore di Surface Duo tramite il collegamento del menu Start.After completing the SDK Setup, you can launch the Surface Duo Emulator via the start menu link.
  3. 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.

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 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 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.bat: puoi copiarla in un file come run_androidstudio.bat.Make a backup copy of run.bat - You can copy it to something like run_androidstudio.bat.
  4. Apri il file run.bat in un editor di testo.Open the file run.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

Passaggi successiviNext steps

Scoprire come usare l'emulatore di Surface Duo e quindi iniziare a creare e testare le app con gli strumenti di sviluppo preferiti:Read how to get started with the Surface Duo emulator, then start building and testing apps with your preferred development tools: