Merge "docs: small fixes for Support Library Guide" into jb-mr2-ub-dev

  </div>

</div>

<p>The Android Support Library package contains several individual libraries that can be included

<p>The Android Support Library package contains several libraries that can be included

  in your application. Each of these libraries supports a specific range of Android platform

  versions and set of features.</p>

<p>This guide explains the important features and version support provided by the Support

  Libraries, to help you decide which of them you should include in your application. In general,

  Libraries to help you decide which of them you should include in your application. In general,

  we recommend including the <a href="#v4">v4 support</a> and <a href="#v7-appcompat">v7

  appcompat</a> libraries in your application, because they support a wide range of

  appcompat</a> libraries, because they support a wide range of

  Android versions and provide APIs for recommended user interface patterns.</p>

<p>In order to use any of the following libraries, you must download the library files to your

  Android SDK installation. Follow the directions for downloading the Support Libraries in

  <a href="{@docRoot}tools/support-library/setup.html#download">Support Library Setup</a> to

  complete this step. You must take additional steps to include a specific Support Library in

  your application. See the end of each library section below for instructions on how to include

  the library in your application.</p>

  your application. See the end of each library section below for important information on how to

  include the library in your application.</p>

<h2 id="v4">v4 Support Library</h2>

<p>This library is designed to be used with Android 1.6 (API level 4) and higher. It includes the

  largest set of APIs compared to the other packages, including support for application components,

  largest set of APIs compared to the other libraries, including support for application components,

  user interface features, accessibility, data handling, network connectivity, and programming

  utilities. Here are a few of the key classes included in the v4 package:</p>

  utilities. Here are a few of the key classes included in the v4 library:</p>

<ul>

  <li>App Components

</ul>

<p>

  There are many other APIs included in this package. For complete, detailed information about the

  There are many other APIs included in this library. For complete, detailed information about the

  v4 Support Library APIs, see the {@link android.support.v4.app android.support.v4} package in the

  API reference.

</p>

<p>The Android Support Library package is a set of code libraries that provide useful and important

  features for Android applications in addition to the framework APIs. These libraries provide

  backward-compatible versions of framework APIs as well as features that are only available

  through its API. Each Support Library is backward-compatible to a specific Android API level.

  This design means that your applications can use the libraries' features and still be compatible

  with devices running Android 1.6 (API level 4) and up.</p>

<p>This guide provides information about what features are enabled by the different libraries,

  how to use them in your development environment and information about the Support Library

  releases.</p>

  backward-compatible versions of Android framework APIs as well as features that are only available

  through the library APIs. Each Support Library is backward-compatible to a specific Android API

  level. This design means that your applications can use the libraries' features and still be

  compatible with devices running Android 1.6 (API level 4) and up.</p>

<p>This guide provides information about what features are enabled by the Support Libraries,

  how to use them in your development environment and information about library releases.</p>

<h2 id="overview">Overview</h2>

  <ol>

    <li>Make sure you have downloaded the <strong>Android Support Library</strong>

      using the <a href="#download">SDK Manager</a>.</li>

    <li>Create a {@code /libs} directory in the root of your application project.</li>

    <li>Create a {@code libs/} directory in the root of your application project.</li>

    <li>Copy the JAR file from your Android SDK installation directory (e.g.,

      {@code <sdk>/extras/android/support/v4/android-support-v4.jar}) into your

      application's project {@code /libs} directory.

      application's project {@code libs/} directory.

    <li>Right click the JAR file and select <strong>Build Path &gt; Add to Build Path</strong>.

      </li>

  </ol>

  <div class="toggle-content-toggleme">

    <ol>

      <li>Make sure you have downloaded the <strong>Android Support Repository</strong>.

      <li>Make sure you have downloaded the <strong>Android Support Repository</strong>

        using the <a href="#download">SDK Manager</a>.</li>

      <li>Open the {@code build.gradle} file for your application.</li>

      <li>Add the support library to the {@code dependencies} section. For example, to add the v4

        <code>&lt;sdk&gt;/extras/android/support/v7/appcompat/</code>.</li>

      <li>Click <strong>Finish</strong> to import the project. For the v7 appcompat project, you

        should now see a new project titled <em>android-support-v7-appcompat</em>.</li>

      <li>In the new library project, expand the {@code /libs} folder, right-click each {@code .jar}

      <li>In the new library project, expand the {@code libs/} folder, right-click each {@code .jar}

        file and select <strong>Build Path &gt; Add to Build Path</strong>. For example, when

        creating the the v7 appcompat project, add both the {@code android-support-v4.jar} and

        {@code android-support-v7-appcompat.jar} files to the build path.</li>