am 054711b6: Merge "docs: studio 1.3 sdk manager updates" into mnc-preview-docs

* commit '054711b6041fb352e5716e307341bf35858a1546':
  docs: studio 1.3 sdk manager updates

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

@@ -2,30 +2,59 @@ page.title=SDK Manager
 @jd:body
 
 
-<p>The Android SDK separates tools, platforms, and other components into packages you can
+<p>The Android SDK Manager separates the SDK tools, platforms, and other components into packages
-  download using the SDK Manager. For example, when the SDK Tools are updated or a new version of
+for easy access and management. You can also customize which sites the SDK Manager checks for new
-the Android platform is released, you can use the SDK Manager to quickly download them to
+or updated SDK packages and add-on tools. For example, you can configure the SDK Manager
-your environment.</p>
+to automatically check for updates and notify you when an installed SDK Tools package is updated.
+When you receive such a notification, you can then quickly decide whether to download the changes.  </p>
+
+<p>By default, Android Studio does not check for Android SDK updates. To enable automatic Android
+SDK checking: </p>
+<ol>
+  <li>Choose <strong>File</strong> &gt; <strong>Settings</strong>
+    &gt; <strong>Appearance & Behavior</strong> &gt; <strong>System Settings</strong>
+    &gt; <strong>Updates</strong>. </li>
+  <li>Check the <strong>Automatically check updates for Android SDK</strong> checkbox and select an
+    <ahref="{@docRoot}tools/studio/studio-config.html#update-channel">update channel</a>.</li>
+
+
+  <li>Click <strong>OK</strong> or <strong>Apply</strong> to enable the update checking. </li>
+</ol>
 
 <p>You can launch the SDK Manager in one of the following ways:</p>
 <ul>
-  <li>From Eclipse (with <a href="{@docRoot}tools/help/adt.html">ADT</a>),
+  <li>From the Android Studio <strong>File</strong> menu:  <strong>File</strong> &gt;
-  select <strong>Window</strong> &gt; <strong>Android SDK Manager</strong>.</li>
+    <strong>Settings</strong> &gt; <strong>Appearance & Behavior</strong> &gt;
-  <li>From Android Studio, select <strong>Tools</strong> &gt; <strong>Android</strong>
+    <strong>System Settings</strong> &gt; <strong>Android SDK</strong>.</li>
-  &gt; <strong>SDK Manager</strong>.</li>
+  <li>From the Android Studio <strong>Tools</strong> menu: <strong>Tools</strong> &gt;
-  <li>On Windows, double-click the <code>SDK Manager.exe</code> file at the root of the Android
+    <strong>Android</strong> &gt; <strong>SDK Manager</strong>.</li>
-SDK directory.</li>
+  <li>From the SDK Manager icon
-  <li>On Mac or Linux, open a terminal and navigate to the <code>tools/</code> directory in the
+    (<img src="{@docRoot}images/tools/sdk-manager-studio.png" style="vertical-align:sub;margin:0;height:17px" alt="" />)
-location where the Android SDK is installed, then execute <code>android sdk</code>.</li>
+    in the menu bar.  </li>
 </ul>
 
-<p>You can select which packages you want to download by toggling the checkboxes on the left, then
+<p class="note"><strong>Tip:</strong> The standalone SDK Manager is still available from the
-click <strong>Install</strong> to install the selected packages.</p>
+command line, but we recommend it only for use with Eclipse ADT and standalone SDK installations.</p>
 
