diff options
Diffstat (limited to 'docs/html/guide/developing/tools/othertools.jd')
| -rw-r--r-- | docs/html/guide/developing/tools/othertools.jd | 104 |
1 files changed, 104 insertions, 0 deletions
diff --git a/docs/html/guide/developing/tools/othertools.jd b/docs/html/guide/developing/tools/othertools.jd new file mode 100644 index 0000000..eaa0b76 --- /dev/null +++ b/docs/html/guide/developing/tools/othertools.jd @@ -0,0 +1,104 @@ +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> + + |