diff --git a/docs/html/images/tools/sdk-manager-support-libs.png b/docs/html/images/tools/sdk-manager-support-libs.png index 37968005c789e..cb4cea5795a63 100644 Binary files a/docs/html/images/tools/sdk-manager-support-libs.png and b/docs/html/images/tools/sdk-manager-support-libs.png differ diff --git a/docs/html/topic/libraries/support-library/features.jd b/docs/html/topic/libraries/support-library/features.jd index d648384399da8..0f63bf6696874 100755 --- a/docs/html/topic/libraries/support-library/features.jd +++ b/docs/html/topic/libraries/support-library/features.jd @@ -141,19 +141,13 @@ page.title=Support Library Features API reference.

-

After you download the Android Support Libraries, this library is located in the -<sdk>/extras/android/support/v4/ directory. The library does not contain user -interface resources. To include it in your application project, follow the instructions for -Adding libraries without -resources.

-

Caution: Using dynamic dependencies, especially for higher version numbers, can cause unexpected version updates and regression incompatibilities.

The Gradle build script dependency identifier for this library is as follows:

-com.android.support:support-v4:23.3.0
+com.android.support:support-v4:24.1.1
 
@@ -167,15 +161,6 @@ com.android.support:support-v4:23.3.0 Building Apps with Over 64K Methods.

-

- After you download the Android Support Libraries, this library is located in the - <sdk>/extras/android/support/multidex/ directory. The library does not contain - user interface resources. To include it in your application project, follow the instructions - for - Adding libraries without - resources. -

-

The Gradle build script dependency identifier for this library is as follows:

@@ -228,16 +213,10 @@ com.android.support:multidex:1.0.0 -

After you download the Android Support Libraries, this library is located in the -<sdk>/extras/android/support/v7/appcompat/ directory. The library contains user -interface resources. To include it in your application project, follow the instructions for -Adding libraries with -resources.

-

The Gradle build script dependency identifier for this library is as follows:

-com.android.support:appcompat-v7:23.3.0
+com.android.support:appcompat-v7:24.1.1
 
@@ -249,16 +228,10 @@ widget, which lets you show information inside cards that have a consistent look on any app. These cards are useful for material design implementations, and are used extensively in layouts for TV apps.

-

After you download the Android Support Libraries, this library is located in the -<sdk>/extras/android/support/v7/cardview/ directory. The library contains user interface -resources. To include it in your application project, follow the instructions -for Adding -libraries with resources.

-

The Gradle build script dependency identifier for this library is as follows:

-com.android.support:cardview-v7:23.3.0
+com.android.support:cardview-v7:24.1.1
 
@@ -271,16 +244,10 @@ allows you to arrange user interface elements using a grid of rectangular cells. For detailed information about the v7 gridlayout library APIs, see the {@link android.support.v7.widget android.support.v7.widget} package in the API reference.

-

This library is located in the <sdk>/extras/android/support/v7/gridlayout/ - directory . The library contains user - interface resources. To include it in your application project, follow the instructions for - Adding libraries with - resources.

-

The Gradle build script dependency identifier for this library is as follows:

-com.android.support:gridlayout-v7:23.3.0
+com.android.support:gridlayout-v7:24.1.1
 
@@ -300,21 +267,10 @@ information about the v7 mediarouter library APIs, see the {@link android.support.v7.media android.support.v7.media} package in the API reference.

-

The v7 mediarouter library is located in the -<sdk>/extras/android/support/v7/mediarouter/ directory after -you download the Android Support Library. It's provided as a library project -with a dependency on the v7 appcompat library, so you'll need to include both -libraries in your build path when setting up your project. For more information -on how to set up your project, follow the instructions in Adding libraries -with resources.

- -

The Gradle builder script dependency identifier is as follows: -com.android.support:support-v7-mediarouter:<revision>, -where "<revision>" is the minimum revision at which the library is available. For example:

+

The Gradle build script dependency identifier for this library is as follows:

-com.android.support:mediarouter-v7:23.3.0
+com.android.support:mediarouter-v7:24.1.1
 

The v7 mediarouter library APIs introduced in Support Library @@ -331,16 +287,10 @@ prominent colors from an image. For example, a music app could use a from an album cover, and use those colors to build a color-coordinated song title card.

-

After you download the Android Support Libraries, this library is located in the -<sdk>/extras/android/support/v7/palette/ directory. The library does not contain -user interface resources. To include it in your application project, follow the instructions for -Adding libraries without -resources.

-

The Gradle build script dependency identifier for this library is as follows:

-com.android.support:palette-v7:23.3.0
+com.android.support:palette-v7:24.1.1
 
