| page.title=Other Tools |
| @jd:body |
| |
| <p>The sections below describe other tools that you can use when building Android applications. </p> |
| |
| <p>All of the tools are included in the Android SDK and are accessible from the <code>tools/</code> directory.</p> |
| |
| <h2>Contents</h2> |
| |
| <dl> |
| <dt><a href="#mksdcard">mksdcard</a></dt> |
| <dt><a href="#dx">dx</a></dt> |
| <dt><a href="#activitycreator">activitycreator</a></dd> |
| </dl> |
| |
| <a name="mksdcard"></a> |
| |
| <h2>mksdcard</h2> |
| |
| <p>The mksdcard tool lets you quickly create a FAT32 disk image that you can load in the emulator, to simulate the presence of an SD card in the device. Here is the usage for mksdcard:</p> |
| |
| <pre>mksdcard [-l label] <size>[K|M] <file></pre> |
| |
| </p>The table below lists the available options/arguments</p> |
| |
| <table> |
| <tr> |
| <th>Argument</th> |
| <th>Description</th> |
| </tr> |
| |
| <tr> |
| <td><code>-l</code></td> |
| <td>A volume label for the disk image to create. </td> |
| </tr> |
| |
| <tr> |
| <td><code>size</code></td> |
| <td>An integer that specifies the size (in bytes) of disk image to create. |
| You can also specify size in kilobytes or megabytes, by appending a "K" or "M" to <size>. For example, <code>1048576K</code>, <code>1024M</code>.</td> |
| </tr> |
| |
| <tr> |
| <td><code>file</code></td> |
| <td>The path/filename of the disk image to create. </td> |
| </tr> |
| |
| </table> |
| |
| <p>Once you have created the disk image file, you can load it in the emulator at startup using the emulator's -sdcard option. For more information, see <a href="{@docRoot}guide/developing/tools/emulator.html">Android Emulator</a>.</p> |
| |
| <pre>emulator -sdcard <file></pre> |
| |
| <a name="dx"></a> |
| |
| <h2>dx</h2> |
| |
| <p>The dx tool lets you generate Android bytecode from .class files. The tool converts target files and/or directories to Dalvik executable format (.dex) files, so that they can run in the Android environment. It can also dump the class files in a human-readable format and run a target unit test. You can get the usage and options for this tool by using <code>dx --help</code>.</p> |
| |
| <a name="activitycreator"></a> |
| |
| <h2>activitycreator</h2> |
| |
| <p>If you aren't using the Eclipse IDE and ADT plugin, you can use the the activitycreator script to get started with a new application. When you run the script, it creates the structure of a minimal Android application that you can build on and extend to meet your needs. </p> |
| |
| <p>For Linux and Mac, the SDK provides <code>activitycreator</code>, a shell script, and for Windows <code>activitycreator.bat</code>, a batch script that runs an executable. Regardless of platform, the usage for the script is the same:</p> |
| |
| <pre>activitycreator [--out <folder>] [--ide intellij] your.package.name.ActivityName</pre> |
| |
| <table> |
| <tr> |
| <th>Option</th> |
| <th>Description</th> |
| </tr> |
| |
| <tr> |
| <td><code>--out <folder></code></td> |
| <td>Specifies where to create the files/folders. </td> |
| </tr> |
| |
| <tr> |
| <td><code>--ide intellij</code></td> |
| <td>Creates project files for IntelliJ</td> |
| </tr> |
| |
| </table> |
| |
| |
| <p>When run, the script creates these files: </p> |
| |
| <ul> |
| <li>AndroidManifest.xml -- The application manifest file.</li> |
| <li>build.xml -- An Ant script to build/package the application.</li> |
| <li>res -- The resource directory.</li> |
| <li>src -- The source directory.</li> |
| <li>src/your/package/name/ActivityName.java -- The Activity class. </li> |
| <li>bin -- The output folder for the compiled .apk (when built by Ant).</li> |
| </ul> |
| |
| <p>When you are ready, you can use Ant to <a href="{@docRoot}guide/developing/other-ide.html#antbuild">build the project</a> so that you can run it on the emulator.</p> |
| |
| <p>If you are using Eclipse with the ADT plugin, you do not need to use activitycreator. You can use the New Project Wizard, provided by the ADT plugin, instead. </p> |
| |
| |