• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1page.title=SDK Manager
2@jd:body
3
4
5<p>The Android SDK separates tools, platforms, and other components into packages you can
6  download using the SDK Manager.</p>
7
8<p>You can launch the SDK Manager in one of the following ways:</p>
9<ul>
10  <li>From Eclipse (with <a href="{@docRoot}tools/help/adt.html">ADT</a>),
11  select <strong>Window</strong> &gt; <strong>Android SDK Manager</strong>.</li>
12  <li>On Windows, double-click the <code>SDK Manager.exe</code> file at the root of the Android
13SDK directory.</li>
14  <li>On Mac or Linux, open a terminal and navigate to the <code>tools/</code> directory in the
15Android SDK, then execute <code>android sdk</code>.</li>
16</ul>
17
18<p>You can select which packages you want to download by toggling the checkboxes on the left, then
19click <strong>Install</strong> to install the selected packages.</p>
20
21<img src="{@docRoot}images/sdk_manager_packages.png" alt="" />
22<p class="img-caption"><strong>Figure 1.</strong> The Android SDK Manager shows the
23SDK packages that are available, already installed, or for which an update is available.</p>
24
25
26<h2 id="Recommended">Recommended Packages</h2>
27
28<p>Here's an outline of the packages required and those we recommend you use:
29</p>
30
31<dl>
32  <dt>SDK Tools</dt>
33  <dd><strong>Required.</strong> Your new SDK installation already has the latest version. Make sure
34you keep this up to date.</dd>
35  <dt>SDK Platform-tools</dt>
36  <dd><strong>Required.</strong> You must install this package when you install the SDK for
37the first time.</dd>
38  <dt>SDK Platform</dt>
39  <dd><strong>Required.</strong>You must download <em>at least one platform</em> into your
40environment so you're able to compile your application. In order to provide the best user experience
41on the latest devices, we recommend that you use the latest platform version as your build target.
42You'll still be able to run your app on older versions, but you must build against the latest
43version in order to use new features when running on devices with the latest version of Android.
44  <p>To get started, download the latest Android version, plus the lowest version you plan
45  to support (we recommend Android 2.2 for your lowest version).</p></dd>
46  <dt>System Image</dt>
47  <dd>Recommended. Although you might have one or more Android-powered devices on which to test
48 your app, it's unlikely you have a device for every version of Android your app supports. It's
49a good practice to download system images for all versions of Android your app supports and test
50your app running on them with the <a href="{@docRoot}tools/devices/emulator.html">Android emulator</a>.</dd>
51  <dt>Android Support</dt>
52  <dd>Recommended. Includes a static library that allows you to use some of the latest
53Android APIs (such as <a href="{@docRoot}guide/components/fragments.html">fragments</a>,
54plus others not included in the framework at all) on devices running
55a platform version as old as Android 1.6. All of the activity templates available when creating
56a new project with the <a href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a>
57require this. For more information, read <a
58href="{@docRoot}tools/extras/support-library.html">Support Library</a>.</dd>
59  <dt>SDK Samples</dt>
60  <dd>Recommended. The samples give you source code that you can use to learn about
61Android, load as a project and run, or reuse in your own app. Note that multiple
62samples packages are available &mdash; one for each Android platform version. When
63you are choosing a samples package to download, select the one whose API Level
64matches the API Level of the Android platform that you plan to use.</dd>
65</dl>
66
67<p class="note"><strong>Tip:</strong> For easy access to the SDK tools from a command line, add the
68location of the SDK's <code>tools/</code> and
69<code>platform-tools</code> to your <code>PATH</code> environment variable.</p>
70