@@ -353,16 +303,10 @@ class. This class provides support for the widget, a view for efficiently displaying large data sets by providing a limited window of data items.

-

After you download the Android Support Libraries, this library is located in the -<sdk>/extras/android/support/v7/recyclerview/ directory. The library contains -user interface resources. To include it in your application project, follow the instructions -for Adding -libraries with resources.

-

The Gradle build script dependency identifier for this library is as follows:

-com.android.support:recyclerview-v7:23.3.0
+com.android.support:recyclerview-v7:24.1.1
 
@@ -382,25 +326,12 @@ such as {@link android.support.v7.preference.CheckBoxPreference} and {@link android.support.v7.preference.ListPreference}.

-

After you download the Android Support Libraries, this library is located in the -<sdk>/extras/android/support/v7/preference directory. For more information -on how to set up your project, follow the instructions in Adding libraries -with resources.

-

The Gradle build script dependency identifier for this library is as follows:

-com.android.support:preference-v7:23.3.0
+com.android.support:preference-v7:24.1.1
 
- - - - - - -

v8 Support Library

This library is designed to be used with Android 2.2 (API level 8) and higher. @@ -446,16 +377,10 @@ defaultConfig { android.support.v13} package in the API reference.

-

After you download the Android Support Libraries, this library is located in the -<sdk>/extras/android/support/v13/ directory. The library does not contain user -interface resources. To include it in your application project, follow the instructions for -Adding libraries without -resources.

-

The Gradle build script dependency identifier for this library is as follows:

-com.android.support:support-v13:23.3.0
+com.android.support:support-v13:24.1.1
 
@@ -478,16 +403,10 @@ for preference interfaces such as package in the API reference.

-

After you download the Android Support Libraries, this library is located in the -<sdk>/extras/android/support/v14/ directory. The library does not contain user -interface resources. To include it in your application project, follow the instructions for -Adding libraries without -resources.

-

The Gradle build script dependency identifier for this library is as follows:

-com.android.support:preference-v14:23.3.0
+com.android.support:preference-v14:24.1.1
 
@@ -507,16 +426,10 @@ interface and classes, such as package in the API reference.

-

After you download the Android Support Libraries, this library is located in the -<sdk>/extras/android/support/v17/ directory. The library does not contain user -interface resources. To include it in your application project, follow the instructions for -Adding libraries without -resources.

-

The Gradle build script dependency identifier for this library is as follows:

-com.android.support:preference-leanback-v17:23.3.0
+com.android.support:preference-leanback-v17:24.1.1
 
@@ -549,16 +462,10 @@ com.android.support:preference-leanback-v17:23.3.0 into a {@link android.support.v17.leanback.app.RowsFragment}. -

After you download the Android Support Libraries, this library is located in the -<sdk>/extras/android/support/v17/leanback directory. For more information -on how to set up your project, follow the instructions in Adding libraries -with resources.

-

The Gradle build script dependency identifier for this library is as follows:

-com.android.support:leanback-v17:23.3.0
+com.android.support:leanback-v17:24.1.1
 
@@ -570,16 +477,10 @@ package provides APIs to support adding annotation metadata to your apps.

-

After you download the Android Support Libraries, this library is located in the -<sdk>/extras/android/support/annotations directory. For more information -on how to set up your project, follow the instructions in Adding libraries -with resources.

-

The Gradle build script dependency identifier for this library is as follows:

-com.android.support:support-annotations:23.3.0
+com.android.support:support-annotations:24.1.1
 
@@ -594,17 +495,10 @@ provides APIs to support adding material design components and patterns to your app developers to build upon, such as navigation drawers, floating action buttons (FAB), snackbars, and tabs.

- -

After you download the Android Support Libraries, this library is located in the -<sdk>/extras/android/support/design directory. For more information -on how to set up your project, follow the instructions in Adding libraries -with resources.

-

The Gradle build script dependency identifier for this library is as follows:

-com.android.support:design:23.3.0
+com.android.support:design:24.1.1
 
@@ -622,17 +516,10 @@ and Custom Tabs Callback.

- -

After you download the Android Support Libraries, this library is located in the -<sdk>/extras/android/support/customtabs directory. For more information -on how to set up your project, follow the instructions in Adding libraries -with resources.

-

The Gradle build script dependency identifier for this library is as follows:

-com.android.support:customtabs:23.3.0
+com.android.support:customtabs:24.1.1
 
@@ -653,17 +540,10 @@ and PercentRelativeLayout.

- -

After you download the Android Support Libraries, this library is located in the -<sdk>/extras/android/support/percent directory. For more information -on how to set up your project, follow the instructions in Adding libraries -with resources.

