Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 4623c0d8 authored by Scott Main's avatar Scott Main
Browse files

docs: Add basic tool help pages for SDK and AVD Manager. 

The SDK Manager page is needed particularly as a reference by
some pages rather than pointing to the installation guide.

Change-Id: Ie835e310f62cdc88bd6318e82f48e36bdd8e117a
parent fa2dbd69

docs/html/tools/devices/managing-avds.jd

+3 −2
Original line number Diff line number Diff line
@@ -20,8 +20,9 @@ parent.link=index.html 
  <p>The AVD Manager is an easy to use user interface to manage your AVD (Android Virtual Device)

  configurations. An AVD is a device configuration for the Android emulator that allows you to

  model different configurations of Android-powered devices. When you start the AVD Manager in Eclipse 

  or run the <code>android</code> tool on the command line, you will see the AVD Manager as shown in

  figure 1:</p>

  or navigate to your SDK's {@code tools/} directory and execute

  <code>android avd</code>. You will see the AVD Manager as shown in

  figure 1.</p>

  

  <img src="{@docRoot}images/avd-manager.png">

docs/html/tools/help/avd-manager.jd

0 → 100644
+19 −0
Original line number Diff line number Diff line 
page.title=AVD Manager

@jd:body





<p>The AVD Manager provides a graphical user interface in which you can create

and manage Android Virtual Devices (AVDs), which are required by the

<a href="{@docRoot}tools/help/emulator.html">Android Emulator</a>.</p>



<p>You can launch the AVD Manager in one of the following ways:</p>

<ul>

  <li>In Eclipse: select <strong>Window &gt; AVD Manager</strong>, or click

  the AVD Manager icon in the Eclipse toolbar.</li>



  <li>In other IDEs: Navigate to your SDK's <code>tools/</code> directory and execute

  <code>android avd</code>.</li>

</ul>



<p>For more information, see <a href="{@docRoot}tools/devices/managing-avds.html">Managing

AVDs with AVD Manager</a>.

docs/html/tools/help/sdk-manager.jd

0 → 100644
+67 −0
Original line number Diff line number Diff line 
page.title=SDK Manager

@jd:body





<p>The Android SDK separates tools, platforms, and other components into packages you can

  download using the SDK Manager.</p>



<p>You can launch the SDK Manager in one of the following ways:</p>

<ul>

  <li>On Windows, double-click the <code>SDK Manager.exe</code> file at the root of the Android

SDK directory.</li>

  <li>On Mac or Linux, open a terminal and navigate to the <code>tools/</code> directory in the

Android SDK, then execute <code>android sdk</code>.</li>

</ul>



<p>You can select which packages you want to download by toggling the checkboxes on the left, then

click <strong>Install</strong> to install the selected packages.</p>



<img src="{@docRoot}images/sdk_manager_packages.png" alt="" />

<p class="img-caption"><strong>Figure 1.</strong> The Android SDK Manager shows the

SDK packages that are available, already installed, or for which an update is available.</p>





<h2 id="Recommended">Recommended Packages</h2>



<p>Here's an outline of the packages required and those we recommend you use:

</p>



<dl>

  <dt>SDK Tools</dt>

  <dd><strong>Required.</strong> Your new SDK installation already has the latest version. Make sure

you keep this up to date.</dd>

  <dt>SDK Platform-tools</dt>

  <dd><strong>Required.</strong> You must install this package when you install the SDK for

the first time.</dd>

  <dt>SDK Platform</dt>

  <dd><strong>Required.</strong>You must download <em>at least one platform</em> into your

environment so you're able to compile your application. In order to provide the best user experience

on the latest devices, we recommend that you use the latest platform version as your build target.

You'll still be able to run your app on older versions, but you must build against the latest

version in order to use new features when running on devices with the latest version of Android.

  <p>To get started, download the latest Android version, plus the lowest version you plan

  to support (we recommend Android 2.2 for your lowest version).</p></dd>

  <dt>System Image</dt>

  <dd>Recommended. Although you might have one or more Android-powered devices on which to test

 your app, it's unlikely you have a device for every version of Android your app supports. It's

a good practice to download system images for all versions of Android your app supports and test

your app running on them with the <a href="{@docRoot}tools/devices/emulator.html">Android emulator</a>.</dd>

  <dt>Android Support</dt>

  <dd>Recommended. Includes a static library that allows you to use some of the latest

Android APIs (such as <a href="{@docRoot}guide/components/fragments.html">fragments</a>,

plus others not included in the framework at all) on devices running

a platform version as old as Android 1.6. All of the activity templates available when creating

a new project with the <a href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a>

require this. For more information, read <a

href="{@docRoot}tools/extras/support-library.html">Support Library</a>.</dd>

  <dt>SDK Samples</dt>

  <dd>Recommended. The samples give you source code that you can use to learn about

Android, load as a project and run, or reuse in your own app. Note that multiple

samples packages are available &mdash; one for each Android platform version. When

you are choosing a samples package to download, select the one whose API Level

matches the API Level of the Android platform that you plan to use.</dd>

</dl>



<p class="note"><strong>Tip:</strong> For easy access to the SDK tools from a command line, add the

location of the SDK's <code>tools/</code> and

<code>platform-tools</code> to your <code>PATH</code> environment variable.</p>

docs/html/tools/tools_toc.cs

+2 −0
Original line number Diff line number Diff line
@@ -135,6 +135,7 @@ class="en">Tools Help</span></a></div> 
      <li><a href="<?cs var:toroot ?>tools/help/adb.html">adb</a></li>

      <li><a href="<?cs var:toroot ?>tools/help/adt.html">ADT</a></li>

      <li><a href="<?cs var:toroot ?>tools/help/android.html">android</a></li>

      <li><a href="<?cs var:toroot ?>tools/help/avd-manager.html">AVD Manager</a></li>

      <li><a href="<?cs var:toroot ?>tools/help/bmgr.html">bmgr</a>

      <li><a href="<?cs var:toroot ?>tools/help/monitor.html">Device Monitor</a></li>

      <li><a href="<?cs var:toroot ?>tools/help/dmtracedump.html">dmtracedump</a></li>
@@ -160,6 +161,7 @@ class="en">MonkeyRunner</span></a></li> 
        </ul>

      </li>

       <li><a href="<?cs var:toroot ?>tools/help/proguard.html">ProGuard</a></li>

       <li><a href="<?cs var:toroot ?>tools/help/sdk-manager.html">SDK Manager</a></li>

       <li><a href="<?cs var:toroot ?>tools/help/systrace.html">Systrace</a></li>

       <li><a href="<?cs var:toroot ?>tools/help/gltracer.html">Tracer for OpenGL ES</a></li>

       <li><a href="<?cs var:toroot ?>tools/help/traceview.html">Traceview</a></li>