Merge "docs: update Support Library links and release note b/24065341 b/23584577 b/24047203 b/24131953" into mnc-docs

This commit is contained in:
Cheryl Potter
2015-10-15 01:16:32 +00:00
committed by Android (Google) Code Review
2 changed files with 186 additions and 23 deletions

View File

@@ -38,6 +38,8 @@ page.title=Support Library Features
Support Library Revisions</a></li>
<li><a href="{@docRoot}tools/support-library/setup.html">
Support Library Setup</a></li>
<li><a href="{@docRoot}tools/testing-support-library/index.html">
Testing Support Library</a></li>
</ol>
</div>
@@ -53,7 +55,7 @@ page.title=Support Library Features
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
<p>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
@@ -151,7 +153,7 @@ numbers, can cause unexpected version updates and regression incompatibilities.<
<p>The Gradle build script dependency identifier for this library is as follows:</p>
<pre>
com.android.support:support-v4:21.0.0
com.android.support:support-v4:23.1.0
</pre>
@@ -236,7 +238,7 @@ resources</a>.</p>
<p>The Gradle build script dependency identifier for this library is as follows:</p>
<pre>
com.android.support:appcompat-v7:21.0.0
com.android.support:appcompat-v7:23.1.0
</pre>
@@ -257,7 +259,7 @@ libraries with resources</a>.</p>
<p>The Gradle build script dependency identifier for this library is as follows:</p>
<pre>
com.android.support:cardview-v7:21.0.0
com.android.support:cardview-v7:23.1.0
</pre>
@@ -279,7 +281,7 @@ For detailed information about the v7 gridlayout library APIs, see the
<p>The Gradle build script dependency identifier for this library is as follows:</p>
<pre>
com.android.support:gridlayout-v7:21.0.0
com.android.support:gridlayout-v7:23.1.0
</pre>
@@ -315,7 +317,7 @@ script dependency identifier <code>com.android.support:support-v7-mediarouter:&l
where "&lt;revision&gt;" is the minimum revision at which the library is available. For example:</p>
<pre>
com.android.support:mediarouter-v7:21.0.0
com.android.support:mediarouter-v7:23.1.0
</pre>
<p class="caution">The v7 mediarouter library APIs introduced in Support Library
@@ -341,7 +343,7 @@ resources</a>.</p>
<p>The Gradle build script dependency identifier for this library is as follows:</p>
<pre>
com.android.support:palette-v7:21.0.0
com.android.support:palette-v7:23.1.0
</pre>
@@ -350,8 +352,8 @@ com.android.support:palette-v7:21.0.0
<p>The recyclerview library adds the {@link android.support.v7.widget.RecyclerView}
class. This class provides support for the
<a href="{@docRoot}training/material/lists-cards#RecyclerView">RecyclerView
widget</a>, a view for efficiently displaying large data sets by providing a
<a href="{@docRoot}training/material/lists-cards.html">RecyclerView</a> widget, a view
for efficiently displaying large data sets by providing a
limited window of data items.</p>
<p>After you download the Android Support Libraries, this library is located in the
@@ -363,7 +365,7 @@ libraries with resources</a>.</p>
<p>The Gradle build script dependency identifier for this library is as follows:</p>
<pre>
com.android.support:recyclerview-v7:21.0.0
com.android.support:recyclerview-v7:23.1.0
</pre>
@@ -392,7 +394,7 @@ with resources</a>. </p>
<p>The Gradle build script dependency identifier for this library is as follows:</p>
<pre>
com.android.support:preference-v7:23.0.0
com.android.support:preference-v7:23.1.0
</pre>
@@ -456,7 +458,7 @@ resources</a>.</p>
<p>The Gradle build script dependency identifier for this library is as follows:</p>
<pre>
com.android.support:support-v13:18.0.0
com.android.support:support-v13:23.1.0
</pre>
@@ -488,7 +490,7 @@ resources</a>.</p>
<p>The Gradle build script dependency identifier for this library is as follows:</p>
<pre>
com.android.support:preference-v14:23.0.0
com.android.support:preference-v14:23.1.0
</pre>
@@ -517,7 +519,7 @@ resources</a>.</p>
<p>The Gradle build script dependency identifier for this library is as follows:</p>
<pre>
com.android.support:preference-v17:23.0.0
com.android.support:preference-leanback-v17:23.1.0
</pre>
@@ -559,7 +561,7 @@ with resources</a>. </p>
<p>The Gradle build script dependency identifier for this library is as follows:</p>
<pre>
com.android.support:leanback-v17:21.0.0
com.android.support:leanback-v17:23.1.0
</pre>
@@ -580,7 +582,7 @@ with resources</a>. </p>
<p>The Gradle build script dependency identifier for this library is as follows:</p>
<pre>
com.android.support:support-annotations:22.0.0
com.android.support:support-annotations:23.1.0
</pre>
@@ -605,7 +607,7 @@ with resources</a>. </p>
<p>The Gradle build script dependency identifier for this library is as follows:</p>
<pre>
com.android.support:design:22.2.0
com.android.support:design:23.1.0
</pre>
@@ -633,7 +635,7 @@ with resources</a>. </p>
<p>The Gradle build script dependency identifier for this library is as follows:</p>
<pre>
com.android.support:customtabs:23.0.0
com.android.support:customtabs:23.1.0
</pre>
@@ -664,7 +666,7 @@ with resources</a>. </p>
<p>The Gradle build script dependency identifier for this library is as follows:</p>
<pre>
com.android.support:percent:23.0.0
com.android.support:percent:23.1.0
</pre>
@@ -686,7 +688,7 @@ RecommendationExtender</a>. </p>
<p>After you download the Android Support Libraries, this library is located in the
{@code &lt;sdk&gt;/extras/android/support/customtabs} directory. For more information
{@code &lt;sdk&gt;/extras/android/support/recommendation} directory. For more information
on how to set up your project, follow the instructions in <a
href="{@docRoot}tools/support-library/setup.html#libs-with-res">Adding libraries
with resources</a>. </p>
@@ -694,5 +696,5 @@ with resources</a>. </p>
<p>The Gradle build script dependency identifier for this library is as follows:</p>
<pre>
com.android.support:app.recommendation-app:23.0.0
com.android.support:recommendation:23.1.0
</pre>

