Scott Main | 50e990c | 2012-06-21 17:14:39 -0700 | [diff] [blame] | 1 | page.title=mksdcard |
| 2 | parent.title=Tools |
| 3 | parent.link=index.html |
| 4 | @jd:body |
| 5 | |
| 6 | <p>The <code>mksdcard</code> tool lets you quickly create a FAT32 disk image that you can load in the |
| 7 | emulator, to simulate the presence of an SD card in the device. Because you can specify an SD |
| 8 | card while creating an AVD in the AVD Manager, you usually use that feature to create an SD card. |
| 9 | This tool creates an SD card that is not bundled with an AVD, so it is useful for situations |
| 10 | where you need to share a virtual SD card between multiple emulators.</p> |
| 11 | |
| 12 | <h3>Usage</h3> |
| 13 | <pre> |
| 14 | mksdcard -l <label> <size> <file> |
| 15 | </pre> |
| 16 | |
| 17 | <h3>Options</h3> |
| 18 | <p>The following table describes the command-line options of <code>mksdcard</code></p> |
| 19 | <table> |
| 20 | <tr> |
| 21 | <th>Option</th> |
| 22 | |
| 23 | <th>Description</th> |
| 24 | </tr> |
| 25 | |
| 26 | <tr> |
| 27 | <td><code>-l</code></td> |
| 28 | |
| 29 | <td>A volume label for the disk image to create.</td> |
| 30 | </tr> |
| 31 | |
| 32 | <tr> |
| 33 | <td><code>size</code></td> |
| 34 | |
| 35 | <td>An integer that specifies the size (in bytes) of disk image to create. You can also |
| 36 | specify size in kilobytes or megabytes, by appending a "K" or "M" to <size>. For |
| 37 | example, <code>1048576K</code>, <code>1024M</code>.</td> |
| 38 | </tr> |
| 39 | |
| 40 | <tr> |
| 41 | <td><code>file</code></td> |
| 42 | |
| 43 | <td>The path/filename of the disk image to create.</td> |
| 44 | </tr> |
| 45 | </table> |
| 46 | |
| 47 | <p>Once you have created the disk image file, you can load it in the emulator at startup using |
| 48 | the emulator's <code>-sdcard</code> option. For more information, see <a href= |
| 49 | "{@docRoot}tools/help/emulator.html">Android Emulator</a>.</p> |
| 50 | |
| 51 | <p>The usage for the <code>-sdcard</code> option is as follows:</p> |
| 52 | <pre>emulator -sdcard <file></pre> |
| 53 | |
| 54 | <h3>Example</h3> |
| 55 | <pre>mksdcard -l mySdCard 1024M mySdCardFile.img</pre> |