Skip to content

Most visited

Recently visited



Use the mksdcard tool to create a FAT32 disk image that you can load into emulators running different Android Virtual Devices (AVDs) to simulate the presence of the same SD card in multiple devices. If you do not need a disk image that can be shared among multiple virtual devices, you do not need to use the mksdcard command. By default the emulator uses the default image that is generated by and stored with the active AVD instead.


mksdcard -l label size file


The following table describes the command-line options of mksdcard

Option Description
-l label A volume label for the disk image to create.
size An integer that specifies the size of the disk image to create. If size is a simple integer, it specifies the size in bytes. You can also specify the size in kilobytes, megabytes, and gigabytes by appending K, M, or G to size. For example, 1048576K or 1024M. The minimum size is 9M. The Android emulator cannot use smaller images. The maximum size is 1099511627264 bytes, which equates to 1023 GB.
file The path/filename of the disk image to create. The path is relative to the current working directory.


Create the mySdCardFile.img disk image:

mksdcard -l mySdCard 1024M mySdCardFile.img

Start two emulators with different AVDs. Use the -sdcard flag to specify the name and path of the disk image you created.

emulator -avd Pixel_API_25 -sdcard mySdCardFile.img
emulator -avd NEXUS_6_API_25 -sdcard mySdCardFile.img
For more information about the emulator command and its options, see Control the Emulator from the Command Line.
This site uses cookies to store your preferences for site-specific language and display options.


This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a one-minute survey?
Help us improve Android tools and documentation.