-

The Gradle build script dependency identifier for this library is as follows:

-com.android.support:percent:23.3.0
+com.android.support:percent:24.1.1
 
@@ -683,15 +563,8 @@ and RecommendationExtender.

- -

After you download the Android Support Libraries, this library is located in the -<sdk>/extras/android/support/recommendation directory. For more information -on how to set up your project, follow the instructions in Adding libraries -with resources.

-

The Gradle build script dependency identifier for this library is as follows:

-com.android.support:recommendation:23.3.0
+com.android.support:recommendation:24.1.1
 
diff --git a/docs/html/topic/libraries/support-library/setup.jd b/docs/html/topic/libraries/support-library/setup.jd index 62f7148acc7cb..0cb9389ff5081 100755 --- a/docs/html/topic/libraries/support-library/setup.jd +++ b/docs/html/topic/libraries/support-library/setup.jd @@ -10,18 +10,12 @@ page.title=Support Library Setup
  1. Downloading the Support Library
  2. Choosing Support Libraries
  3. -
  4. Adding Support Libraries -
      -
    1. Adding libraries without resources
    2. -
    3. Adding libraries with resources
    4. -
    -
  5. +
  6. Adding Support Libraries
  7. Using Support Library APIs
    1. Manifest Declaration Changes
  8. -
  9. Code Samples

See also

@@ -45,8 +39,8 @@ page.title=Support Library Setup

Downloading the Support Libraries

-

The Android Support Library package is provided as a supplemental download to the Android SDK - and is available through the Android +

The Android Support Repository package is provided as a supplemental download + to the Android SDK and is available through the Android SDK Manager. Follow the instructions below to obtain the Support Library files.

@@ -57,22 +51,18 @@ page.title=Support Library Setup
  • Start the Android SDK Manager.
  • In the SDK Manager window, scroll to the end of the Packages list, find the Extras folder and, if necessary, expand to show its contents.
  • -
  • Select the Android Support Library item. -

    - Note: If you're developing with Android Studio, select and install the - Android Support Repository item instead. -

    -
  • +
  • Select the Android Support Repository item.
  • Click the Install packages... button.
  • -

    Figure 1. The Android SDK Manager with the -Android Support Library selected.

    +

    Figure 1. The Android SDK Manager with +Android Support Repository selected.

    After downloading, the tool installs the Support Library files to your existing Android SDK directory. The library files are located in the following subdirectory of your SDK: - {@code <sdk>/extras/android/support/} directory.

    + <sdk>/extras/android/m2repository/com/android/support/ + directory.

    Choosing Support Libraries

    @@ -89,20 +79,7 @@ Android Support Library selected.

    classpath dependencies within your development environment. You must perform this procedure for each Support Library you want to use.

    -

    Some Support Libraries contain resources beyond compiled code classes, such as images or XML - files. For example, the v7 - appcompat and v7 - gridlayout libraries include resources.

    - -

    If you are not sure if a library contains resources, check the - Support Library Features page. - The following sections describe how to add a Support Library with or without resources to your - application project.

    - - -

    Adding libraries without resources

    - -

    To add a Support Library without resources to your application project:

    +

    To add a Support Library to your application project:

    1. Make sure you have downloaded the Android Support Repository @@ -113,37 +90,12 @@ Android Support Library selected.

       dependencies {
           ...
      -    compile "com.android.support:support-v4:18.0.+"
      +    compile "com.android.support:support-v4:24.1.1"
       }
       
    - -

    Adding libraries with resources

    - -

    To add a Support Library with resources (such as - v7 - appcompat for action bar) to your application project:

    - -
      -
    1. Make sure you have downloaded the Android Support Repository - using the SDK Manager.
    2. -
    3. Open the {@code build.gradle} file for your application.
    4. -
    5. Add the support library feature project identifier to the {@code dependencies} section. - For example, to include the {@code appcompat} project add - {@code compile "com.android.support:appcompat-v7:18.0.+"} to the dependencies section, as - shown in the following example: -
      -dependencies {
      -    ...
      -    compile "com.android.support:appcompat-v7:18.0.+"
      -}
      -
      -
    6. -
    - -

    Using Support Library APIs

    Support Library classes that provide support for existing framework APIs typically have the @@ -224,18 +176,3 @@ android { "4"). The highest support library level you include in your application determines the lowest API version in which it can operate.

    - - -

    Code Samples

    - -

    Each Support Library includes code samples to help you get started using the support -APIs. The code is included in the download from the SDK Manager and is placed inside the Android -SDK installation directory, as listed below:

    - - -