blob: 38c435666735d2d5d0258faa50d0d0b9744bae9b [file] [log] [blame]
Scott Main50e990c2012-06-21 17:14:39 -07001page.title=mksdcard
2parent.title=Tools
3parent.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>
14mksdcard -l &lt;label&gt; &lt;size&gt; &lt;file&gt;
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 &lt;size&gt;. 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 &lt;file&gt;</pre>
53
54<h3>Example</h3>
55<pre>mksdcard -l mySdCard 1024M mySdCardFile.img</pre>