From 874c731ac3399ca038745df83d1545dba33ac367 Mon Sep 17 00:00:00 2001 From: Dirk Dougherty <> Date: Tue, 21 Apr 2009 15:00:34 -0700 Subject: [PATCH] AI 147239: am: CL 147238 Update tools index, replace activitycreator with android Original author: ddougherty Merged from: //branches/cupcake/... Automated import of CL 147239 --- docs/html/guide/appendix/faq/commontasks.jd | 4 +- docs/html/guide/developing/tools/index.jd | 33 +++++++------ docs/html/guide/developing/tools/othertools.jd | 64 ++++++++------------------ docs/html/guide/guide_toc.cs | 7 +-- docs/html/samples/index.jd | 5 +- 5 files changed, 46 insertions(+), 67 deletions(-) diff --git a/docs/html/guide/appendix/faq/commontasks.jd b/docs/html/guide/appendix/faq/commontasks.jd index 9c79bddf75ea..0f89e7534a68 100644 --- a/docs/html/guide/appendix/faq/commontasks.jd +++ b/docs/html/guide/appendix/faq/commontasks.jd @@ -701,8 +701,8 @@ If the latitudeSpan, longitudeSpan, and zoomLevel attributes are not consistent,

List of Files for an Android Application

The following list describes the structure and files of an Android application. - Many of these files can be built for you (or stubbed out) by the activitycreator - application shipped in the tools/ menu of the SDK.

+ Many of these files can be built for you (or stubbed out) by the android tool + shipped in the tools/ menu of the SDK.

diff --git a/docs/html/guide/developing/tools/index.jd b/docs/html/guide/developing/tools/index.jd index b491a4fcd8da..e53d5957995a 100644 --- a/docs/html/guide/developing/tools/index.jd +++ b/docs/html/guide/developing/tools/index.jd @@ -8,23 +8,29 @@ applications on the Android platform. The most important of these are the Androi Emulator and the Android Development Tools plugin for Eclipse, but the SDK also includes a variety of other tools for debugging, packaging, and installing your applications on the emulator.

- -
-
Android Emulator
-
A virtual mobile device that runs on your computer. You use the emulator to design, - debug, and test your applications in an actual Android run-time environment.
+
Android Development Tools Plugin (for the Eclipse IDE)
The ADT plugin adds powerful extensions to the Eclipse integrated environment, making creating and debugging your Android applications easier and faster. If you use Eclipse, the ADT plugin gives you an incredible boost in developing Android applications.
+
Android Emulator
+
A QEMU-based device-emulation tool that you can use to design, + debug, and test your applications in an actual Android run-time environment.
-
Hierarchy Viewer
-
The Hierarchy Viewer tool allows you to debug and optimize your user interface. - It provides a visual representation of your layout's hierarchy of Views and a magnified inspector - of the current display with a pixel grid, so you can get your layout just right. -
+
Android Virtual Devices (AVDs)
+
Virtual device configurations that you create, to model device + characteristics in the Android Emulator. In each configuration, you can + specify the Android platform to run, the hardware options, and the + emulator skin to use. Each AVD functions as an independent device with + it's own storage for user data, SD card, and so on.
+ +
Hierarchy Viewer
+
The Hierarchy Viewer tool allows you to debug and optimize your user interface. + It provides a visual representation of your layout's hierarchy of Views and a magnified inspector + of the current display with a pixel grid, so you can get your layout just right. +
Draw 9-patch
The Draw 9-patch tool allows you to easily create a @@ -79,10 +85,9 @@ applications on the emulator.

level events. You can use the Monkey to stress-test applications that you are developing, in a random yet repeatable manner.
-
activitycreator
-
A script that generates android +
A script that lets you manage AVDs and generate Ant build files that - you can use to compile your Android applications. If you are developing - on Eclipse with the ADT plugin, you won't need to use this script.
+ you can use to compile your Android applications.
diff --git a/docs/html/guide/developing/tools/othertools.jd b/docs/html/guide/developing/tools/othertools.jd index eaa0b76a5f42..603609eb1ae0 100644 --- a/docs/html/guide/developing/tools/othertools.jd +++ b/docs/html/guide/developing/tools/othertools.jd @@ -3,16 +3,32 @@ page.title=Other Tools

The sections below describe other tools that you can use when building Android applications.

-

All of the tools are included in the Android SDK and are accessible from the tools/ directory.

+

All of the tools are included in the Android SDK and are accessible from the <sdk>/tools/ directory.

Contents

+
android
mksdcard
dx
-
activitycreator
+ +

android

+ +

The android tool is a script that lets you create and manage Android Virtual Devices (AVDs) and, if you are developing using Ant, generate template Android projects to help you get started quickly.

+ +

For information about how to use the android tool to manage AVDs, see Android Virtual Devices.

+ +

For information about how to use the android tool to create or update a project, see Developing in Other IDEs.

+ +

Note that if you are developing in Eclipse with the ADT plugin, you will use the android tool to manage the AVDs you create, but you will not use the android tool for creating a project. The ADT plugin provides a New Project Wizard that helps you set up an Android project in Eclipse.

+ +

If you are developing in Ant, you will use the android tool to manage your AVDs, and you can also use it to create or update a project.

+ +

Note: The android tool replaces the activitycreator tool provided in previous SDK releases.

+ +

mksdcard

@@ -21,7 +37,7 @@ page.title=Other Tools 
mksdcard [-l label] <size>[K|M] <file>
-

The table below lists the available options/arguments

+

The table below lists the available options/arguments

MyApp/
@@ -57,48 +73,6 @@ You can also specify size in kilobytes or megabytes, by appending a "K" or "M" t

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 dx --help.

- - -

activitycreator

- -

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.

- -

For Linux and Mac, the SDK provides activitycreator, a shell script, and for Windows activitycreator.bat, a batch script that runs an executable. Regardless of platform, the usage for the script is the same:

- -
activitycreator [--out <folder>] [--ide intellij] your.package.name.ActivityName
- -
- - - - - - - - - - - - - - - -
OptionDescription
--out <folder>Specifies where to create the files/folders.
--ide intellijCreates project files for IntelliJ
- - -

When run, the script creates these files:

- - - -

When you are ready, you can use Ant to build the project so that you can run it on the emulator.

-

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.

diff --git a/docs/html/guide/guide_toc.cs b/docs/html/guide/guide_toc.cs index 77d3522ce72a..3c9b7c27bbcd 100644 --- a/docs/html/guide/guide_toc.cs +++ b/docs/html/guide/guide_toc.cs @@ -61,6 +61,7 @@
  • <provider>
  • <receiver>
  • <service>
    • +
  • <uses-configuration>
  • <uses-library>
  • <uses-permission>
  • <uses-sdk>
    • @@ -84,7 +85,7 @@
  • Accelerometer
    • --> -
  • Location
    • +
  • Location and Maps
    • -
  • In Eclipse, with ADT
  • In Other IDEs
  • On a Device
    • @@ -110,9 +110,10 @@