Docs: Added Android Support Library 23.2 Release Notes
Bug: 26448279 Change-Id: I7549f87a374a3c2f632e31b8da9cac8394e5c9e6
This commit is contained in:
Adarsh Fernando
@@ -59,8 +59,365 @@ page.title=Support Library
|
|||||||
<p>This section provides details about the Support Library package releases.</p>
|
<p>This section provides details about the Support Library package releases.</p>
|
||||||
|
|
||||||
<div class="toggle-content opened">
|
<div class="toggle-content opened">
|
||||||
<p id="rev23"><a href="#" onclick="return toggleContent(this)">
|
<p id="rev23-2-0">
|
||||||
<img src="{@docRoot}assets/images/triangle-opened.png" class="toggle-content-img" alt=""
|
<a href="#" onclick="return toggleContent(this)"><img src=
|
||||||
|
"{@docRoot}assets/images/triangle-opened.png" class="toggle-content-img"
|
||||||
|
alt="">Android Support Library, revision 23.2.0</a> <em>(February
|
||||||
|
2016)</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 MediaBrowserCompat} for {@link
|
||||||
|
android.media.browse.MediaBrowser} support, and {@code
|
||||||
|
MediaBrowserServiceCompat} for {@link
|
||||||
|
android.service.media.MediaBrowserService} support. This is useful
|
||||||
|
when connecting a media app’s background service with UI components,
|
||||||
|
and integrating with Android Auto and Android Wear without requiring
|
||||||
|
API level 21 or higher.
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>The system now calls {@link
|
||||||
|
android.support.v4.app.FragmentActivity#onActivityResult onActivityResult()} for a
|
||||||
|
nested {@link android.support.v4.app.FragmentActivity}.
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</dd>
|
||||||
|
|
||||||
|
<dt>
|
||||||
|
Changes for <a href="features.html#v7-appcompat">v7 AppCompat
|
||||||
|
library</a>:
|
||||||
|
</dt>
|
||||||
|
|
||||||
|
<dd>
|
||||||
|
<ul>
|
||||||
|
<li>Added Night Mode functionality to API level 14 and higher. Switch
|
||||||
|
between <a href="{@docRoot}training/material/theme.html">Material
|
||||||
|
Light and Material Dark Themes</a> based on the time of day or
|
||||||
|
app-specific setting.
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li style="list-style: none; display: inline">
|
||||||
|
<ul>
|
||||||
|
<li>Day and night themes can be found here: {@code
|
||||||
|
<sdk>/extras/android/support/v7/appcompat/res/values/themes_daynight.xml}
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>{@code AppCompatDelegate.setDefaultNightMode()}: sets the
|
||||||
|
app’s default mode by passing one of the following constants:
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li style="list-style: none; display: inline">
|
||||||
|
<ul>
|
||||||
|
<li>{@code MODE_NIGHT_AUTO}
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>{@code MODE_NIGHT_NO}
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>{@code MODE_NIGHT_YES}
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>{@code MODE_NIGHT_FOLLOW_SYSTEM}
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>{@code AppCompatDelegate.setLocalNightMode()}: overrides
|
||||||
|
the night mode setting for the local app component.
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>{@code AppCompatDelegate.getDefaultNightMode()}: returns
|
||||||
|
the default night mode.
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</dd>
|
||||||
|
|
||||||
|
<dt>
|
||||||
|
Changes for <a href="features.html#v7-mediarouter">v7 mediarouter
|
||||||
|
library</a>:
|
||||||
|
</dt>
|
||||||
|
|
||||||
|
<dd>
|
||||||
|
<ul>
|
||||||
|
<li>{@link android.support.v7.app.MediaRouteControllerDialog} now
|
||||||
|
correctly applies custom app theme colors.
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</dd>
|
||||||
|
|
||||||
|
<dt>
|
||||||
|
Changes for <a href="features.html#design">Design support library</a>:
|
||||||
|
</dt>
|
||||||
|
|
||||||
|
<dd>
|
||||||
|
<ul>
|
||||||
|
<li>Added support for <a href=
|
||||||
|
"https://www.google.com/design/spec/components/bottom-sheets.html">bottom
|
||||||
|
sheets</a>. An interaction plugin, {@code
|
||||||
|
BottomSheetBehavior}, allows a child view of a {@link
|
||||||
|
android.support.design.widget.CoordinatorLayout} to act as
|
||||||
|
a bottom sheet. The base class, {@code BottomSheetCallback}, provides
|
||||||
|
callbacks to monitor bottom sheet events.
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</dd>
|
||||||
|
|
||||||
|
<dt>
|
||||||
|
Changes for the <a href="features.html#custom-tabs">CustomTabs support
|
||||||
|
library</a>:
|
||||||
|
</dt>
|
||||||
|
|
||||||
|
<dd>
|
||||||
|
<ul>
|
||||||
|
<li>
|
||||||
|
<a href=
|
||||||
|
"https://developer.chrome.com/multidevice/android/customtabs">Chrome
|
||||||
|
Custom Tabs</a> now allows apps to include a bottom bar with action
|
||||||
|
buttons in addition to the existing top action button.
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>{@code CustomTabsIntent.Builder.addToolBarItem()}: adds an action
|
||||||
|
button to a custom tab. You can use this to add multiple buttons.
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>{@code CustomTabsSession.setToolBarItem()}: updates the visuals
|
||||||
|
for toolbar items. This method will only succeed if it is given a
|
||||||
|
valid id and the browser session is in the foreground.
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</dd>
|
||||||
|
|
||||||
|
<dt>
|
||||||
|
Added VectorDrawable support library:
|
||||||
|
</dt>
|
||||||
|
|
||||||
|
<dd>
|
||||||
|
<ul>
|
||||||
|
<li>Added Classes:
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li style="list-style: none; display: inline">
|
||||||
|
<ul>
|
||||||
|
<li>{@code VectorDrawableCompat}
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>{@code AnimatedVectorDrawableCompat}
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Adds support for {@link
|
||||||
|
android.graphics.drawable.VectorDrawable} assets to apps
|
||||||
|
running on API level 7 or higher. {@link
|
||||||
|
android.graphics.drawable.AnimatedVectorDrawable} assets
|
||||||
|
are also supported on API level 11 or higher. Vector assets can be
|
||||||
|
considerably smaller than image assets and should help reduce app
|
||||||
|
size by reducing the amount of assets required to support multiple
|
||||||
|
device screens.
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>This library is now a dependency of the <a href=
|
||||||
|
"features.html#v7-appcompat">v7 AppCompat library</a>, allowing
|
||||||
|
developers and <a href="features.html#v7-appcompat">AppCompat </a>
|
||||||
|
to easily use vector drawables. To use {@code
|
||||||
|
VectorDrawableCompat} within an {@link android.widget.ImageButton} or
|
||||||
|
{@link android.widget.ImageView}, use the {@code app:srcCompat} XML
|
||||||
|
attribute or {@code setImageResource()}
|
||||||
|
method.
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>To keep referencing attribute IDs on API level 20 or
|
||||||
|
lower, add the following {@code appt} flag to your {@code
|
||||||
|
build,gradle} file:
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li style="list-style: none; display: inline">
|
||||||
|
<ul>
|
||||||
|
<li>If you are building with Android Plugin for Gradle 1.5.0 or
|
||||||
|
lower, add the following to your {@code build.gradle} file:
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li style="list-style: none; display: inline">
|
||||||
|
<pre>
|
||||||
|
android {
|
||||||
|
defaultConfig {
|
||||||
|
// Stops the Gradle’s automatic rasterization of vectors
|
||||||
|
generatedDensities = []
|
||||||
|
}
|
||||||
|
// Flag that tells aapt to keep the attribute ids
|
||||||
|
aaptOptions {
|
||||||
|
additionalParameters "--no-version-vectors"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
</pre>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>If you are building with Android Plugin for Gradle 2.0.0 or
|
||||||
|
higher, add the following to your {@code build.gradle} file:
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li style="list-style: none; display: inline">
|
||||||
|
<pre>
|
||||||
|
android {
|
||||||
|
defaultConfig {
|
||||||
|
vectorDrawables.useSupportLibrary = true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
</pre>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</dd>
|
||||||
|
|
||||||
|
<dt>
|
||||||
|
Changes for <a href="features.html#v17-leanback">v17 Leanback
|
||||||
|
Library</a>:
|
||||||
|
</dt>
|
||||||
|
|
||||||
|
<dd>
|
||||||
|
<ul>
|
||||||
|
<li>Added new capabilities to {@link android.support.v17.leanback.app.GuidedStepFragment},
|
||||||
|
which is a component that guides users through a decision or series of decisions:
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li style="list-style: none; display: inline">
|
||||||
|
<ul>
|
||||||
|
<li>Added button actions to {@link
|
||||||
|
android.support.v17.leanback.widget.GuidedAction}:
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<ul>
|
||||||
|
<li>{@code GuidedStepFragment.setButtonActions()}: sets a list of
|
||||||
|
{@link android.support.v17.leanback.widget.GuidedAction} buttons that
|
||||||
|
the user may select from the Actions view.
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Description fields are now editable:
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li style="list-style: none; display: inline">
|
||||||
|
<ul>
|
||||||
|
<li>{@code GuidedAction.Builder.descriptionEditable()}: when passing
|
||||||
|
{@code true}, sets the action’s description to be editable.
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>{@code GuidedAction.getEditDescription()}: returns the editable
|
||||||
|
description as a {@code CharSequence}.
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Added drop-down lists of sub-actions:
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li style="list-style: none; display: inline">
|
||||||
|
<ul>
|
||||||
|
<li>{@code GuidedAction.setSubActions()}: sets a {@link
|
||||||
|
android.support.v17.leanback.widget.GuidedAction} list as a drop-down
|
||||||
|
menu of sub-actions.
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<li>Added the {@code GuidedDatePickerAction} widget for {@link
|
||||||
|
android.widget.DatePicker} functionality:
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li style="list-style: none; display: inline">
|
||||||
|
<ul>
|
||||||
|
<li>The date is selected using year, month, and day columns and has a
|
||||||
|
customizable range.
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>{@code GuidedDatePickerAction.Builder}: builder class for the {@code
|
||||||
|
GuidedDatePickerAction} object.
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>{@code GuidedDatePickerAction.Builder.datePickerFormat(String
|
||||||
|
datePickerFormat)}: set the desired date format by passing the
|
||||||
|
appropriate three-character {@code String}, e.g. {@code “YMD”} or {@code
|
||||||
|
“MDY”}. Alternatively, use the {@code datePickerFormat} XML attribute.
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</dd>
|
||||||
|
</dl>
|
||||||
|
|
||||||
|
<dl>
|
||||||
|
<dt>
|
||||||
|
Changes for <a href="features.html#v7-recyclerview">v7 RecyclerView
|
||||||
|
library</a>:
|
||||||
|
</dt>
|
||||||
|
|
||||||
|
<dd>
|
||||||
|
<ul>
|
||||||
|
<li>{@link android.support.v7.widget.RecyclerView} now has an opt-in
|
||||||
|
feature called <em>AutoMeasure</em> which allows {@link
|
||||||
|
android.support.v7.widget.RecyclerView.LayoutManager} to easily wrap
|
||||||
|
content or handle various measurement specifications provided by the
|
||||||
|
parent of the {@link android.support.v7.widget.RecyclerView}. It
|
||||||
|
supports all existing animation capabilities of the {@link
|
||||||
|
android.support.v7.widget.RecyclerView}.
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li style="list-style: none; display: inline">
|
||||||
|
<ul>
|
||||||
|
<li>If you have a custom {@link
|
||||||
|
android.support.v7.widget.RecyclerView.LayoutManager},
|
||||||
|
call {@code setAutoMeasureEnabled(true)} to start using the new
|
||||||
|
AutoMeasure API. All built-in {@link
|
||||||
|
android.support.v7.widget.RecyclerView.LayoutManager} objects
|
||||||
|
enable auto-measure by default.
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>{@link android.support.v7.widget.RecyclerView.LayoutManager}
|
||||||
|
no longer ignores some {@link
|
||||||
|
android.support.v7.widget.RecyclerView.LayoutParams} settings,
|
||||||
|
such as {@code MATCH_PARENT} in the scroll direction.
|
||||||
|
<p class="note">
|
||||||
|
<strong>Note:</strong> These lifted restrictions may cause
|
||||||
|
unexpected behavior in your layouts. Make sure you specify
|
||||||
|
the correct layout parameters.
|
||||||
|
</p>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>When updating a {@link
|
||||||
|
android.support.v7.widget.RecyclerView.ViewHolder} with payload
|
||||||
|
information, {@link android.support.v7.widget.DefaultItemAnimator}
|
||||||
|
now disables change animations.
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>You can now modify the {@link
|
||||||
|
android.support.v7.widget.helper.ItemTouchHelper} escape velocity to
|
||||||
|
control swipe sensitivity. To make it easier or harder to swipe,
|
||||||
|
override {@code getSwipeEscapeVelocity(float defaultValue)} and modify {@code defaultValue}.
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</dd>
|
||||||
|
</dl>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<!-- end of collapsible section -->
|
||||||
|
|
||||||
|
<div class="toggle-content closed">
|
||||||
|
<p id="rev23-1-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.1.1</a> <em>(November 2015)</em>
|
/>Android Support Library, revision 23.1.1</a> <em>(November 2015)</em>
|
||||||
</p>
|
</p>
|
||||||
<div class="toggle-content-toggleme">
|
<div class="toggle-content-toggleme">
|
||||||
|
|||||||
Reference in New Issue
Block a user