-<img src="{@docRoot}images/sdk_manager_packages.png" alt="" />
+<p>By default, the SDK Manager installs the latest packages and tools. Click the checkbox next to
+each additional SDK platform and tool that you want to install. Clear the
+checkbox to uninstall a SDK platform or tool. Click <strong>Apply</strong> or <strong>OK</strong>
+to update the packages and tools. </p>
+
+<p class="note"><strong>Tip:</strong> When an update is available for an installed
+package, a hyphen (-) appears in the checkbox next to the package. A download icon
+(<img src="{@docRoot}images/tools/studio-sdk-dwnld-icon.png" style="vertical-align:sub;margin:0;height:17px" alt="" />)
+also appears next
+to the checkbox to indicate the pending update. An update icon
+(<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
+indicate pending removals.</p>
+
+<p>Click the <em>SDK Update Sites</em> tab to manage which SDK sites Android Studio checks for
+tool and add-on updates. </p>
+
+<img src="{@docRoot}images/tools/studio-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>
+SDK platforms and packages that are available and installed along with the SDK update sites.</p>
-
 
 <p>There are several different packages available for the Android SDK. The table below describes
 most of the available packages and where they're located in your SDK directory
@@ -33,8 +62,6 @@ once you download them.</p>
 
 
 
-
-
 <h2 id="Recommended">Recommended Packages</h2>
 
 <p>Here's an outline of the packages required and those we recommend you use:
@@ -42,25 +69,32 @@ once you download them.</p>
 
 <dl>
   <dt>SDK Tools</dt>
-  <dd><strong>Required.</strong> Your new SDK installation already has the latest version. Make sure
+  <dd><strong>Required.</strong> Your new SDK installation installs the latest version. Be sure
-you keep this up to date.</dd>
+    to respond to the Android Studio update prompts to keep your SDK Tools up-to-date.</dd>
   <dt>SDK Platform-tools</dt>
-  <dd><strong>Required.</strong> You must install this package when you install the SDK for
+  <dd><strong>Required.</strong> Your new SDK installation installs the latest stable version.
-the first time.</dd>
+    Be sure to respond to the Android Studio update prompts to keep your SDK Platform-tools
+    up-to-date.</dd>
   <dt>SDK Platform</dt>
-  <dd><strong>Required.</strong>You must download <em>at least one platform</em> into your
+  <dd><strong>Required.</strong><em> At least one platform</em> is required in 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
+  <p>The SDK Manager downloads the latest Android version. It also downloads the earliest version
-  to support (we recommend Android 2.2 for your lowest version).</p></dd>
+  of Android (Android 2.2 (API level 8)) that we recommend that your app support. </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>
+your app running on them with the
-  <dt>Android Support</dt>
+<a href="{@docRoot}tools/devices/emulator.html">Android emulator</a>. Each SDK platform package
+contains the supported system images. Click <strong>Show Package Details</strong> to display the available
+system images for each available platform. You can also download system images when creating
+Android Virtual Devices (AVDs) in the
+<a href="{@docRoot}tools/help/avd-manager.html">AVD Manager</a>. </dd>
+
+  <dt>Android Support Library</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
@@ -68,13 +102,16 @@ a platform version as old as Android 1.6. All of the activity templates availabl
 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/support-library/index.html">Support Library</a>.</dd>
-  <dt>SDK Samples</dt>
+
-  <dd>Recommended. The samples give you source code that you can use to learn about
+  <dt>Android Support Repository</dt>
-Android, load as a project and run, or reuse in your own app. Note that multiple
+  <dd>Recommended. Includes local Maven repository for Support libraries.</dd>
-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
+  <dt>Google Play services</dt>
-matches the API Level of the Android platform that you plan to use.</dd>
+  <dd>Recommended. Includes Google Play services client library and sample code.</dd>
-</dl>
+
+  <dt>Google Repository</dt>
+  <dd>Recommended. Includes local Maven repository for Google libraries.</dd>
+
 
 <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
@@ -82,74 +119,40 @@ location of the SDK's <code>tools/</code> and
 
 
 <p>The above list is not comprehensive and you can <a
-href="#AddingSites">add new sites</a> to download additional packages from third-parties.</p>
+href="#AddingSites">add new sites</a> to download additional packages from third parties.</p>
 
 <p>In some cases, an SDK package may require a specific minimum revision of
 another package or SDK tool.
 The development tools will notify you with warnings if there is dependency that you need to
-address. The Android SDK Manager also enforces dependencies by requiring that you download any
+address. The Android SDK Manager also enforces dependencies by requiring any
 packages that are needed by those you have selected.</p>
 
 
 
-
-
 <h2 id="AddingSites">Adding New Sites</h2>
 
-<p>By default, <strong>Available Packages</strong> displays packages available from the
+<p>The <em>SDK Update Sites</em> tab displays the sites that Android Studio checks for Android SDK
-<em>Android Repository</em> and <em>Third party Add-ons</em>. You can add other sites that host
+and third-party updates. You can add other sites that host their own Android SDK add-ons, then
-their own Android SDK add-ons, then download the SDK add-ons
+download the SDK add-ons from those sites.</p>
-from those sites.</p>
 
 <p>For example, a mobile carrier or device manufacturer might offer additional
 API libraries that are supported by their own Android-powered devices. In order
 to develop using their libraries, you must install their Android SDK add-on, if it's not already
-available under <em>Third party Add-ons</em>. </p>
+available as a <em>third-party add-on</em>. </p>
 
 <p>If a carrier or device manufacturer has hosted an SDK add-on repository file
-on their web site, follow these steps to add their site to the Android SDK
+on their website, follow these steps to add their site to the Android SDK Manager:</p>
-Manager:</p>
 
 <ol>
-  <li>Select <strong>Available Packages</strong> in the left panel.</li>
+  <li>Click the <strong>SDK Update Sites</strong> tab.</li>
-  <li>Click <strong>Add Add-on Site</strong> and enter the URL of the
+  <li>Click the <strong>Add</strong> icon in the tools area and enter the name and URL of the
-<code>repository.xml</code> file. Click <strong>OK</strong>.</li>
+    <code>add-on</code> site.</li>
+  <li>Click <strong>OK</strong>.</li>
+  <li>Make sure the checkbox is checked in the <em>Enabled</em> column.</li>
+  <li>Click <strong>OK</strong> or <strong>Apply</strong>.</li>
 </ol>
-<p>Any SDK packages available from the site will now be listed under a new item named
+<p>Any SDK packages available from the site appear in the <em>SDK Platforms</em> or
-<strong>User Add-ons</strong>.</p>
+<em>SDK Tools</em> tabs.</p>
-
-
-
-
-<h2 id="troubleshooting">Troubleshooting</h2>
-
-<p><strong>Problems connecting to the SDK repository</strong></p>
-
-<p>If you are using the Android SDK Manager to download packages and are encountering
-connection problems, try connecting over http, rather than https. To switch the
-protocol used by the Android SDK Manager, follow these steps: </p>
-
-<ol>
-  <li>With the Android SDK Manager window open, select "Settings" in the
-  left pane. </li>
-  <li>On the right, in the "Misc" section, check the checkbox labeled "Force
-  https://... sources to be fetched using http://..." </li>
-  <li>Click <strong>Save &amp; Apply</strong>.</li>
-</ol>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
 
 
 

docs/html/tools/studio/studio-config.jd

@@ -8,6 +8,7 @@ page.tags=studio, configuration
 
     <h2>In this document</h2>
     <ol>
+      <li><a href="#sdk-mgr">SDK Manager</a></li>
       <li><a href="#update-channel">Update Channels</a></li>
       <li><a href="#proxy">Proxy Settings</a></li>
     </ol>
@@ -23,7 +24,7 @@ page.tags=studio, configuration
 </div>
 
 
-<p>During installation, Android Studio provides wizards and templates that verify your system
+<p>Android Studio provides wizards and templates that verify your system
 requirements, such as the Java Development Kit (JDK) and available RAM, and configure default
 settings, such as an optimized default Android Virtual Device (AVD) emulation and updated system
 images. This document describes additional configuration settings you may want to use to
@@ -35,6 +36,20 @@ customize your use of Android Studio. </p>
 <a href="{@docRoot}tools/extras/oem-usb.html">OEM USB Drivers</a>. </p>
 
 
+<h2 id="sdk-mgr">SDK Manager</h2>
+<p>After the initial Android Studio installation and setup, use the
+<a href="{@docRoot}tools/help/sdk-manager.html">SDK Manager</a> to verify and update the tools,
+platforms, packages, and other components used by your apps. You can also use the
+<strong>File</strong> &gt; <strong>Settings</strong> &gt;
+<strong>Appearance & Behavior</strong> &gt; <strong>System Settings</strong> &gt;
+<strong>Updates</strong> to configure the SDK Manager to automatically prompt whenever updates are
+available. </p>
+
+<p class="note"><strong>Note:</strong> You can also customize the <code>build.gradle</code> file
+so each app uses a specific build chain and compilation options. For more information see,
+<a href="{@docRoot}tools/building/configuring-gradle.html">Configuring Gradle Builds</a>.   </p>
+
+
 
 <h2 id="update-channel">Update channels</h2>
 <p>Android Studio provides four update channels to keep Android Studio up-to-date based on your