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