1page.title=SDK Manager 2@jd:body 3 4 5<p>The Android SDK Manager separates the SDK tools, platforms, and other components into packages 6for easy access and management. You can also customize which sites the SDK Manager checks for new 7or updated SDK packages and add-on tools. For example, you can configure the SDK Manager 8to automatically check for updates and notify you when an installed SDK Tools package is updated. 9When you receive such a notification, you can then quickly decide whether to download the changes. </p> 10 11<p>By default, Android Studio does not check for Android SDK updates. To enable automatic Android 12SDK checking: </p> 13<ol> 14 <li>Choose <strong>File</strong> > <strong>Settings</strong> 15 > <strong>Appearance & Behavior</strong> > <strong>System Settings</strong> 16 > <strong>Updates</strong>. </li> 17 <li>Check the <strong>Automatically check updates for Android SDK</strong> checkbox and select an 18 <ahref="{@docRoot}tools/studio/studio-config.html#update-channel">update channel</a>.</li> 19 20 21 <li>Click <strong>OK</strong> or <strong>Apply</strong> to enable the update checking. </li> 22</ol> 23 24<p>You can launch the SDK Manager in one of the following ways:</p> 25<ul> 26 <li>From the Android Studio <strong>File</strong> menu: <strong>File</strong> > 27 <strong>Settings</strong> > <strong>Appearance & Behavior</strong> > 28 <strong>System Settings</strong> > <strong>Android SDK</strong>.</li> 29 <li>From the Android Studio <strong>Tools</strong> menu: <strong>Tools</strong> > 30 <strong>Android</strong> > <strong>SDK Manager</strong>.</li> 31 <li>From the SDK Manager icon 32 (<img src="{@docRoot}images/tools/sdk-manager-studio.png" style="vertical-align:sub;margin:0;height:17px" alt="" />) 33 in the menu bar. </li> 34</ul> 35 36<p class="note"><strong>Tip:</strong> The standalone SDK Manager is still available from the 37command line, but we recommend it only for use with Eclipse ADT and standalone SDK installations.</p> 38 39<p>By default, the SDK Manager installs the latest packages and tools. Click the checkbox next to 40each additional SDK platform and tool that you want to install. Clear the 41checkbox to uninstall a SDK platform or tool. Click <strong>Apply</strong> or <strong>OK</strong> 42to update the packages and tools. </p> 43 44<p class="note"><strong>Tip:</strong> When an update is available for an installed 45package, a hyphen (-) appears in the checkbox next to the package. A download icon 46(<img src="{@docRoot}images/tools/studio-sdk-dwnld-icon.png" style="vertical-align:sub;margin:0;height:17px" alt="" />) 47also appears next 48to the checkbox to indicate the pending update. An update icon 49(<img src="{@docRoot}images/tools/studio-sdk-removal-icon.png" style="vertical-align:sub;margin:0;height:17px" alt="" />) appears next to the checkbox to 50indicate pending removals.</p> 51 52<p>Click the <em>SDK Update Sites</em> tab to manage which SDK sites Android Studio checks for 53tool and add-on updates. </p> 54 55<img src="{@docRoot}images/tools/studio-sdk-manager-packages.png" alt="" /> 56<p class="img-caption"><strong>Figure 1.</strong> The Android SDK Manager shows the 57SDK platforms and packages that are available and installed along with the SDK update sites.</p> 58 59<p>There are several different packages available for the Android SDK. The table below describes 60most of the available packages and where they're located in your SDK directory 61once you download them.</p> 62 63 64 65<h2 id="Recommended">Recommended Packages</h2> 66 67<p>Here's an outline of the packages required and those we recommend you use: 68</p> 69 70<dl> 71 <dt>SDK Tools</dt> 72 <dd><strong>Required.</strong> Your new SDK installation installs the latest version. Be sure 73 to respond to the Android Studio update prompts to keep your SDK Tools up-to-date.</dd> 74 <dt>SDK Platform-tools</dt> 75 <dd><strong>Required.</strong> Your new SDK installation installs the latest stable version. 76 Be sure to respond to the Android Studio update prompts to keep your SDK Platform-tools 77 up-to-date.</dd> 78 <dt>SDK Platform</dt> 79 <dd><strong>Required.</strong><em> At least one platform</em> is required in your 80environment so you're able to compile your application. In order to provide the best user experience 81on the latest devices, we recommend that you use the latest platform version as your build target. 82You'll still be able to run your app on older versions, but you must build against the latest 83version in order to use new features when running on devices with the latest version of Android. 84 <p>The SDK Manager downloads the latest Android version. It also downloads the earliest version 85 of Android (Android 2.2 (API level 8)) that we recommend that your app support. </p></dd> 86 <dt>System Image</dt> 87 <dd>Recommended. Although you might have one or more Android-powered devices on which to test 88 your app, it's unlikely you have a device for every version of Android your app supports. It's 89a good practice to download system images for all versions of Android your app supports and test 90your app running on them with the 91<a href="{@docRoot}tools/devices/emulator.html">Android emulator</a>. Each SDK platform package 92contains the supported system images. Click <strong>Show Package Details</strong> to display the available 93system images for each available platform. You can also download system images when creating 94Android Virtual Devices (AVDs) in the 95<a href="{@docRoot}tools/help/avd-manager.html">AVD Manager</a>. </dd> 96 97 <dt>Android Support Library</dt> 98 <dd>Recommended. Includes a static library that allows you to use some of the latest 99Android APIs (such as <a href="{@docRoot}guide/components/fragments.html">fragments</a>, 100plus others not included in the framework at all) on devices running 101a platform version as old as Android 1.6. All of the activity templates available when creating 102a new project with the <a href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a> 103require this. For more information, read <a 104href="{@docRoot}tools/support-library/index.html">Support Library</a>.</dd> 105 106 <dt>Android Support Repository</dt> 107 <dd>Recommended. Includes local Maven repository for Support libraries.</dd> 108 109 <dt>Google Play services</dt> 110 <dd>Recommended. Includes Google Play services client library and sample code.</dd> 111 112 <dt>Google Repository</dt> 113 <dd>Recommended. Includes local Maven repository for Google libraries.</dd> 114 115 116<p class="note"><strong>Tip:</strong> For easy access to the SDK tools from a command line, add the 117location of the SDK's <code>tools/</code> and 118<code>platform-tools</code> to your <code>PATH</code> environment variable.</p> 119 120 121<p>The above list is not comprehensive and you can <a 122href="#AddingSites">add new sites</a> to download additional packages from third parties.</p> 123 124<p>In some cases, an SDK package may require a specific minimum revision of 125another package or SDK tool. 126The development tools will notify you with warnings if there is dependency that you need to 127address. The Android SDK Manager also enforces dependencies by requiring any 128packages that are needed by those you have selected.</p> 129 130 131 132<h2 id="AddingSites">Adding New Sites</h2> 133 134<p>The <em>SDK Update Sites</em> tab displays the sites that Android Studio checks for Android SDK 135and third-party updates. You can add other sites that host their own Android SDK add-ons, then 136download the SDK add-ons from those sites.</p> 137 138<p>For example, a mobile carrier or device manufacturer might offer additional 139API libraries that are supported by their own Android-powered devices. In order 140to develop using their libraries, you must install their Android SDK add-on, if it's not already 141available as a <em>third-party add-on</em>. </p> 142 143<p>If a carrier or device manufacturer has hosted an SDK add-on repository file 144on their website, follow these steps to add their site to the Android SDK Manager:</p> 145 146<ol> 147 <li>Click the <strong>SDK Update Sites</strong> tab.</li> 148 <li>Click the <strong>Add</strong> icon in the tools area and enter the name and URL of the 149 <code>add-on</code> site.</li> 150 <li>Click <strong>OK</strong>.</li> 151 <li>Make sure the checkbox is checked in the <em>Enabled</em> column.</li> 152 <li>Click <strong>OK</strong> or <strong>Apply</strong>.</li> 153</ol> 154<p>Any SDK packages available from the site appear in the <em>SDK Platforms</em> or 155<em>SDK Tools</em> tabs.</p> 156 157 158 159
