From c9e841efb1caccee24f0abbe4b347cd236129c19 Mon Sep 17 00:00:00 2001 From: Rich Slogar Date: Wed, 6 May 2015 16:30:47 -0700 Subject: docs: support library 22.2 updates Change-Id: Ib37450986613be6cfe9d3d6d6b349367221c9416 --- docs/html/tools/support-library/features.jd | 144 +++++++++++++++------- docs/html/tools/support-library/index.jd | 184 +++++++++++++++++++++++++++- 2 files changed, 282 insertions(+), 46 deletions(-) diff --git a/docs/html/tools/support-library/features.jd b/docs/html/tools/support-library/features.jd index 573baad98d83..926578aec95a 100644 --- a/docs/html/tools/support-library/features.jd +++ b/docs/html/tools/support-library/features.jd @@ -22,6 +22,8 @@ page.title=Support Library Features
  • v8 Support Library
  • v13 Support Library
  • v17 Leanback Library
    • +
  • Annotations Support Library
    • +
  • Design Support Library

    • See also

    @@ -131,11 +133,11 @@ page.title=Support Library Features API reference.

    -

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

    +

    After you download the Android Support Libraries, this library is located in the +{@code <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.

    @@ -158,10 +160,11 @@ com.android.support:support-v4:21.0.0

    - This library is located in the {@code <sdk>/extras/android/support/multidex/} directory - after you download the Android Support Libraries. The library does not contain user interface - resources. To include it in your application project, follow the instructions for Adding libraries without + After you download the Android Support Libraries, this library is located in the + {@code <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.

    @@ -218,11 +221,11 @@ com.android.support:multidex:1.0.0 -

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

    +

    After you download the Android Support Libraries, this library is located in the +{@code <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:

    @@ -239,9 +242,8 @@ 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.

    -

    This library is located in the -{@code <sdk>/extras/android/support/v7/cardview/} directory after you -download the Android Support Libraries. The library contains user interface +

    After you download the Android Support Libraries, this library is located in the +{@code <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.

    @@ -256,13 +258,14 @@ com.android.support:cardview-v7:21.0.0

    v7 gridlayout library

    -

    This library adds support for the {@link android.support.v7.widget.GridLayout} class, which - 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.

    +

    After you download the Android Support Libraries, this library adds support for the +{@link android.support.v7.widget.GridLayout} class, which +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 {@code <sdk>/extras/android/support/v7/gridlayout/} - directory after you download the Android Support Libraries. The library contains user + directory . The library contains user interface resources. To include it in your application project, follow the instructions for Adding libraries with resources.

    @@ -323,12 +326,11 @@ 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.

    -

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

    +

    After you download the Android Support Libraries, this library is located in the +{@code <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:

    @@ -346,10 +348,9 @@ class. This class provides support for the widget, a view for efficiently displaying large data sets by providing a limited window of data items.

    -

    This library is located in the -{@code <sdk>/extras/android/support/v7/recyclerview/} directory after you -download the Android Support Libraries. The library contains user interface -resources. To include it in your application project, follow the instructions +

    After you download the Android Support Libraries, this library is located in the +{@code <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.

    @@ -363,6 +364,12 @@ com.android.support:recyclerview-v7:21.0.0

    v8 Support Library

    +

    This library is designed to be used with Android 2.2 (API level 8) and higher. + This library provides specific feature sets and can be included in your application + independently from other libraries.

    + +

    v8 renderscript library

    +

    This library is designed to be used with Android (API level 8) and higher. It adds support for the RenderScript computation framework. These APIs are included in the {@link android.support.v8.renderscript} package. You @@ -374,9 +381,20 @@ com.android.support:recyclerview-v7:21.0.0

    Note: Use of RenderScript with the support library is supported with Android - Studio and Gradle-based builds, as well as the Eclipse plugin and Ant build tools. + Studio and Gradle-based builds, as well as the Eclipse plugin and Ant build tools. The + renderscript library is located in the build-tools/$VERSION/renderscript/ folder.

    +

    The following example shows the Gradle build script properties for this library:

    + +
    +defaultConfig {
+    renderscriptTargetApi 18
+    renderscriptSupportModeEnabled true
+}
+
    + +

    v13 Support Library

    @@ -389,11 +407,11 @@ com.android.support:recyclerview-v7:21.0.0 android.support.v13} package in the API reference.

    -

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

    +

    After you download the Android Support Libraries, this library is located in the +{@code <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:

    @@ -429,9 +447,8 @@ com.android.support:support-v13:18.0.0 into a {@link android.support.v17.leanback.app.RowsFragment}. -

    This library is located in the -{@code <sdk>/extras/android/support/v17/leanback} directory after -you download the Android Support Libraries. For more information +

    After you download the Android Support Libraries, this library is located in the +{@code <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.

    @@ -444,3 +461,48 @@ com.android.support:leanback-v17:21.0.0 +

    Annotations Support Library

    + +

    The Annotation +package provides APIs to support adding annotation metadata to your apps.

    + +

    + +

    After you download the Android Support Libraries, this library is located in the +{@code <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:22.0.0
+
    + + + +

    Design Support Library

    + +

    The +Design package +provides APIs to support adding material design components and patterns to your apps.

    + +

    The Design Support library adds support for various material design components and patterns for +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 +{@code <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:support-design:22.0.0
+
    + + diff --git a/docs/html/tools/support-library/index.jd b/docs/html/tools/support-library/index.jd index 98c9ad54b570..1dad6b808597 100644 --- a/docs/html/tools/support-library/index.jd +++ b/docs/html/tools/support-library/index.jd @@ -59,13 +59,187 @@ page.title=Support Library

    This section provides details about the Support Library package releases.

    -
    +

    - Android Support Library, revision 22.2.0 (May 2015) +

    +
    +
    +
    Added Design Support library:
    +
    +
      +
    • Added {@link android.support.design.widget.TextInputLayout} for showing + {@link android.widget.EditText} hint and error text as floating labels. +
      • +
    • Added {@link android.support.design.widget.FloatingActionButton} for implementing a + primary action on your interface as a + floating action button, supporting either default or mini sizes. +
      • +
    • Added {@link android.support.design.widget.Snackbar} for providing lightweight + feedback with an optional action in an animated snackbar. +
      • +
    • Added {@link android.support.design.widget.TabLayout} for implementing fixed and + scrollable + tabs as well as easy + integration with + {@link android.support.v4.view.ViewPager}. +
      • +
    • Added {@link android.support.design.widget.NavigationView} for implementing + navigation drawer + contents, including the ability to inflate menu items via a + Menu Resource. +
      • +
    • Added {@link android.support.design.widget.CoordinatorLayout}, a general purpose + layout, used for building dependencies between + sibling views and allowing easy scrolling reactions between components via + {@link android.support.design.widget.CoordinatorLayout.Behavior}. Many of the Design + Library components rely on being a child of a + {@link android.support.design.widget.CoordinatorLayout}. +
      • +
    • Added {@link android.support.design.widget.AppBarLayout}, a container for a + {@link android.widget.Toolbar} + and other views (such as {@link android.support.design.widget.TabLayout}) for + reacting to scrolling events by scrolling off the screen, becoming visible in reaction + to a downward scroll, or collapsing/uncollapsing before scrolling off/onto the screen. +
      • +
    • Added {@link android.support.design.widget.CollapsingToolbarLayout} for controlling + how a {@link android.widget.Toolbar} collapses. A toolbar may collapse by: + pinning components to the top of the screen while it collapses, introducing + parallax scrolling of components such as an {@link android.widget.ImageView}, + or adding a content scrim color when the view is partially collapsed. +
      • +
    + + + + +
    Changes for v4 support library:
    +
    +
      + +
    • Added the +{@link android.support.v4.view.accessibility.AccessibilityEventCompat#getContentChangeTypes getContentChangeTypes()} + and +{@link android.support.v4.view.accessibility.AccessibilityEventCompat#setContentChangeTypes setContentChangeTypes()} + methods and related change type + fields to the + {@link android.support.v4.view.accessibility.AccessibilityEventCompat} + class for accessibility event handling. +
      • +
    • Added the +{@link android.support.v4.media.session.PlaybackStateCompat#getActiveQueueItemId getActiveQueueItemId()}, +{@link android.support.v4.media.session.PlaybackStateCompat#getCustomActions getCustomActions()}, + and + {@link android.support.v4.media.session.PlaybackStateCompat#getExtras getExtras()} + methods with related state fields to the + {@link android.support.v4.media.session.PlaybackStateCompat} class for + getting custom actions from the queue. +
      • +
    • Added the +{@link android.support.v4.media.session.PlaybackStateCompat.Builder#addCustomAction addCustomAction()}, +{@link android.support.v4.media.session.PlaybackStateCompat.Builder#addCustomAction addCustomAction()}, +{@link android.support.v4.media.session.PlaybackStateCompat.Builder#setActiveQueueItemId setActiveQueueItemId()}, + and + {@link android.support.v4.media.session.PlaybackStateCompat.Builder#setExtras setExtras()} + methods to the + {@link android.support.v4.media.session.PlaybackStateCompat.Builder} class for adding + adding custom actions to a playback state. +
      • +
    • Added the +{@link android.support.v4.media.session.PlaybackStateCompat.CustomAction#fromCustomAction fromCustomAction()} and +{@link android.support.v4.media.session.PlaybackStateCompat.CustomAction#getCustomAction getCustomAction()} methods + to the + {@link android.support.v4.media.session.PlaybackStateCompat.CustomAction} class + for getting custom actions from the queue. +
      • +
    • Added the {@link android.support.v4.view.ViewCompat#isAttachedToWindow isAttachedToWindow()}, + {@link android.support.v4.view.ViewCompat#offsetLeftAndRight offsetLeftAndRight()}, and + {@link android.support.v4.view.ViewCompat#offsetTopAndBottom offsetTopAndBottom()} + methods to the {@link android.support.v4.view.ViewCompat} class for working with views. +
      • +
    • Added the {@link android.support.v4.view.ViewPager#addOnPageChangeListener addOnPageChangeListener()}, + {@link android.support.v4.view.ViewPager#clearOnPageChangeListeners clearOnPageChangeListeners()}, and + {@link android.support.v4.view.ViewPager#removeOnPageChangeListener removeOnPageChangeListener()} + methods to the {@link android.support.v4.view.ViewPager} class for responding to page + changes. +

      Deprecated the + {@link android.support.v4.view.ViewPager#setOnPageChangeListener setOnPageChangeListener()} method.

      +
      • +
    • Added the +{@link android.support.v4.view.ViewParentCompat#notifySubtreeAccessibilityStateChanged notifySubtreeAccessibilityStateChanged()} method to + the {@link android.support.v4.view.ViewParentCompat} class for notifying a view parent + that the accessibility state of one of its descendants has changed. +
      • +
    • Added the {@link android.support.v4.view.ViewPropertyAnimatorCompat#translationZ translationZ()}, + {@link android.support.v4.view.ViewPropertyAnimatorCompat#translationZBy translationZBy()}, + {@link android.support.v4.view.ViewPropertyAnimatorCompat#z z()}, and + {@link android.support.v4.view.ViewPropertyAnimatorCompat#zBy zBy()} + methods to the {@link android.support.v4.view.ViewPropertyAnimatorCompat} class for + adding animation. +
      • +
    +
    + + + +
    Changes for v7 appcompat library:
    +
    +
      +
    • Added the + {@link android.support.v7.app.AppCompatActivity#onWindowStartingSupportActionMode onWindowStartingSupportActionMode()} + method to the + {@link android.support.v7.app.AppCompatActivity}, + {@link android.support.v7.app.AppCompatCallback}, and + {@link android.support.v7.app.AppCompatDialog} classes for handling action modes + started from the current window. +
      • + +
    • Added the +{@link android.support.v7.app.AppCompatDelegate#isHandleNativeActionModesEnabled isHandleNativeActionModesEnabled()} and +{@link android.support.v7.app.AppCompatDelegate#setHandleNativeActionModesEnabled setHandleNativeActionModesEnabled()} + methods to the + {@link android.support.v7.app.AppCompatDelegate} class for handling native action modes. +
      • +
    +
    + + +
    + +
    +
    + + + + + +
    +

    + Android Support Library, revision 22.1.0 (April 2015)

    + + + +
    +
    + +
    +
    Changes for annotations library:
    +
    +
      +
    • Added the Annotations library to provide support for enhanced code inspections. + Annotations are added as metadata tags that you attach to variables, parameters, + and return values to inspect method return values, passed parameters, and local + variables and fields. +
      • +
    +
    + +
    Changes for v4 support library:
      @@ -132,7 +306,7 @@ page.title=Support Library
    • Updated the {@link android.support.v4.view.accessibility.AccessibilityNodeInfoCompat} class to add methods for errors, content invalidation and labels.
      • -
    • Added the following interpolation classses for animation: +
    • Added the following interpolation classes for animation: {@link android.support.v4.view.animation.FastOutLinearInInterpolator}, {@link android.support.v4.view.animation.FastOutSlowInInterpolator}, {@link android.support.v4.view.animation.LinearOutSlowInInterpolator}, @@ -245,7 +419,7 @@ page.title=Support Library
    -
    Changes for v8 renderscript library:
    +
    Changes for v8 renderscript library:
    • Added the {@link android.support.v8.renderscript.ScriptIntrinsicHistogram} class for @@ -643,7 +817,7 @@ page.title=Support Library
    -
    Changes for v8 renderscript library:
    +
    Changes for v8 renderscript library
    • Added error propagation for the RenderScript thunking layer.
      • -- cgit v1.2.3-59-g8ed1b