17-09-2021

-->

Please visit the Surface Duo Tech Community to ask questions or discuss any issues you are having with the Surface Duo emulator or SDK.

Setup Android Emulator on Mac OS X. The purpose of this section is to guide you to create in your development environment an Android emulator. Android emulators are managed through a UI called AVD Manager. AVD Manager has a nice interface when started from Android Studio. Start Android Studio app, then create a blank project.

Following are some common issues and their resolution.

Surface Duo emulator does not appear in the device list in Android Studio or Visual Studio

How to Setup Android Virtual Device Android Emulator Part 2 In this video i m going to show you how you can setup Android Emulator or virtual. You can launch the SDK Manager in one of the following ways: From Eclipse (with ADT ), select Window Android SDK Manager. On Windows, double-click the SDK Manager.exe file at the root of the Android SDK directory. On Mac or Linux, open a terminal and navigate to the tools/ directory in the Android SDK, then execute android sdk.

The current version of the Surface Duo emulator cannot be started by your IDE. First manually start the emulator and once it's running it should appear in the list for deployment and debugging:

  • Windows - choose from Start > Surface Duo Emulator.
  • Mac - start from the command line using ./run.sh (or ./run_vs.sh for Visual Studio for Mac).

Once you have started the Surface Duo emulator, it should appear in the device list as Virtual device.

Surface Duo emulator does not appear in the Android Virtual Device (AVD) Manager

The current version of the Surface Duo emulator cannot be managed in AVD Manager. Instead it must be installed from our download page and started manually:

  • Windows - choose from Start > Surface Duo Emulator.
  • Mac - start from the command line using ./run.sh (or ./run_vs.sh for Visual Studio for Mac).

Apps do not open across both screens

By default applications will only open on a single screen. The user can then choose to span the application across both screens by dragging

Manager

There is no way for app developers to programmatically force an app to use both screens either. It is always a user-controlled action.

Contents do not rotate with the emulator

Verify that Auto-rotate is enabled in the notification drawer or in Settings > Display > Auto-rotate screen. The default value is to NOT rotate, and often is overlooked.

Mac

Note

If you are still experiencing rotation issues after enabling auto-rotate, you may be using an old version of the emulator from September 2020. This issue has been fixed since emulator version 2020.1014.2. Follow the emulator installation instructions to get the latest version.

How to 'Factory reset' the Surface Duo emulator

In the installation folder, there are four batch files run_wipe.bat, run_wipe.sh, run_vs_wipe.bat, run_vs_wipe.bat.

Install Avd Mac

  • Windows - In the artifacts folder inside of the installation folder, you can execute run_wipe.bat (or run_vs_wipe.bat for Visual Studio) directly to return the Surface Duo emulator image to its original state.
  • Mac - In a terminal window, navigate to the folder where you copied the emulator files. And then type ./run_wipe.sh (or ./run_vs_wipe.sh for Visual Studio for Mac) to return the Surface Duo emulator image to its original state.

These files are installed with the emulator version 2020.1014.2 released in mid-October 2020.

If you are using an older version and cannot update immediately

If you have an earlier version, you should download the latest version, or you can create a script file manually. Start by copying the existing run_clean (or run_vs_clean) file to run_wipe (or run_vs_wipe) and modify it as shown below:

or for shell files on macOS and Linux:

Avd Manager Mac Os

Avd manager mac osAvd manager mac free

The updated batch/script file should be located in the same directory as the existing batch/script files that you use to start the emulator. If you are modifying the Visual Studio version (with _vs in the filename) be sure the final line refers to run_vs.bat or run_vs.sh.

Avd Manager Mac Android Studio

Surface Duo emulator fails to launch after an interuption

Mac Avd Manager Unable To Locate Adb

When the emulator is interrupted while in the middle of saving a Snapshot, on subsequent launches, it will attempt to boot from a corrupted snapshot state. Or, sometimes an unexpected issue happens while the emulator is running, and attempts to launch it result in the error, 'emulator: ERROR: bad workspace: cannot find prebuilt kernel in: ../bin/prebuilts/qemu-kernel/x86_64/kernel-qemu'

Avd Manager Mac Free

In this case, perform a Factory reset as described above to fix the issue and re-launch the emulator.