-->
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
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.
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
(orrun_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
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.