View File

@@ -59,10 +59,171 @@ page.title=Support Library
<p>This section provides details about the Support Library package releases.</p>
<div class="toggle-content opened">
<p id="rev23-0-1"><a href="#" onclick="return toggleContent(this)">
<p id="rev24-1-0"><a href="#" onclick="return toggleContent(this)">
<img src="{@docRoot}assets/images/triangle-opened.png" class="toggle-content-img" alt=""
/>Android Support Library, revision 24.1.0</a> <em>(October 2015)</em>
</p>
<div class="toggle-content-toggleme">
<dl>
<dt>Changes for <a href="features.html#v4">v4 Support library:</a></dt>
<dd>
<ul>
<li>Added <code>OnScrollChangedListener</code> interface support to the
<code>NestedScrollView</code> widget. It
allows you to receive callbacks when the scroll X or Y positions change.</li>
<li>Added a <code>MediaButtonReceiver</code> class to forward received playback controls
to a service thats managing the <code>MediaSessionCompat</code> class. The
<code>MediaSessionCompat</code> class has a
constructor that can automatically find a media button receiver in the manifest. A
media button receiver is a key part to <a href=
"http://developer.android.com/training/managing-audio/volume-playback.html#PlaybackControls">handling
playback controls</a> from hardware or bluetooth controls.</li>
</ul>
</dd>
<dt>Changes for <a href="features.html#v7-appcompat">v7 appcompat library:</a></dt>
<dd>
<ul>
<li>Added material design <code>Seekbar</code> and <code>ImageButton</code> widgets.</li>
<li>Updated the <code>ImageView</code> widget to support the tint feature.</li>
<li>Updated the look-and-feel of the <code>SwitchCompat</code> widget.</li>
</ul>
</dd>
<dt>Changes for <a href="features.html#v7-mediarouter">v7 mediarouter library:</a></dt>
<dd>
<ul>
<li>Added the following features to the <code>MediaRouteChooserDialog</code> class:</li>
<ul>
<li>Displays a loading page while discovering media route providers.</li>
<li>Includes a device type icon for easier device identification.</li>
<li>Sorts the routes according to frequency of use in the current app.</li>
<li>Supports landscape mode.</li>
</ul>
</ul>
<ul>
<li>Added the following features to the <code>MediaRouteControllerDialog</code> class:</li>
<ul>
<li>Recognizes screen casting and provides a proper description.</li>
<li>Supports various album art sizes and aspect ratios, and loads the art asynchronously.</li>
<li>Automatically selects the content color based on the primary color of the app.</li>
<li>Adjusts the dialog layout based on available screen space on the device.</li>
<li>Supports landscape mode.</li>
</ul>
</ul>
</dd>
<dt>Changes for <a href="features.html#v7-palette">v7 palette library:</a></dt>
<dd>
<ul>
<li>Added the <code>setRegion()</code> method to support extracting color from a specific
region of a <code>Bitmap</code> object.</li>
</ul>
</dd>
<dt>Changes for <a href="features.html#v7-recyclerview">v7 recyclerview library:</a></dt>
<dd>
<ul>
<li>Added an improved animation API to the <code>ItemAnimator</code> class for better
customizations:</li>
<ul>
<li>Change animations no longer enforce two copies of the <code>ViewHolder</code> object,
which enables item content animations. Also, the <code>ItemAnimator</code> object
decides whether it wants to reuse the same <code>ViewHolder</code> object or create a
new one.</li>
<li>The new information record API gives the <code>ItemAnimator</code> class the flexibility
to collect data at the correct point in the layout lifecycle. This information is later
passed into the animate callbacks.</li>
</ul>
</ul>
<ul>
<li>Provided an easy transition plan for this backward-incompatible API change:</li>
<ul>
<li>If youve previously extended the <code>ItemAnimator</code> class, you can change
your base class to <code>SimpleItemAnimator</code> and your code should work as before.
The <code>SimpleItemAnimator</code> class provides the old API by wrapping the new API.</li>
<li>Some methods were removed from the <code>ItemAnimator</code> class. The following
code will no longer compile:</li>
<pre>recyclerView.getItemAnimator().setSupportsChangeAnimations(false)</pre>
<p>You can replace it with:</p>
<pre>
ItemAnimator animator = recyclerView.getItemAnimator();
if (animator instanceof SimpleItemAnimator) {
((SimpleItemAnimator) animator).setSupportsChangeAnimations(false);
}
</pre>
</ul>
</ul>
</dd>
<dt>Changes for <a href="features.html#v7-preference">v7</a>,
<a href="features.html#v14-preference">v14</a>, and
<a href="features.html#v17-preference">v17</a> Preference Support library:</dt>
<dd>
<ul>
<li>Removed APIs for controlling <code>EditText</code> dialogs.</li>
</ul>
</dd>
<dt>Changes for <a href="features.html#v17-leanback">v17 Leanback Support library:</a></dt>
<dd>
<ul>
<li>Added a version of the <code>GuidedStepFragment</code> class for the Support library
(extends <code>android.support.v4.app.Fragment</code>), and improved animations and
transitions.</li>
<li>Updated the <code>GuidedStepFragment</code> class so it can be placed on top of
existing content.</li>
<li>Added the ability to annotate different types of search completions to the
<code>SearchFragment</code> class.</li>
<li>Added staggered slide transition support to the <code>VerticalGridFragment</code>
class.</li>
</ul>
</dd>
<dt>Changes for <a href="features.html#design">Design Support library:</a></dt>
<dd>
<ul>
<li>Added <a href=
"https://www.google.com/design/spec/components/text-fields.html#text-fields-character-counter">
character counting</a> support to the <code>TextInputLayout</code> widget.</li>
<li>Added edge snapping support to the <code>AppBarLayout</code> class by adding the
<code>SCROLL_FLAG_SNAP</code> constant. When scrolling ends, if the view is only
partially visible, the view is snapped and scrolled to its closest edge.</li>
<li>Added support for custom views to the <code>NavigationView</code> class by using the
<code>app:actionLayout</code> attribute or <code>MenuItemCompat.setActionView()</code>
method.</li>
</ul>
</dd>
<dt>Changes for <a href="features.html#custom-tabs">Custom Tabs Support library:</a></dt>
<dd>
<ul>
<li>Added the <code>enableUrlBarHiding()</code> method to the <code>CustomTabsIntent</code>
class. It lets the client customize whether the URL bar should be hidden automatically
on scroll down.</li>
<li>Added the <code>setActionButton()</code> method to the <code>CustomTabsSession</code>
class. It lets the client
change the icon for a custom action button in an already launched custom tab.</li>
<li>Added the <code>TAB_SHOWN</code> and <code>TAB_HIDDEN</code> constants as new events
for the <code>onNavigationEvent</code> method of the <code>CustomTabsCallback</code>
class.</li>
</ul>
</dd>
</dl>
</div>
</div> <!-- end of collapsible section -->
<div class="toggle-content closed">
<p id="rev23-0-1"><a href="#" onclick="return toggleContent(this)">
<img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt=""
/>Android Support Library, revision 23.0.1</a> <em>(September 2015)</em>
</p>
<div class="toggle-content-toggleme">