blob: 3afd7ac1651f4114e5e86b2823474c0a47455d59 [file] [log] [blame]
Scott Main50e990c2012-06-21 17:14:39 -07001page.title=Support Library
2
3@jd:body
4
5<div id="qv-wrapper">
Joe Fernandez5ffbba62013-07-15 15:53:03 -07006 <div id="qv">
Scott Main50e990c2012-06-21 17:14:39 -07007
Joe Fernandez5ffbba62013-07-15 15:53:03 -07008 <h2>In this document</h2>
9 <ol>
10 <li><a href="#overview">Overview</a></li>
11 <li><a href="#revisions">Revisions</a></li>
12 </ol>
Scott Main50e990c2012-06-21 17:14:39 -070013
Joe Fernandez5ffbba62013-07-15 15:53:03 -070014 <h2>See also</h2>
15 <ol>
16 <li><a href="{@docRoot}tools/support-library/features.html">
17 Support Library Features</a></li>
18 <li><a href="{@docRoot}tools/support-library/setup.html">
19 Support Library Setup </a></li>
20 </ol>
Scott Main50e990c2012-06-21 17:14:39 -070021
Joe Fernandez5ffbba62013-07-15 15:53:03 -070022 </div>
Scott Main50e990c2012-06-21 17:14:39 -070023</div>
24
Dirk Dougherty37ec33742013-07-29 20:44:17 -070025<p>The Android Support Library package is a set of code libraries that provide
Joe Fernandeza9a65c62013-07-23 23:24:13 -070026 backward-compatible versions of Android framework APIs as well as features that are only available
27 through the library APIs. Each Support Library is backward-compatible to a specific Android API
28 level. This design means that your applications can use the libraries' features and still be
29 compatible with devices running Android 1.6 (API level 4) and up.</p>
Scott Main50e990c2012-06-21 17:14:39 -070030
Joe Fernandeza9a65c62013-07-23 23:24:13 -070031<p>This guide provides information about what features are enabled by the Support Libraries,
32 how to use them in your development environment and information about library releases.</p>
Scott Main50e990c2012-06-21 17:14:39 -070033
34
Joe Fernandez5ffbba62013-07-15 15:53:03 -070035<h2 id="overview">Overview</h2>
Scott Main50e990c2012-06-21 17:14:39 -070036
Joe Fernandez5ffbba62013-07-15 15:53:03 -070037<p>Including the Support Libraries in your Android project is considered a best practice for
Dirk Dougherty37ec33742013-07-29 20:44:17 -070038 application developers, depending on the range of platform versions your app is targeting
Andrew Solovayd86f02b2016-04-05 14:16:08 -070039 and the APIs that it uses. Using the features the libraries provide can help you improve the look
40 of your application, increase performance and broaden the reach of your application to more users.
Joe Fernandez5ffbba62013-07-15 15:53:03 -070041 If you use the Android
42 <a href="{@docRoot}tools/projects/templates.html">code template</a> tools, you will notice that
43 all the Android application templates include one or more of the Support Libraries by default.</p>
44
45<p>The Support Libraries each target a base Android API level and each provides a different set
46 of features. In order to effectively use the libraries, it is important to consider what features
47 you want to support and understand what features are supported by each library at what Android
48 API level. To get started, review the
49 <a href="{@docRoot}tools/support-library/features.html">Support Library Features</a> guide.
50 After that, go to the
51 <a href="{@docRoot}tools/support-library/setup.html">Support Library Setup</a> topic to
52 learn how to incorporate the Support Libraries into your application. For more details
53 about Support Library APIs, see the {@link android.support.v4.app android.support}
54 packages in the API reference.</p>
55
56
57<h2 id="revisions">Revisions</h2>
58
59<p>This section provides details about the Support Library package releases.</p>
Scott Main50e990c2012-06-21 17:14:39 -070060
Rich Slogar4575cad2015-05-27 13:03:14 -070061<div class="toggle-content opened">
Andrew Solovayd86f02b2016-04-05 14:16:08 -070062 <p id="rev23-3-0">
Trevor Johns682c24e2016-04-12 10:13:47 -070063 <a href="#" onclick="return toggleContent(this)"><img src=
64 "{@docRoot}assets/images/styles/disclosure_up.png" class="toggle-content-img"
Andrew Solovayd86f02b2016-04-05 14:16:08 -070065 alt="">Android Support Library, revision 23.3.0</a> <em>(April
66 2016)</em>
67 </p>
68
69 <div class="toggle-content-toggleme">
70 <dl>
71 <dt>
72 Changes for <a href=
73 "{@docRoot}tools/support-library/features.html#v4">v4 Support
74 Library</a>:
75 </dt>
76
77 <dd>
78 <ul>
79 <li>Added <code>AppLaunchChecker</code> to help track how your app
80 has been launched by the user in the past.
81 <code>hasStartedFromLauncher()</code> lets you know if the user has
82 launched your app from the home screen before, or if it has only
83 been started by other means (for example, to view specific web
84 URLs).
85 </li>
86
87 <li>Fixed a memory leak in
88 <code>MediaBrowserServiceCompat.mConnections</code>. (<a class=
89 "external-link" href=
90 "https://code.google.com/p/android/issues/detail?id=205220">Issue
91 205220</a>)
92 </li>
93
94 <li>Fixed issue where {@link android.support.v4.view.ViewPager}
95 does not account for page margins when flipping page. (<a class=
96 "external-link" href=
97 "https://code.google.com/p/android/issues/detail?id=203816">Issue
98 203816</a>)
99 </li>
100 <li>{@link android.support.v4.app.Fragment#onRequestPermissionsResult
101 Fragment.onRequestPermissionsResult()} is now delivered to child
102 fragments.
103 </li>
104 </ul>
105 </dd>
106
107
108 <dt>
109 Changes for <a href=
110 "{@docRoot}tools/support-library/features.html#v7-appcompat">v7
111 appcompat library</a>:
112 </dt>
113
114 <dd>
115 <ul>
116 <li>Fixed an issue in {@link
117 android.support.v7.widget.AppCompatSpinner} that could cause
118 multiple popups to appear. (<a class="external-link" href=
119 "https://code.google.com/p/android/issues/detail?id=205052">Issue
120 205052</a>)
121 </li>
122
123 <li>Fixed an issue with how borderless buttons were colored.
124 (<a class="external-link" href=
125 "https://code.google.com/p/android/issues/detail?id=202967">Issue
126 202967</a>)
127 </li>
128
129 <li>Fixed a compatibility issue between {@link
130 android.support.v7.app.AppCompatDialogFragment } and {@link
131 android.support.v7.app.AlertDialog}. (<a class="external-link"
132 href="https://code.google.com/p/android/issues/detail?id=204805">Issue
133 204805</a>)
134 </li>
135
136 <li>Reverted changes to <code>TintResources</code> that were causing
137 memory and configuration issues. (<a class="external-link"
138 href="https://code.google.com/p/android/issues/detail?id=205236">Issue
139 205236</a>)</li>
140 </ul>
141 </dd>
142
143
144 <dt>
145 Changes for <a href=
146 "{@docRoot}tools/support-library/features.html#v7-mediarouter">v7
147 mediarouter library</a>:
148 </dt>
149
150 <dd>
151 <ul>
152 <li>Fixed {@link android.support.v7.app.MediaRouteControllerDialog}
153 volume slider’s behavior. (<a class="external-link" href=
154 "https://code.google.com/p/android/issues/detail?id=202299">Issue
155 202299</a>)
156 </li>
157 </ul>
158 </dd>
159
160
161 <dt>
162 Changes for <a href="features.html#v7-preference">v7 Preference</a>
163 library:
164 </dt>
165
166 <dd>
167 <ul>
168 <li>Fixed issue where {@link
169 android.support.v7.preference.PreferenceFragmentCompat} would crash
170 if <code>dividerHeight</code> is specified. (<a class=
171 "external-link" href=
172 "https://code.google.com/p/android/issues/detail?id=204778">Issue
173 204778</a>)
174 </li>
175 </ul>
176 </dd>
177
178
179 <dt>
180 Changes for <a href=
181 "{@docRoot}tools/support-library/features.html#v7-recyclerview">v7
182 recyclerview library</a>:
183 </dt>
184
185 <dd>
186 <ul>
187 <li>Fixed a bug where {@link
188 android.support.v7.widget.RecyclerView} would not invoke scroll
189 callbacks if the range of visible items shrank. (<a class=
190 "external-link" href=
191 "https://code.google.com/p/android/issues/detail?id=200987">Issue
192 200987</a>)
193 </li>
194
195 <li>Fixed a bug where {@link
196 android.support.v7.widget.RecyclerView} would freeze if it was in
197 linear layout, was weighted, and contained images. (<a class=
198 "external-link" href=
199 "https://code.google.com/p/android/issues/detail?id=203276">Issue
200 203276</a>)
201 </li>
202
203 <li>Fixed a crash in {@link
204 android.support.v7.widget.OrientationHelper#getStartAfterPadding
205 OrientationHelper.getStartAfterPadding()}. (<a class=
206 "external-link" href=
207 "https://code.google.com/p/android/issues/detail?id=180521">Issue
208 180521</a>)
209 </li>
210
211 <li>Fixed a crash with usages of
212 <code>android:nestedScrollingEnabled</code>. (<a class=
213 "external-link" href=
214 "https://code.google.com/p/android/issues/detail?id=197932">Issue
215 197932</a>)
216 </li>
217 </ul>
218 </dd>
219
220
221 <dt>
222 Changes for <a href=
223 "{@docRoot}tools/support-library/features.html#design">Design Support
224 Library</a>:
225 </dt>
226
227 <dd>
228 <ul>
229 <li>Fixed a bug where a hidden bottom sheet would handle touch
230 events. (<a class="external-link" href=
231 "https://code.google.com/p/android/issues/detail?id=203654">Issue
232 203654</a>)
233 </li>
234
235 <li>Fixed a layout issue with <code>BottomSheetBehavior</code> when
236 <code>fitsSystemWindows</code> is true. (<a class="external-link"
237 href=
238 "https://code.google.com/p/android/issues/detail?id=203057">Issue
239 203057</a>)
240 </li>
241
242 <li>Fixed an accessibility issue with {@link
243 android.support.design.widget.Snackbar}. (<a class="external-link"
244 href=
245 "https://code.google.com/p/android/issues/detail?id=182145">Issue
246 182145</a>)
247 </li>
248
249 <li>Fixed a crash on {@link android.support.design.widget.Snackbar}
250 swipe. (<a class="external-link" href=
251 "https://code.google.com/p/android/issues/detail?id=203924">Issue
252 203924</a>)
253 </li>
254
255 <li>Fixed a bug in {@link
256 android.support.design.widget.AppBarLayout} with
257 <code>enterAlways</code>. (<a class="external-link" href=
258 "https://code.google.com/p/android/issues/detail?id=203661">Issue
259 203661</a>)
260 </li>
261
262 <li>Fixed a bug where {@link
263 android.support.design.widget.TextInputLayout} unnecessarily clears
264 {@link android.widget.EditText} object's background color filter.
265 (<a class="external-link" href=
266 "https://code.google.com/p/android/issues/detail?id=203357">Issue
267 203357</a>)
268 </li>
269 </ul>
270 </dd>
271
272 </dl>
273 </div>
274</div>
275<!-- end of collapsible section: 23.3.0 -->
276
277<div class="toggle-content closed">
278 <p id="rev23-2-1">
279 <a href="#" onclick="return toggleContent(this)"><img src=
280 "{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img"
Trevor Johns682c24e2016-04-12 10:13:47 -0700281 alt="">Android Support Library, revision 23.2.1</a> <em>(March
282 2016)</em>
283 </p>
284
285 <div class="toggle-content-toggleme">
286 <dl>
287 <dt>
288 Changes for <a href=
289 "{@docRoot}tools/support-library/features.html#v4">v4 Support
290 Library</a>:
291 </dt>
292
293 <dd>
294 <ul>
295 <li>Fixed an exception in {@link
296 android.support.v4.graphics.drawable.DrawableCompat#wrap
297 DrawableCompat.wrap()} and {@link android.graphics.drawable.LayerDrawable} on
298 API levels 17 to 19. (<a class="external-link" href=
299 "https://code.google.com/p/android/issues/detail?id=201817">Issue 201817</a>)
300 </li>
301
302 <li>Fixed an {@code ArrayIndexOutOfBoundsException} in {@link
303 android.support.v4.widget.ViewDragHelper#shouldInterceptTouchEvent
304 ViewDragHelper.shouldInterceptTouchEvent()}. (<a class="external-link"
305 href="https://code.google.com/p/android/issues/detail?id=182262">Issue
306 182262</a>)
307 </li>
308
309 <li>Fixed a bug in {@link android.support.v4.view.ViewPager} related to
310 scroll calculation for size changes.
311 </li>
312
313 <li>Fixed a {@code NullPointerException} when {@code
314 DrawerLayout.removeDrawerListener()} is called without a set {@link
315 android.support.v4.widget.DrawerLayout.DrawerListener
316 DrawerLayout.DrawerListener}. (<a class="external-link" href=
317 "https://code.google.com/p/android/issues/detail?id=202478">Issue 202478</a>)
318 </li>
319
320 <li>Fixed a bug where {@link android.support.v4.view.ViewPager} does not set
321 {@link android.view.accessibility.AccessibilityEvent} parameters properly
322 when scrolling.
323 </li>
324
325 <li>Fixed an issue that caused lag during device rotation when using
326 {@link android.support.v4.graphics.drawable.DrawableCompat#wrap
327 Drawable.wrap()}. (<a class="external-link" href=
328 "https://code.google.com/p/android/issues/detail?id=201924">Issue 201924</a>)
329 </li>
330 </ul>
331 </dd>
332
333 <dt>
334 Changes for <a href=
335 "{@docRoot}tools/support-library/features.html#v7-appcompat">v7
336 appcompat library</a>:
337 </dt>
338
339 <dd>
340 <ul>
341 <li>Reverted dependency on vector assets so that developers using the
342 <a href="{@docRoot}tools/support-library/features.html#v7-appcompat">appcompat
343 library</a> are not forced to use {@link
344 android.graphics.drawable.VectorDrawable} and its associated build flags.
345 </li>
346
347 <li>Fixed a compatibility issue with Night Mode and API level 23.
348 (<a class="external-link" href=
349 "https://code.google.com/p/android/issues/detail?id=201910">Issue
350 201910</a>)
351 </li>
352
353 <li>Fixed a compatibility issue with {@link
354 android.support.v7.widget.SwitchCompat} and API level 7. (<a class=
355 "external-link" href=
356 "https://code.google.com/p/android/issues/detail?id=201942">Issue 201942</a>)
357 </li>
358
359 <li>Fixed an issue with propagating configuration values in Resources objects
360 <a class="external-link" href=
361 "https://code.google.com/p/android/issues/detail?id=201928">Issue 201928</a>
362 </li>
363
364 <li>Fixed a compatibility issue where the {@link
365 android.support.v7.app.NotificationCompat.MediaStyle
366 NotificationCompat.MediaStyle} cancel button becomes invisible on API level
367 21 and below. (<a class="external-link" href=
368 "https://code.google.com/p/android/issues/detail?id=202156">Issue 202156</a>)
369 </li>
370
371 <li>Fixed a compatibility crash with {@link
372 android.support.v7.widget.AppCompatSpinner} on API level 21 and below.
373 (<a class="external-link" href=
374 "https://code.google.com/p/android/issues/detail?id=202246">Issue 202246</a>)
375 </li>
376
377 <li>Fixed an issue where the {@code app:textAllCaps = "false"} style did not
378 work. (<a class="external-link" href=
379 "https://code.google.com/p/android/issues/detail?id=202117">Issue 202117</a>)
380 </li>
381
382 <li>Fixed a crash when restoring {@link android.widget.SearchView}.
383 (<a class="external-link" href=
384 "https://code.google.com/p/android/issues/detail?id=201836">Issue
385 201836</a>)
386 </li>
387
388 <li>Fixed a memory leak that occurs when tinting drawable resources using
389 AppCompat. (<a class="external-link" href=
390 "https://code.google.com/p/android/issues/detail?id=202379">Issue 202379</a>)
391 </li>
392
393 <li>Fixed an issue with {@link android.view.KeyEvent} on API level 11 and
394 lower. (<a class="external-link" href=
395 "https://code.google.com/p/android/issues/detail?id=202939">Issue 202939</a>)
396 </li>
397 </ul>
398 </dd>
399
400 <dt>
401 Changes for <a href=
402 "{@docRoot}tools/support-library/features.html#v7-cardview">v7 cardview
403 library</a>:
404 </dt>
405
406 <dd>
407 <ul>
408 <li>Added Night Mode support for {@link
409 android.support.v7.widget.CardView}. (<a class="external-link"
410 href="https://code.google.com/p/android/issues/detail?id=194497">Issue
411 194497</a>)
412 </li>
413 </ul>
414 </dd>
415
416 <dt>
417 Changes for <a href=
418 "{@docRoot}tools/support-library/features.html#v7-recyclerview">v7
419 recyclerview library</a>:
420 </dt>
421
422 <dd>
423 <ul>
424 <li>Fixed bugs related to various measure-spec methods. (<a class=
425 "external-link" href=
426 "https://code.google.com/p/android/issues/detail?id=201856">Issue
427 201856</a>)
428 </li>
429
430 <li>Reduced the lockdown period in which {@link
431 android.support.v7.widget.RecyclerView} does not allow adapter
432 changes while calculating a layout or scroll. (<a class=
433 "external-link" href=
434 "https://code.google.com/p/android/issues/detail?id=202046">Issue
435 202046</a>)
436 </li>
437
438 <li>Fixed a crash when calling {@link
439 android.support.v7.widget.RecyclerView.Adapter#notifyItemChanged
440 notifyItemChanged()} on an item that is out of view. (<a class=
441 "external-link" href=
442 "https://code.google.com/p/android/issues/detail?id=202136">Issue
443 202136</a>)
444 </li>
445
446 <li>Fixed a crash that occurs when {@link
447 android.support.v7.widget.RecyclerView.LayoutManager
448 RecyclerView.LayoutManager} adds and removes a view in the same
449 measurement pass. (<a class="external-link" href=
450 "https://code.google.com/p/android/issues/detail?id=193958">Issue
451 193958</a>)
452 </li>
453 </ul>
454 </dd>
455
456 <dt>
457 Changes for <a href=
458 "{@docRoot}tools/support-library/features.html#v7-mediarouter">v7
459 mediarouter library</a>:
460 </dt>
461
462 <dd>
463 <ul>
464 <li>Fixed a crash that occurs when calling {@link
465 android.support.v7.media.MediaRouter#getInstance
466 MediaRouter.getInstance()} on API level 17. (<a class="external-link"
467 href=
468 "https://code.google.com/p/android/issues/detail?id=180654">Issue
469 180654</a>)
470 </li>
471 </ul>
472 </dd>
473
474 <dt>
475 Changes for <a href=
476 "{@docRoot}tools/support-library/features.html#v17-leanback">v17
477 Leanback Library</a>:
478 </dt>
479
480 <dd>
481 <ul>
482 <li>Fixed an issue with {@code GridLayout.onAddFocusables()} that
483 caused the wrong item to be selected.
484 </li>
485
486 <li>Fixed issue with {@link
487 android.support.v17.leanback.app.GuidedStepFragment} actions
488 disappearing after an action was collapsed.
489 </li>
490 </ul>
491 </dd>
492
493 <dt>
494 Changes for <a href=
495 "{@docRoot}tools/support-library/features.html#design">Design Support
496 Library</a>:
497 </dt>
498
499 <dd>
500 <ul>
501 <li>Fixed a {@link android.support.design.widget.TabLayout} crash
502 caused by tab-pooling. (<a class="external-link" href=
503 "https://code.google.com/p/android/issues/detail?id=201827">Issue
504 201827</a>)
505 </li>
506
507 <li>Fixed a bug in {@link
508 android.support.design.widget.NavigationView} that caused the wrong
509 color to be selected. (<a class="external-link" href=
510 "https://code.google.com/p/android/issues/detail?id=201951">Issue
511 201951</a>)
512 </li>
513
514 <li>Fixed a bug where {@link
515 android.support.design.widget.FloatingActionButton#setBackgroundTintList
516 setBackgroundTintList()} was no longer able to change the background
517 color. (<a class="external-link" href=
518 "https://code.google.com/p/android/issues/detail?id=201873">Issue
519 201873</a>)
520 </li>
521
522 <li>Fixed an issue where {@link
523 android.support.design.widget.AppBarLayout} did not completely scroll
524 out of view when used with {@code android:fitsSystemWindows = “true”}.
525 (<a class="external-link" href=
526 "https://code.google.com/p/android/issues/detail?id=201822">Issue
527 201822</a>)
528 </li>
529
530 <li>Fixed an issue where {@code BottomSheetDialog} did not display
531 short content views correctly. (<a class="external-link" href=
532 "https://code.google.com/p/android/issues/detail?id=201793">Issue
533 201793</a>)
534 </li>
535
536 <li>Fixed an issue where {@code BottomSheetDialogFragment} moved
537 sporadically when content inside was changed. (<a class=
538 "external-link" href=
539 "https://code.google.com/p/android/issues/detail?id=202125">Issue
540 202125</a>)
541 </li>
542
543 <li>Fixed a crash in TextInputLayout counter <a class="external-link"
544 href=
545 "https://code.google.com/p/android/issues/detail?id=202051">link</a>
546 </li>
547
548 <li>Fixed a crash that occured when {@link
549 android.support.design.widget.TextInputLayout#getCounterMaxLength
550 TextInputLayout.getCounterMaxLength()} restored a saved state.
551 (<a class="external-link" href=
552 "https://code.google.com/p/android/issues/detail?id=202375">Issue
553 202375</a>)
554 </li>
555
556 <li>Fixed a {@code ClassCastException} that occurred when restoring a
557 {@link android.support.design.widget.CoordinatorLayout} using the
558 saved state of a view that was not a {@link
559 android.support.design.widget.CoordinatorLayout}.
560 </li>
561 </ul>
562 </dd>
563
564 <dt>
565 Changes for VectorDrawableCompat:
566 </dt>
567
568 <dd>
569 <ul>
570 <li>Fixed a bug where the wrong variable was read for {@code
571 android:tintMode}. (<a class="external-link" href=
572 "https://code.google.com/p/android/issues/detail?id=201907">Issue
573 201907</a>)
574 </li>
575 </ul>
576 </dd>
577 </dl>
578 </div>
579</div>
Andrew Solovayd86f02b2016-04-05 14:16:08 -0700580<!-- end of collapsible section: 23.2.1 -->
Trevor Johns682c24e2016-04-12 10:13:47 -0700581
582<div class="toggle-content closed">
583 <p id="rev23-2-0">
584 <a href="#" onclick="return toggleContent(this)"><img src=
585 "{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img"
586 alt="">Android Support Library, revision 23.2.0</a> <em>(February
587 2016)</em>
588 </p>
589
590 <div class="toggle-content-toggleme">
591 <dl>
592 <dt>
593 Changes for <a href="features.html#v4">v4 Support library</a>:
594 </dt>
595
596 <dd>
597 <ul>
598 <li>Added {@code MediaBrowserCompat} for {@link
599 android.media.browse.MediaBrowser} support, and {@code
600 MediaBrowserServiceCompat} for {@link
601 android.service.media.MediaBrowserService} support. This is useful
602 when connecting a media app’s background service with UI components,
603 and integrating with Android Auto and Android Wear without requiring
604 API level 21 or higher.
605 </li>
606
607 <li>The system now calls {@link
608 android.support.v4.app.FragmentActivity#onActivityResult onActivityResult()} for a
609 nested {@link android.support.v4.app.FragmentActivity}.
610 </li>
611 </ul>
612 </dd>
613
614 <dt>
615 Changes for <a href="features.html#v7-appcompat">v7 AppCompat
616 library</a>:
617 </dt>
618
619 <dd>
620 <ul>
621 <li>Added Night Mode functionality to API level 14 and higher. Switch
622 between <a href="{@docRoot}training/material/theme.html">Material
623 Light and Material Dark Themes</a> based on the time of day or
624 app-specific setting.
625 </li>
626
627 <li style="list-style: none; display: inline">
628 <ul>
629 <li>Day and night themes can be found here: {@code
630 &lt;sdk&gt;/extras/android/support/v7/appcompat/res/values/themes_daynight.xml}
631 </li>
632
633 <li>{@code AppCompatDelegate.setDefaultNightMode()}: sets the
634 app’s default mode by passing one of the following constants:
635 </li>
636
637 <li style="list-style: none; display: inline">
638 <ul>
639 <li>{@code MODE_NIGHT_AUTO}
640 </li>
641
642 <li>{@code MODE_NIGHT_NO}
643 </li>
644
645 <li>{@code MODE_NIGHT_YES}
646 </li>
647
648 <li>{@code MODE_NIGHT_FOLLOW_SYSTEM}
649 </li>
650 </ul>
651 </li>
652
653 <li>{@code AppCompatDelegate.setLocalNightMode()}: overrides
654 the night mode setting for the local app component.
655 </li>
656
657 <li>{@code AppCompatDelegate.getDefaultNightMode()}: returns
658 the default night mode.
659 </li>
660 </ul>
661 </li>
662 </ul>
663 </dd>
664
665 <dt>
666 Changes for <a href="features.html#v7-mediarouter">v7 mediarouter
667 library</a>:
668 </dt>
669
670 <dd>
671 <ul>
672 <li>{@link android.support.v7.app.MediaRouteControllerDialog} now
673 correctly applies custom app theme colors.
674 </li>
675 </ul>
676 </dd>
677
678 <dt>
679 Changes for <a href="features.html#design">Design support library</a>:
680 </dt>
681
682 <dd>
683 <ul>
684 <li>Added support for <a href=
685 "https://www.google.com/design/spec/components/bottom-sheets.html">bottom
686 sheets</a>. An interaction plugin, {@code
687 BottomSheetBehavior}, allows a child view of a {@link
688 android.support.design.widget.CoordinatorLayout} to act as
689 a bottom sheet. The base class, {@code BottomSheetCallback}, provides
690 callbacks to monitor bottom sheet events.
691 </li>
692 </ul>
693 </dd>
694
695 <dt>
696 Changes for the <a href="features.html#custom-tabs">CustomTabs support
697 library</a>:
698 </dt>
699
700 <dd>
701 <ul>
702 <li>
703 <a href=
704 "https://developer.chrome.com/multidevice/android/customtabs">Chrome
705 Custom Tabs</a> now allows apps to include a bottom bar with action
706 buttons in addition to the existing top action button.
707 </li>
708
709 <li>{@code CustomTabsIntent.Builder.addToolBarItem()}: adds an action
710 button to a custom tab. You can use this to add multiple buttons.
711 </li>
712
713 <li>{@code CustomTabsSession.setToolBarItem()}: updates the visuals
714 for toolbar items. This method will only succeed if it is given a
715 valid id and the browser session is in the foreground.
716 </li>
717 </ul>
718 </dd>
719
720 <dt>
721 Added VectorDrawable support library:
722 </dt>
723
724 <dd>
725 <ul>
726 <li>Added Classes:
727 </li>
728
729 <li style="list-style: none; display: inline">
730 <ul>
731 <li>{@code VectorDrawableCompat}
732 </li>
733
734 <li>{@code AnimatedVectorDrawableCompat}
735 </li>
736 </ul>
737 </li>
738
739 <li>Adds support for {@link
740 android.graphics.drawable.VectorDrawable} assets to apps
741 running on API level 7 or higher. {@link
742 android.graphics.drawable.AnimatedVectorDrawable} assets
743 are also supported on API level 11 or higher. Vector assets can be
744 considerably smaller than image assets and should help reduce app
745 size by reducing the amount of assets required to support multiple
746 device screens.
747 </li>
748
749 <li>This library is now a dependency of the <a href=
750 "features.html#v7-appcompat">v7 AppCompat library</a>, allowing
751 developers and <a href="features.html#v7-appcompat">AppCompat </a>
752 to easily use vector drawables. To use {@code
753 VectorDrawableCompat} within an {@link android.widget.ImageButton} or
754 {@link android.widget.ImageView}, use the {@code app:srcCompat} XML
755 attribute or {@code setImageResource()}
756 method.
757 </li>
758
759 <li>To keep referencing attribute IDs on API level 20 or
760 lower, add the following {@code appt} flag to your {@code
761 build,gradle} file:
762 </li>
763
764 <li style="list-style: none; display: inline">
765 <ul>
766 <li>If you are building with Android Plugin for Gradle 1.5.0 or
767 lower, add the following to your {@code build.gradle} file:
768 </li>
769
770 <li style="list-style: none; display: inline">
771 <pre>
772android {
773 defaultConfig {
774 // Stops the Gradle’s automatic rasterization of vectors
775 generatedDensities = []
776 }
777 // Flag that tells aapt to keep the attribute ids
778 aaptOptions {
779 additionalParameters "--no-version-vectors"
780 }
781}
782</pre>
783 </li>
784
785 <li>If you are building with Android Plugin for Gradle 2.0.0 or
786 higher, add the following to your {@code build.gradle} file:
787 </li>
788
789 <li style="list-style: none; display: inline">
790 <pre>
791android {
792 defaultConfig {
793 vectorDrawables.useSupportLibrary = true
794 }
795}
796</pre>
797 </li>
798 </ul>
799 </li>
800 </ul>
801 </dd>
802
803 <dt>
804 Changes for <a href="features.html#v17-leanback">v17 Leanback
805 Library</a>:
806 </dt>
807
808 <dd>
809 <ul>
810 <li>Added new capabilities to {@link android.support.v17.leanback.app.GuidedStepFragment},
811 which is a component that guides users through a decision or series of decisions:
812 </li>
813
814 <li style="list-style: none; display: inline">
815 <ul>
816 <li>Added button actions to {@link
817 android.support.v17.leanback.widget.GuidedAction}:
818 </li>
819
820 <ul>
821 <li>{@code GuidedStepFragment.setButtonActions()}: sets a list of
822 {@link android.support.v17.leanback.widget.GuidedAction} buttons that
823 the user may select from the Actions view.
824 </li>
825 </ul>
826 </li>
827
828 <li>Description fields are now editable:
829 </li>
830
831 <li style="list-style: none; display: inline">
832 <ul>
833 <li>{@code GuidedAction.Builder.descriptionEditable()}: when passing
834 {@code true}, sets the action’s description to be editable.
835 </li>
836
837 <li>{@code GuidedAction.getEditDescription()}: returns the editable
838 description as a {@code CharSequence}.
839 </li>
840 </ul>
841 </li>
842
843 <li>Added drop-down lists of sub-actions:
844 </li>
845
846 <li style="list-style: none; display: inline">
847 <ul>
848 <li>{@code GuidedAction.setSubActions()}: sets a {@link
849 android.support.v17.leanback.widget.GuidedAction} list as a drop-down
850 menu of sub-actions.
851 </li>
852 </ul>
853 </li>
854 </ul>
855
856 <li>Added the {@code GuidedDatePickerAction} widget for {@link
857 android.widget.DatePicker} functionality:
858 </li>
859
860 <li style="list-style: none; display: inline">
861 <ul>
862 <li>The date is selected using year, month, and day columns and has a
863 customizable range.
864 </li>
865
866 <li>{@code GuidedDatePickerAction.Builder}: builder class for the {@code
867 GuidedDatePickerAction} object.
868 </li>
869
870 <li>{@code GuidedDatePickerAction.Builder.datePickerFormat(String
871 datePickerFormat)}: set the desired date format by passing the
872 appropriate three-character {@code String}, e.g. {@code “YMD”} or {@code
873 “MDY”}. Alternatively, use the {@code datePickerFormat} XML attribute.
874 </li>
875 </ul>
876 </li>
877 </ul>
878 </dd>
879 </dl>
880
881 <dl>
882 <dt>
883 Changes for <a href="features.html#v7-recyclerview">v7 RecyclerView
884 library</a>:
885 </dt>
886
887 <dd>
888 <ul>
889 <li>{@link android.support.v7.widget.RecyclerView} now has an opt-in
890 feature called <em>AutoMeasure</em> which allows {@link
891 android.support.v7.widget.RecyclerView.LayoutManager} to easily wrap
892 content or handle various measurement specifications provided by the
893 parent of the {@link android.support.v7.widget.RecyclerView}. It
894 supports all existing animation capabilities of the {@link
895 android.support.v7.widget.RecyclerView}.
896 </li>
897
898 <li style="list-style: none; display: inline">
899 <ul>
900 <li>If you have a custom {@link
901 android.support.v7.widget.RecyclerView.LayoutManager},
902 call {@code setAutoMeasureEnabled(true)} to start using the new
903 AutoMeasure API. All built-in {@link
904 android.support.v7.widget.RecyclerView.LayoutManager} objects
905 enable auto-measure by default.
906 </li>
907
908 <li>{@link android.support.v7.widget.RecyclerView.LayoutManager}
909 no longer ignores some {@link
910 android.support.v7.widget.RecyclerView.LayoutParams} settings,
911 such as {@code MATCH_PARENT} in the scroll direction.
912 <p class="note">
913 <strong>Note:</strong> These lifted restrictions may cause
914 unexpected behavior in your layouts. Make sure you specify
915 the correct layout parameters.
916 </p>
917 </li>
918 </ul>
919 </li>
920
921 <li>When updating a {@link
922 android.support.v7.widget.RecyclerView.ViewHolder} with payload
923 information, {@link android.support.v7.widget.DefaultItemAnimator}
924 now disables change animations.
925 </li>
926
927 <li>You can now modify the {@link
928 android.support.v7.widget.helper.ItemTouchHelper} escape velocity to
929 control swipe sensitivity. To make it easier or harder to swipe,
930 override {@code getSwipeEscapeVelocity(float defaultValue)} and modify {@code defaultValue}.
931 </li>
932 </ul>
933 </dd>
934 </dl>
935 </div>
936</div>
Andrew Solovayd86f02b2016-04-05 14:16:08 -0700937<!-- end of collapsible section: 23.2.0 -->
Trevor Johns682c24e2016-04-12 10:13:47 -0700938
939<div class="toggle-content closed">
940 <p id="rev23-1-1"><a href="#" onclick="return toggleContent(this)">
941 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
942/>Android Support Library, revision 23.1.1</a> <em>(November 2015)</em>
943 </p>
944 <div class="toggle-content-toggleme">
945 <dl>
946 <dt>Changes for <a href="features.html#v7-recyclerview">v7 recyclerview library:</a></dt>
947 <dd>
948 <ul>
949 <li>Fixed a crash that occurs when you perform a swipe-to-dismiss action that the
950 {@code ItemTouchHelper} utility class provides, and then add an item.
951 (<a href="http://b.android.com/190500">Issue 190500</a>)</li>
952 </ul>
953 </dd>
954 <dt>Changes for <a href="features.html#v7-preference">v7 preference library:</a></dt>
955 <dd>
956 <ul>
957 <li>Fixed an issue with ProGuard usage.
958 (<a href="http://b.android.com/183261">Issue 183261</a>)</li>
959 </ul>
960 </dd>
961
962 <dt>Changes for <a href="features.html#v17-leanback">v17 Leanback Support library:</a></dt>
963 <dd>
964 <ul>
965 <li>Fixed a number of internal issues in this library.</li>
966 </ul>
967 </dd>
968 <dt>Changes for <a href="features.html#design">Design Support library:</a></dt>
969 <dd>
970 <ul>
971 <li>Added the <code>getHeaderView</code> method to the <code>NavigationView</code> class.</li>
972 <li>Fixed a transparent background issue for a <code>FloatingActionButton</code> object on
973 devices running Android 4.0 (API level 15) and lower.
974 (<a href="http://b.android.com/183315">Issue 183315</a>)</li>
975 </ul>
976 </dd>
977 </dl>
978
979 </div>
980</div> <!-- end of collapsible section -->
981
982
983
984<div class="toggle-content closed">
985 <p id="rev23-1-0"><a href="#" onclick="return toggleContent(this)">
986 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
987/>Android Support Library, revision 23.1.0</a> <em>(October 2015)</em>
988 </p>
989 <div class="toggle-content-toggleme">
990 <dl>
991 <dt>Changes for <a href="features.html#v4">v4 Support library:</a></dt>
992 <dd>
993 <ul>
994 <li>Added <code>OnScrollChangedListener</code> interface support to the
995 <code>NestedScrollView</code> widget. It
996 allows you to receive callbacks when the scroll X or Y positions change.</li>
997 <li>Added a <code>MediaButtonReceiver</code> class to forward received playback controls
998 to a service that’s managing the <code>MediaSessionCompat</code> class. The
999 <code>MediaSessionCompat</code> class has a
1000 constructor that can automatically find a media button receiver in the manifest. A
1001 media button receiver is a key part to <a href=
1002 "http://developer.android.com/training/managing-audio/volume-playback.html#PlaybackControls">handling
1003 playback controls</a> from hardware or bluetooth controls.</li>
1004 </ul>
1005 </dd>
1006
1007
1008 <dt>Changes for <a href="features.html#v7-appcompat">v7 appcompat library:</a></dt>
1009 <dd>
1010 <ul>
1011 <li>Added material design <code>Seekbar</code> and <code>ImageButton</code> widgets.</li>
1012 <li>Updated the <code>ImageView</code> widget to support the tint feature.</li>
1013 <li>Updated the look-and-feel of the <code>SwitchCompat</code> widget.</li>
1014 </ul>
1015 </dd>
1016
1017 <dt>Changes for <a href="features.html#v7-mediarouter">v7 mediarouter library:</a></dt>
1018 <dd>
1019 <ul>
1020 <li>Added the following features to the <code>MediaRouteChooserDialog</code> class:</li>
1021 <ul>
1022 <li>Displays a loading page while discovering media route providers.</li>
1023 <li>Includes a device type icon for easier device identification.</li>
1024 <li>Sorts the routes according to frequency of use in the current app.</li>
1025 <li>Supports landscape mode.</li>
1026 </ul>
1027 </ul>
1028 <ul>
1029 <li>Added the following features to the <code>MediaRouteControllerDialog</code> class:</li>
1030 <ul>
1031 <li>Recognizes screen casting and provides a proper description.</li>
1032 <li>Supports various album art sizes and aspect ratios, and loads the art asynchronously.</li>
1033 <li>Automatically selects the content color based on the primary color of the app.</li>
1034 <li>Adjusts the dialog layout based on available screen space on the device.</li>
1035 <li>Supports landscape mode.</li>
1036 </ul>
1037 </ul>
1038 </dd>
1039
1040 <dt>Changes for <a href="features.html#v7-palette">v7 palette library:</a></dt>
1041 <dd>
1042 <ul>
1043 <li>Added the <code>setRegion()</code> method to support extracting color from a specific
1044 region of a <code>Bitmap</code> object.</li>
1045 </ul>
1046 </dd>
1047
1048 <dt>Changes for <a href="features.html#v7-recyclerview">v7 recyclerview library:</a></dt>
1049 <dd>
1050 <ul>
1051 <li>Added an improved animation API to the <code>ItemAnimator</code> class for better
1052 customizations:</li>
1053 <ul>
1054 <li>Change animations no longer enforce two copies of the <code>ViewHolder</code> object,
1055 which enables item content animations. Also, the <code>ItemAnimator</code> object
1056 decides whether it wants to reuse the same <code>ViewHolder</code> object or create a
1057 new one.</li>
1058 <li>The new information record API gives the <code>ItemAnimator</code> class the flexibility
1059 to collect data at the correct point in the layout lifecycle. This information is later
1060 passed into the animate callbacks.</li>
1061 </ul>
1062 </ul>
1063 <ul>
1064 <li>Provided an easy transition plan for this backward-incompatible API change:</li>
1065 <ul>
1066 <li>If you’ve previously extended the <code>ItemAnimator</code> class, you can change
1067 your base class to <code>SimpleItemAnimator</code> and your code should work as before.
1068 The <code>SimpleItemAnimator</code> class provides the old API by wrapping the new API.</li>
1069 <li>Some methods were removed from the <code>ItemAnimator</code> class. The following
1070 code will no longer compile:</li>
1071 <pre>recyclerView.getItemAnimator().setSupportsChangeAnimations(false)</pre>
1072 <p>You can replace it with:</p>
1073 <pre>
1074ItemAnimator animator = recyclerView.getItemAnimator();
1075if (animator instanceof SimpleItemAnimator) {
1076 ((SimpleItemAnimator) animator).setSupportsChangeAnimations(false);
1077}
1078 </pre>
1079 </ul>
1080 </ul>
1081 </dd>
1082
1083
1084 <dt>Changes for <a href="features.html#v7-preference">v7</a>,
1085 <a href="features.html#v14-preference">v14</a>, and
1086 <a href="features.html#v17-preference">v17</a> Preference Support library:</dt>
1087 <dd>
1088 <ul>
1089 <li>Removed APIs for controlling <code>EditText</code> dialogs.</li>
1090 </ul>
1091 </dd>
1092
1093 <dt>Changes for <a href="features.html#v17-leanback">v17 Leanback Support library:</a></dt>
1094 <dd>
1095 <ul>
1096 <li>Added a version of the <code>GuidedStepFragment</code> class for the Support library
1097 (extends <code>android.support.v4.app.Fragment</code>), and improved animations and
1098 transitions.</li>
1099 <li>Updated the <code>GuidedStepFragment</code> class so it can be placed on top of
1100 existing content.</li>
1101 <li>Added the ability to annotate different types of search completions to the
1102 <code>SearchFragment</code> class.</li>
1103 <li>Added staggered slide transition support to the <code>VerticalGridFragment</code>
1104 class.</li>
1105 </ul>
1106 </dd>
1107
1108
1109 <dt>Changes for <a href="features.html#design">Design Support library:</a></dt>
1110 <dd>
1111 <ul>
1112 <li>Added <a href=
1113 "https://www.google.com/design/spec/components/text-fields.html#text-fields-character-counter">
1114 character counting</a> support to the <code>TextInputLayout</code> widget.</li>
1115 <li>Added edge snapping support to the <code>AppBarLayout</code> class by adding the
1116 <code>SCROLL_FLAG_SNAP</code> constant. When scrolling ends, if the view is only
1117 partially visible, the view is snapped and scrolled to its closest edge.</li>
1118 <li>Added support for custom views to the <code>NavigationView</code> class by using the
1119 <code>app:actionLayout</code> attribute or <code>MenuItemCompat.setActionView()</code>
1120 method.</li>
1121 </ul>
1122 </dd>
1123
1124
1125 <dt>Changes for <a href="features.html#custom-tabs">Custom Tabs Support library:</a></dt>
1126 <dd>
1127 <ul>
1128 <li>Added the <code>enableUrlBarHiding()</code> method to the <code>CustomTabsIntent</code>
1129 class. It lets the client customize whether the URL bar should be hidden automatically
1130 on scroll down.</li>
1131 <li>Added the <code>setActionButton()</code> method to the <code>CustomTabsSession</code>
1132 class. It lets the client
1133 change the icon for a custom action button in an already launched custom tab.</li>
1134 <li>Added the <code>TAB_SHOWN</code> and <code>TAB_HIDDEN</code> constants as new events
1135 for the <code>onNavigationEvent</code> method of the <code>CustomTabsCallback</code>
1136 class.</li>
1137 </ul>
1138 </dd>
1139
1140 </dl>
1141
1142 </div>
1143</div> <!-- end of collapsible section -->
1144
1145
1146<div class="toggle-content closed">
1147 <p id="rev23-0-1"><a href="#" onclick="return toggleContent(this)">
1148 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
1149/>Android Support Library, revision 23.0.1</a> <em>(September 2015)</em>
1150 </p>
1151 <div class="toggle-content-toggleme">
1152 <dl>
1153 <dt>Changes for <a href="features.html#v7-preference">v7</a> and
1154 <a href="features.html#v14-preference">v14</a> Preference Support library:</dt>
1155 <dd>
1156 <ul>
1157 <li>Added the material design layout and style files.
1158 (<a href="http://b.android.com/183376">Issue 183376</a>)</li>
1159 </ul>
1160 </dd>
1161
1162
1163 <dt>Changes for <a href="features.html#v7-appcompat">v7 appcompat library:</a></dt>
1164 <dd>
1165 <ul>
1166 <li>Fixed crash issues for the {@link android.app.Fragment} class by limiting the use of
1167 hardware layers to Android 4.1 (API level 16) and higher.
1168 (<a href="http://b.android.com/183896">Issue 183896</a>)</li>
1169 <li>Fixed an issue where hardware buttons did not work when an activity had set the
1170 {@link android.widget.Toolbar} class to act as the
1171 {@link android.app.ActionBar} by using the <code>setSupportActionBar()</code> method.
1172 (<a href="http://b.android.com/183334">Issue 183334</a>)</li>
1173 <li>Updated the {@link android.support.v7.app.AppCompatDialogFragment} class so it
1174 no longer throws the {@code Windows feature must be requested before adding content}
1175 error.
1176 (<a href="http://b.android.com/183186">Issue 183186</a>)</li>
1177 </ul>
1178 </dd>
1179
1180
1181 <dt>Changes for <a href="features.html#design">Design Support library:</a></dt>
1182 <dd>
1183 <ul>
1184 <li>Fixed the
1185 {@link android.support.design.widget.AppBarLayout} class so it now draws correctly after
1186 rotation.
1187 (<a href="http://b.android.com/183109">Issue 183109</a>)</li>
1188 <li>Fixed the
1189 {@link android.support.design.widget.TabLayout} class so it now behaves correctly when a
1190 user clicks after a swipe.
1191 (<a href="http://b.android.com/183123">Issue 183123</a>)</li>
1192 </ul>
1193 </dd>
1194
1195
1196 <dt>Changes for <a href="features.html#custom-tabs">Custom Tabs Support library:</a></dt>
1197 <dd>
1198 <ul>
1199 <li>Lowered the
1200 <a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html"><code>minSdkVersion</code></a>
1201 value from 16 to 15 for version support.</li>
1202 <li>Added a way to generate a
1203 {@link android.support.customtabs.CustomTabsSessionToken} from an intent.</li>
1204 </ul>
1205 </dd>
1206
1207 </dl>
1208
1209 </div>
1210</div> <!-- end of collapsible section -->
1211
1212
1213<div class="toggle-content closed">
1214 <p id="rev23"><a href="#" onclick="return toggleContent(this)">
1215 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Rich Slogarf0a340e2015-08-05 18:02:17 -07001216/>Android Support Library, revision 23</a> <em>(August 2015)</em>
1217 </p>
1218 <div class="toggle-content-toggleme">
1219 <dl>
1220 <dt>Added new support libraries:</a></dt>
1221 <dd>
1222 <ul>
1223 <li><a href="features.html#custom-tabs">Custom Tabs Support library</a></li>
1224 <li><a href="features.html#percent">Percent Support library</a></li>
1225 <li><a href="features.html#recommendation">App Recommendation Support library for TV</a></li>
1226 <li><a href="features.html#v7-preference">v7 Preference Support library</a></li>
1227 <li><a href="features.html#v14-preference">v14 Preference Support library</a></li>
1228 <li><a href="features.html#v17-preference">v17 Preference Support library for TV</a></li>
1229 </ul>
1230 </dd>
1231
1232 </dl>
Joe Fernandezc45bd692015-08-17 14:21:12 -07001233
1234 <p>For a complete list of the Support Library changes, see the
1235 <a href="{@docRoot}sdk/support_api_diff/23/changes.html">Support
1236 Library API Differences Report</a>. </p>
1237
Rich Slogarf0a340e2015-08-05 18:02:17 -07001238 </div>
1239</div> <!-- end of collapsible section -->
1240
1241
1242
1243<div class="toggle-content closed">
Trevor Johns682c24e2016-04-12 10:13:47 -07001244 <p id="rev22-2-1"><a href="#" onclick="return toggleContent(this)">
1245 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Rich Slogar1f6a5f82015-07-27 17:57:55 -07001246/>Android Support Library, revision 22.2.1</a> <em>(July 2015)</em>
1247 </p>
1248 <div class="toggle-content-toggleme">
1249 <dl>
1250 <dt>Changes for <a href="features.html#design">Design Support library:</a></dt>
1251 <dd>
1252 <ul>
1253 <li>Added the {@code hide()} and {@code show()} methods to the
1254 {@link android.support.design.widget.FloatingActionButton} class for programmatic
1255 triggering of animations. </li>
1256 <li>Added the {@code LENGTH_INDEFINITE} constant to the
1257 {@link android.support.design.widget.Snackbar} class for showing a snackbar
1258 until it is dismissed or another snackbar is shown. Also, added the
1259 {@link android.support.design.widget.Snackbar#setActionTextColor(int)} and
1260 {@link android.support.design.widget.Snackbar#setActionTextColor(ColorStateList)}
1261 methods. </li>
1262 <li>Added the {@code getSelectedTabPosition()} method to the
1263 {@link android.support.design.widget.TabLayout} class for retrieving the currently
1264 selected tab. </li>
1265 <li>Provided a fully fluent API for the
1266 {@link android.support.v7.app.NotificationCompat.MediaStyle} class for method
1267 chaining. </li>
1268 <li>Added convenience methods to the
1269 {@link android.support.v7.widget.RecyclerView} for batch insertion of items. </li>
1270 </ul>
1271 </dd>
1272 </dl>
1273
1274 <p>For a complete list of the Support Library changes, see the
1275 <a href="{@docRoot}sdk/support_api_diff/22.2.0/changes.html">Support
1276 Library API Differences Report</a>. </p>
1277
Rich Slogar1f6a5f82015-07-27 17:57:55 -07001278 </div>
1279</div> <!-- end of collapsible section -->
1280
1281
1282
1283<div class="toggle-content closed">
1284 <p id="rev21"><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07001285 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Rich Slogarc9e841e2015-05-06 16:30:47 -07001286/>Android Support Library, revision 22.2.0</a> <em>(May 2015)</em>
Rich Slogar1c6c22d2015-04-13 14:01:04 -07001287 </p>
1288 <div class="toggle-content-toggleme">
1289 <dl>
Rich Slogarc9e841e2015-05-06 16:30:47 -07001290 <dt>Added <a href="features.html#design">Design Support library:</a></dt>
1291 <dd>
1292 <ul>
1293 <li>Added {@link android.support.design.widget.TextInputLayout} for showing
1294 {@link android.widget.EditText} hint and error text as floating labels.
1295 </li>
1296 <li>Added {@link android.support.design.widget.FloatingActionButton} for implementing a
1297 primary action on your interface as a
1298 floating action button, supporting either default or mini sizes.
1299 </li>
1300 <li>Added {@link android.support.design.widget.Snackbar} for providing lightweight
1301 feedback with an optional action in an animated snackbar.
1302 </li>
1303 <li>Added {@link android.support.design.widget.TabLayout} for implementing fixed and
1304 scrollable
1305 <a href="{@docRoot}design/building-blocks/tabs.html">tabs</a> as well as easy
1306 integration with
1307 {@link android.support.v4.view.ViewPager}.
1308 </li>
1309 <li>Added {@link android.support.design.widget.NavigationView} for implementing
1310 <a href="{@docRoot}design/patterns/navigation-drawer.html">navigation drawer</a>
1311 contents, including the ability to inflate menu items via a
1312 <a href="{@docRoot}guide/topics/resources/menu-resource.html">Menu Resource</a>.
1313 </li>
1314 <li>Added {@link android.support.design.widget.CoordinatorLayout}, a general purpose
1315 layout, used for building dependencies between
1316 sibling views and allowing easy scrolling reactions between components via
1317 {@link android.support.design.widget.CoordinatorLayout.Behavior}. Many of the Design
1318 Library components rely on being a child of a
1319 {@link android.support.design.widget.CoordinatorLayout}.
1320 </li>
1321 <li>Added {@link android.support.design.widget.AppBarLayout}, a container for a
1322 {@link android.widget.Toolbar}
1323 and other views (such as {@link android.support.design.widget.TabLayout}) for
1324 reacting to scrolling events by scrolling off the screen, becoming visible in reaction
1325 to a downward scroll, or collapsing/uncollapsing before scrolling off/onto the screen.
1326 </li>
1327 <li>Added {@link android.support.design.widget.CollapsingToolbarLayout} for controlling
1328 how a {@link android.widget.Toolbar} collapses. A toolbar may collapse by:
1329 pinning components to the top of the screen while it collapses, introducing
1330 parallax scrolling of components such as an {@link android.widget.ImageView},
1331 or adding a content scrim color when the view is partially collapsed.
1332 </li>
1333 </ul>
1334 </dt>
1335
1336
1337
1338 <dt>Changes for <a href="features.html#v4">v4 support library:</a></dt>
1339 <dd>
1340 <ul>
1341
1342 <li>Added the
1343{@link android.support.v4.view.accessibility.AccessibilityEventCompat#getContentChangeTypes getContentChangeTypes()}
1344 and
1345{@link android.support.v4.view.accessibility.AccessibilityEventCompat#setContentChangeTypes setContentChangeTypes()}
1346 methods and related change type
1347 fields to the
1348 {@link android.support.v4.view.accessibility.AccessibilityEventCompat}
1349 class for accessibility event handling.
1350 </li>
1351 <li>Added the
1352{@link android.support.v4.media.session.PlaybackStateCompat#getActiveQueueItemId getActiveQueueItemId()},
1353{@link android.support.v4.media.session.PlaybackStateCompat#getCustomActions getCustomActions()},
1354 and
1355 {@link android.support.v4.media.session.PlaybackStateCompat#getExtras getExtras()}
1356 methods with related state fields to the
1357 {@link android.support.v4.media.session.PlaybackStateCompat} class for
1358 getting custom actions from the queue.
1359 </li>
1360 <li>Added the
1361{@link android.support.v4.media.session.PlaybackStateCompat.Builder#addCustomAction addCustomAction()},
Rich Slogarc9e841e2015-05-06 16:30:47 -07001362{@link android.support.v4.media.session.PlaybackStateCompat.Builder#setActiveQueueItemId setActiveQueueItemId()},
1363 and
1364 {@link android.support.v4.media.session.PlaybackStateCompat.Builder#setExtras setExtras()}
1365 methods to the
1366 {@link android.support.v4.media.session.PlaybackStateCompat.Builder} class for adding
Rich Slogar1f6a5f82015-07-27 17:57:55 -07001367 custom actions to a playback state.
Rich Slogarc9e841e2015-05-06 16:30:47 -07001368 </li>
1369 <li>Added the
1370{@link android.support.v4.media.session.PlaybackStateCompat.CustomAction#fromCustomAction fromCustomAction()} and
1371{@link android.support.v4.media.session.PlaybackStateCompat.CustomAction#getCustomAction getCustomAction()} methods
1372 to the
1373 {@link android.support.v4.media.session.PlaybackStateCompat.CustomAction} class
1374 for getting custom actions from the queue.
1375 </li>
1376 <li>Added the {@link android.support.v4.view.ViewCompat#isAttachedToWindow isAttachedToWindow()},
1377 {@link android.support.v4.view.ViewCompat#offsetLeftAndRight offsetLeftAndRight()}, and
1378 {@link android.support.v4.view.ViewCompat#offsetTopAndBottom offsetTopAndBottom()}
1379 methods to the {@link android.support.v4.view.ViewCompat} class for working with views.
1380 </li>
1381 <li>Added the {@link android.support.v4.view.ViewPager#addOnPageChangeListener addOnPageChangeListener()},
1382 {@link android.support.v4.view.ViewPager#clearOnPageChangeListeners clearOnPageChangeListeners()}, and
1383 {@link android.support.v4.view.ViewPager#removeOnPageChangeListener removeOnPageChangeListener()}
1384 methods to the {@link android.support.v4.view.ViewPager} class for responding to page
1385 changes.
1386 <p>Deprecated the
1387 {@link android.support.v4.view.ViewPager#setOnPageChangeListener setOnPageChangeListener()} method.</p>
1388 </li>
1389 <li>Added the
1390{@link android.support.v4.view.ViewParentCompat#notifySubtreeAccessibilityStateChanged notifySubtreeAccessibilityStateChanged()} method to
1391 the {@link android.support.v4.view.ViewParentCompat} class for notifying a view parent
1392 that the accessibility state of one of its descendants has changed.
1393 </li>
1394 <li>Added the {@link android.support.v4.view.ViewPropertyAnimatorCompat#translationZ translationZ()},
1395 {@link android.support.v4.view.ViewPropertyAnimatorCompat#translationZBy translationZBy()},
1396 {@link android.support.v4.view.ViewPropertyAnimatorCompat#z z()}, and
1397 {@link android.support.v4.view.ViewPropertyAnimatorCompat#zBy zBy()}
1398 methods to the {@link android.support.v4.view.ViewPropertyAnimatorCompat} class for
1399 adding animation.
1400 </li>
1401 </ul>
1402 </dd>
1403
1404
1405
1406<dt>Changes for <a href="features.html#v7-appcompat">v7 appcompat library</a>:</dt>
1407 <dd>
1408<ul>
1409 <li>Added the
1410 {@link android.support.v7.app.AppCompatActivity#onWindowStartingSupportActionMode onWindowStartingSupportActionMode()}
1411 method to the
1412 {@link android.support.v7.app.AppCompatActivity},
1413 {@link android.support.v7.app.AppCompatCallback}, and
1414 {@link android.support.v7.app.AppCompatDialog} classes for handling action modes
1415 started from the current window.
1416 </li>
1417
1418 <li>Added the
1419{@link android.support.v7.app.AppCompatDelegate#isHandleNativeActionModesEnabled isHandleNativeActionModesEnabled()} and
1420{@link android.support.v7.app.AppCompatDelegate#setHandleNativeActionModesEnabled setHandleNativeActionModesEnabled()}
1421 methods to the
1422 {@link android.support.v7.app.AppCompatDelegate} class for handling native action modes.
1423 </li>
1424 </ul>
1425 </dd>
1426
Rich Slogar1f6a5f82015-07-27 17:57:55 -07001427 <p>For a complete list of the Support Library changes, see the
1428 <a href="{@docRoot}sdk/support_api_diff/22.2.0/changes.html">Support
1429 Library API Differences Report</a>. </p>
Rich Slogarc9e841e2015-05-06 16:30:47 -07001430
1431 </dl>
1432
1433 </div>
1434</div> <!-- end of collapsible section -->
1435
1436
1437
1438
Rich Slogarc9e841e2015-05-06 16:30:47 -07001439<div class="toggle-content closed">
1440 <p id="rev21"><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07001441 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Rich Slogarc9e841e2015-05-06 16:30:47 -07001442/>Android Support Library, revision 22.1.0</a> <em>(April 2015)</em>
1443 </p>
1444
1445
1446
1447 <div class="toggle-content-toggleme">
1448 <dl>
1449
1450
1451 <div class="toggle-content-toggleme">
1452 <dl>
1453 <dt>Changes for <a href="features.html#annotations">annotations library:</a></dt>
1454 <dd>
1455 <ul>
1456 <li>Added the Annotations library to provide support for enhanced code inspections.
1457 Annotations are added as metadata tags that you attach to variables, parameters,
1458 and return values to inspect method return values, passed parameters, and local
1459 variables and fields.
1460 </li>
1461 </ul>
1462 </dd>
1463
1464
Rich Slogar1c6c22d2015-04-13 14:01:04 -07001465 <dt>Changes for <a href="features.html#v4">v4 support library:</a></dt>
1466 <dd>
1467 <ul>
1468
1469 <li>Added the {@link android.support.v4.graphics.ColorUtils ColorUtils} class
1470 to provide a set of color-related utility methods.
1471 </li>
1472 <li>Added the {@link android.support.v4.graphics.drawable.DrawableCompat#unwrap unwrap()} and
1473 {@link android.support.v4.graphics.drawable.DrawableCompat#wrap wrap()} methods to the
1474 {@link android.support.v4.graphics.drawable.DrawableCompat} class , allowing you to use
1475 {@link android.support.v4.graphics.drawable.DrawableCompat#setTint setTint()},
1476 {@link android.support.v4.graphics.drawable.DrawableCompat#setTintList setTintList()},
1477 and {@link android.support.v4.graphics.drawable.DrawableCompat#setTintMode setTintMode()}
1478 on all API level 4 or higher devices.
1479 </li>
1480 <li>Added the {@link android.support.v4.os.TraceCompat} class to
1481 write trace events to the system trace buffer, which can then be collected and
1482 visualized using the <a href="{@docRoot}tools/help/systrace.html">Systrace</a> tool.
1483 </li>
1484 <li>Added the {@link android.support.v4.util.CircularIntArray} class
1485 to create circular integer array data structures.
1486 </li>
1487 <li>Added the {@link android.support.v4.util.CircularArray#clear clear()},
1488 {@link android.support.v4.util.CircularArray#removeFromStart removeFromStart()},
1489 and {@link android.support.v4.util.CircularArray#removeFromEnd removeFromEnd()}
1490 methods to the {@link android.support.v4.util.CircularArray} class. Also, changed the
1491 existing methods in this class to be non-final.
1492 </li>
1493 <li>Added the {@link android.support.v4.view.InputDeviceCompat}
1494 as a helper class to access data in the
1495 {@link android.support.v4.view.InputDeviceCompat} class.
1496 </li>
1497 <li>Added the {@link android.support.v4.view.LayoutInflaterCompat}
1498 class as a helper class to access data in the
1499 {@link android.support.v4.view.LayoutInflaterCompat} class
1500 and added the {@link android.support.v4.view.LayoutInflaterFactory} interface.
1501 </li>
1502 <li>Added classes, methods, and interfaces to support nested scrolling.
1503 <ul>
1504 <li>Added the {@link android.support.v4.view.NestedScrollingChildHelper}
1505 and {@link android.support.v4.view.NestedScrollingParentHelper}
1506 helper classes for implementing nested scrolling parent and child views.</li>
1507 <li>Added the {@link android.support.v4.view.NestedScrollingChild}
1508 interface to be implemented by {@link android.view.View} subclasses.</li>
1509 <li>Added the {@link android.support.v4.view.NestedScrollingParent}
1510 and {@link android.support.v4.view.ScrollingView} interfaces to support
1511 scrolling operations and provide scroll related APIs.</li>
1512 <li>Added the
1513 {@link android.support.v4.view.ViewGroupCompat#getNestedScrollAxes
1514 getNestedScrollAxes()} method to the {@link android.support.v4.view.ViewGroupCompat}
1515 class.</li>
1516 <li>Added methods to the {@link android.support.v4.view.ViewParentCompat} class to
1517 support nested scrolling.
1518 </li>
1519 <li>Added the {@link android.support.v4.widget.NestedScrollView}
1520 class to support nested scrolling parent and child on both new and old versions of
1521 Android.
1522 </li>
1523 </ul>
1524 </li>
1525 <li>Added methods and constants to the {@link android.support.v4.view.MotionEventCompat}
1526 class for getting axis values and event source.
1527 </li>
1528 <li>Updated the {@link android.support.v4.view.accessibility.AccessibilityNodeInfoCompat}
1529 class to add methods for errors, content invalidation and labels.
1530 </li>
Rich Slogarc9e841e2015-05-06 16:30:47 -07001531 <li>Added the following interpolation classes for animation:
Rich Slogar1c6c22d2015-04-13 14:01:04 -07001532 {@link android.support.v4.view.animation.FastOutLinearInInterpolator},
1533 {@link android.support.v4.view.animation.FastOutSlowInInterpolator},
1534 {@link android.support.v4.view.animation.LinearOutSlowInInterpolator},
1535 {@link android.support.v4.view.animation.LinearOutSlowInInterpolator}, and
1536 {@link android.support.v4.view.animation.PathInterpolatorCompat}.
1537 </li>
1538 <li>Added the {@link android.support.v4.widget.Space} class to create gaps between
1539 components in general purpose layouts. This class is deprecated in the gridlayout library.
1540 </li>
1541 <li>Added the {@link android.support.v4.widget.TextViewCompat} class for accessing
1542 features in a {@link android.widget.TextView}.
1543 </li>
1544 <li>Added a displacement parameter to the
1545 {@link android.support.v4.widget.EdgeEffectCompat#onPull onPull()} method in the
1546 {@link android.support.v4.widget.EdgeEffectCompat} class.
1547 </li>
1548
1549 </ul>
1550 </dd>
1551
1552
1553 <dt>Changes for <a href="features.html#v7-appcompat">v7 appcompat library</a>:</dt>
1554 <dd>
1555 <ul>
1556 <li>Added tint support to appcompat widgets, including
1557 {@link android.support.v7.widget.AppCompatAutoCompleteTextView},
1558 {@link android.support.v7.widget.AppCompatButton},
1559 {@link android.support.v7.widget.AppCompatCheckBox},
1560 {@link android.support.v7.widget.AppCompatCheckedTextView},
1561 {@link android.support.v7.widget.AppCompatEditText},
1562 {@link android.support.v7.widget.AppCompatMultiAutoCompleteTextView},
1563 {@link android.support.v7.widget.AppCompatRadioButton},
1564 {@link android.support.v7.widget.AppCompatRatingBar},
1565 {@link android.support.v7.widget.AppCompatSpinner}, and
1566 {@link android.support.v7.widget.AppCompatTextView}.
1567 </li>
1568 <li>Updated the {@link android.support.v7.app.AppCompatActivity} as the base
1569 class for activities that use the support library action bar features. This class
1570 replaces the deprecated {@link android.support.v7.app.ActionBarActivity}.
1571 </li>
1572 <li>Added the
1573 {@link android.support.v7.app.AppCompatCallback} interface
1574 to be implemented for AppCompat to be able to perform callbacks.
1575 </li>
1576 <li>Added the
1577 {@link android.support.v7.app.AppCompatDelegate} abstract class
1578 as a delegate you can use to extend AppCompat's support to any activity.
1579 </li>
1580 <li>Added the
1581 {@link android.support.v7.app.AppCompatDialog} class
1582 as the base class for AppCompat themed dialogs.
1583 </li>
1584 <li>Added the spinner style
1585 {@link android.support.v7.app.AlertDialog} and
1586 {@link android.support.v7.app.AlertDialog.Builder} classes to provide an AppCompat
1587 themed {@link android.app.AlertDialog}.
1588 </li>
1589 <li>Added the {@link android.support.v7.graphics.Palette.Builder} class
1590 for generating {@link android.support.v7.graphics.Palette} instances.
1591 <ul>
1592 <li>Added the
1593 {@link android.support.v7.graphics.Palette#from}
1594 method to the {@link android.support.v7.graphics.Palette} class to
1595 start generating a Palette with the returned
1596 {@link android.support.v7.graphics.Palette.Builder} instance.
1597 </li>
1598 <li>Deprecated the {@link android.support.v7.graphics.Palette#generate generate()} and
1599 {@link android.support.v7.graphics.Palette#generateAsync generateAsync()} methods.
1600 </li>
1601 </ul>
1602 </li>
1603
1604 <li>Added the
1605 {@link android.support.v7.widget.GridLayout.Spec#getAbsoluteAlignment
1606 getAbsoluteAlignment()} method to the {@link android.support.v7.widget.GridLayout.Spec}
1607 class.
1608 </li>
1609 <li>Deprecated use of <code>app:theme</code> for styling
1610 {@link android.support.v7.widget.Toolbar}. You can now use
1611 <code>android:theme</code> for toolbars on all API level 7 and higher devices and
1612 <code>android:theme</code> support for all widgets on API level 11 and higher devices.
1613 </li>
1614 </ul>
1615 </dd>
1616
1617
1618 <dt>Changes for <a href="features.html#v17-leanback">v17 leanback library</a>:</dt>
1619 <dd>
1620 <ul>
1621 <li> Added {@link android.support.v17.leanback.app.GuidedStepFragment},
1622 {@link android.support.v17.leanback.widget.GuidanceStylist} and
1623 {@link android.support.v17.leanback.widget.GuidedActionsStylist} to support
Kris Giesing663cdc52015-04-20 11:12:06 -07001624 creating multi-step decision flows.
Rich Slogar1c6c22d2015-04-13 14:01:04 -07001625 </li>
1626 </ul>
1627 </dd>
1628
1629
1630 <dt>Changes for <a href="features.html#v7-recyclerview">v7 recyclerview library</a>:</dt>
1631 <dd>
1632 <ul>
1633 <li>Added {@link android.support.v7.util.SortedList} classes to display items in
1634 a list order and provide notification of changes to the list.
1635 </li>
1636 <li>Added the {@link android.support.v7.widget.util.SortedListAdapterCallback} class
1637 that can bind a sorted list to a
1638 {@link android.support.v7.widget.RecyclerView.Adapter} class.
1639 </li>
1640 </ul>
1641 </dd>
1642
1643
Rich Slogarc9e841e2015-05-06 16:30:47 -07001644 <dt>Changes for <a href="features.html#v8-renderscript">v8 renderscript library</a>:</dt>
Rich Slogar1c6c22d2015-04-13 14:01:04 -07001645 <dd>
1646 <ul>
1647 <li>Added the {@link android.support.v8.renderscript.ScriptIntrinsicHistogram} class for
1648 use as a histogram filter.</li>
1649 <li>Added the {@link android.support.v8.renderscript.ScriptIntrinsicResize} class for
1650 performing a resize of a 2D allocation.
1651 </li>
1652 </ul>
1653 </dd>
1654
1655 </dl>
1656
1657
1658 </div>
1659</div> <!-- end of collapsible section -->
1660
1661
1662
1663<div class="toggle-content closed">
1664 <p id="rev21"><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07001665 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Rich Slogara81ed3c2015-03-02 16:09:21 -08001666/>Android Support Library, revision 22</a> <em>(March 2015)</em>
1667 </p>
1668 <div class="toggle-content-toggleme">
1669 <dl>
1670 <dt>Changes for <a href="features.html#v4">v4 support library:</a></dt>
1671 <dd>
1672 <ul>
1673 <li>Updated the {@link android.support.v4.content.res.ResourcesCompat#getDrawable
1674 getDrawable()} method to return a drawable object for a specified specific resource ID,
1675 screen density, and theme.
1676 </li>
1677 <li>Added the {@link android.support.v4.view.ViewCompat#setImportantForAccessibility
1678 setImportantForAccessibility()} method so you can indicate if a view should trigger
1679 accessibility events.
1680 </li>
1681 <li>Added the {@link android.support.v4.widget.DrawerLayout#getStatusBarBackgroundDrawable
1682 getStatusBarBackgroundDrawable()} method so you can get the status bar background
1683 drawable.
1684 </li>
1685 <li>Added methods to the
1686 {@link android.support.v4.app.NotificationCompat.CarExtender.UnreadConversation}
1687 class so Android Auto messaging apps can retrieve additional notification data.
1688 </li>
1689 <li>Added the {@link android.support.v4.widget.SwipeRefreshLayout#getProgressCircleDiameter
1690 getProgressCircleDiameter()} method to return the diameter of a circle layout.
1691 </li>
1692 <li>Changed the default {@link android.support.v4.widget.DrawerLayout DrawerLayout}
1693 status bar color to {@link android.R.attr#colorPrimaryDark}.
1694 </li>
1695 </ul>
1696 </dd>
1697
1698 <dt>Changes for <a href="features.html#v7-appcompat">v7 appcompat library</a>:</dt>
1699 <dd>
1700 <ul>
1701 <li>Added the spinner style
1702 {@link android.support.v7.appcompat.R.style#Base_Widget_AppCompat_Spinner_Underlined}.</li>
1703 <li>Added tinted widgets styles with
1704 {@link android.support.v7.appcompat.R.style#Widget_AppCompat_AutoCompleteTextView},
1705 {@link android.widget.MultiAutoCompleteTextView},
1706 {@link android.support.v7.appcompat.R.style#TextAppearance_AppCompat_Button}, and
1707 {@link android.support.v7.appcompat.R.style#Base_Widget_AppCompat_RatingBar}.</li>
1708 </ul>
1709 </dd>
1710
1711 <dt>Changes for <a href="features.html#v17-leanback">v17 leanback library</a>:</dt>
1712 <dd>
1713 <ul>
1714 <li>Added the {@link android.support.v17.leanback.widget.ListRowPresenter#getRecycledPoolSize
1715 getRecycledPoolSize()} and
1716 {@link android.support.v17.leanback.widget.ListRowPresenter#setRecycledPoolSize
1717 setRecycledPoolSize()} methods to allow customized recycled pool sizes.</li>
1718 <li>Added the {@link android.view.ViewGroup.LayoutParams#WRAP_CONTENT} attribute to the
1719 layout width setting to support wrapped content for title icons.</li>
1720 <li>Defined {@link android.support.v17.leanback.R.transition} in XML to
1721 improve transition updates. </li>
1722 <li>Enabled support for right to left layouts.</li>
1723 <li>Added the play and pause media key events support to the
1724 {@link android.support.v17.leanback.app.PlaybackOverlayFragment} class.</li>
1725 <li>Added enter and return transitions to the
1726 {@link android.support.v17.leanback.app.BrowseFragment} class and the
1727 {@link android.support.v17.leanback.app.DetailsFragment} class.</li>
1728 <li>Added the {@link android.support.v17.leanback.widget.ArrayObjectAdapter#replace
1729 replace()} method to replace items in an object’s adapter array. </li>
1730 </ul>
1731 </dd>
1732
1733
1734 <dt>Changes for <a href="features.html#v7-mediarouter">v7 mediarouter library</a>:</dt>
1735 <dd>
1736 <ul>
1737 <li>Updated Google Cast icons to use the
1738 <a href="{@docRoot}training/material/index.html">material design</a> style.</li>
1739 <li>Updated all the icons used in the {@link android.media.MediaRouter} dialogs to use the
1740 <a href="{@docRoot}training/material/index.html">material design</a> style.</li>
1741 </ul>
1742 </dd>
1743
1744
1745 <dt>Changes for <a href="features.html#v7-recyclerview">v7 recyclerview library</a>:</dt>
1746 <dd>
1747 <ul>
1748 <li>Added the {@link android.support.v7.widget.RecyclerView.ViewHolder#getLayoutPosition
1749 getlayoutPosition()}
1750 and {@link android.support.v7.widget.RecyclerView.ViewHolder#getAdapterPosition
1751 getadapterPosition()} methods to the {@link android.support.v7.widget.RecyclerView}
1752 class.</li>
1753 <li>Deprecated the <code>classgetChildPosition()</code> and
1754 <code>findViewHolderForPosition()</code> methods in the
1755 {@link android.support.v7.widget.RecyclerView} class. </li>
1756 <li>Deprecated the <code>getPosition()</code> method in the
1757 {@link android.support.v7.widget.RecyclerView.ViewHolder} class. </li>
1758 <li>Deprecated the <code>getViewPosition()</code> method in the
1759 {@link android.support.v7.widget.RecyclerView.LayoutParams} class. </li>
1760 </ul>
1761 </dd>
1762
Rich Slogar1c6c22d2015-04-13 14:01:04 -07001763 </div>
1764</div>
1765
1766
Rich Slogara81ed3c2015-03-02 16:09:21 -08001767
1768
1769<div class="toggle-content closed">
1770 <p id="rev21"><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07001771 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Rich Slogard7beb6d2014-12-11 15:51:18 -08001772/>Android Support Library, revision 21.0.3</a> <em>(December 2014)</em>
1773 </p>
1774 <div class="toggle-content-toggleme">
1775 <dl>
1776 <dt>Changes for <a href="features.html#v4">v4 support library:</a></dt>
1777 <dd>
1778 <ul>
1779 <li>Added several {@link android.support.v4.app.NotificationCompat.WearableExtender}
1780 methods to improve the display of barcodes in notifications on wearable devices.
1781 <ul>
1782 <li>{@link android.support.v4.app.NotificationCompat.WearableExtender#getHintScreenTimeout getHintScreenTimeout()}</li>
1783 <li>{@link android.support.v4.app.NotificationCompat.WearableExtender#setHintScreenTimeout setHintScreenTimeout()}</li>
1784 <li>{@link android.support.v4.app.NotificationCompat.WearableExtender#getHintAvoidBackgroundClipping getHintAvoidBackgroundClipping()}</li>
1785 <li>{@link android.support.v4.app.NotificationCompat.WearableExtender#setHintAvoidBackgroundClipping setHintAvoidBackgroundClipping()}</li>
1786 </ul>
1787 </li>
1788 </ul>
1789 </dd>
1790
1791 </div>
1792</div>
1793
1794
1795
1796<div class="toggle-content closed">
1797 <p id="rev21"><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07001798 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Rich Slogard7beb6d2014-12-11 15:51:18 -08001799/>Android Support Library, revision 21.0.2</a> <em>(November 2014)</em>
1800 </p>
1801 <div class="toggle-content-toggleme">
1802 <dl>
1803 <dt>Changes for <a href="features.html#v4">v4 support library:</a></dt>
1804 <dd>
1805 <ul>
1806 <li>Added {@link android.support.v4.app.NotificationCompat.CarExtender}
1807 class to support Android Auto extensions to notifications.</li>
1808 </ul>
1809 </dd>
1810 <dt>Changes for <a href="features.html#v7-appcompat">v7 appcompat library</a>:</dt>
1811 <dd>
1812 <ul>
1813 <li>Added the {@link android.support.v7.widget.PopupMenu} constructor to support new popup
1814 menus.</li>
1815 <li>Added support for a Collapse icon description in the {@link android.support.v7.widget.Toolbar}
1816 class.</li>
1817 <li>Updated the {@link android.support.v7.widget.SearchView} widget to support displaying
Jae Seo57551c22015-09-25 12:50:08 -07001818 the {@link android.support.v7.appcompat.R.attr#commitIcon}. </li>
Rich Slogard7beb6d2014-12-11 15:51:18 -08001819 <li>Removed the <code>buttonGravity</code> attribute from the
1820 {@link android.support.v7.widget.Toolbar} class. </li>
1821 </ul>
1822 </dd>
1823 <dt>Changes for <a href="features.html#v7-cardview">v7 cardview library</a>:</dt>
1824 <dd>
1825 <ul>
1826 <li>Added {@link android.support.v7.widget.CardView#setCardBackgroundColor} API to
1827 support changing the background color of the {@link android.support.v7.widget.CardView}.</li>
1828 <li>Changed the {@link android.support.v7.widget.CardView} to more accurately report its
1829 opacity value as {@link android.graphics.PixelFormat#TRANSLUCENT}.</li>
1830 </ul>
1831 </dd>
1832 <dt>Changes for <a href="features.html#v7-recyclerview">v7 recyclerview
1833 library</a>:</dt>
1834 <dd>
1835 <ul>
1836 <li>Added {@link android.support.v7.widget.RecyclerView#TOUCH_SLOP_DEFAULT} and
1837 {@link android.support.v7.widget.RecyclerView#TOUCH_SLOP_PAGING} constants
1838 to the {@link android.support.v7.widget.RecyclerView} class
1839 to support touch slop configurations for paging.</li>
1840 </ul>
1841 </dd>
1842 <dt>Changes for <a href="features.html#v17-leanback">v17 leanback library</a>:</dt>
1843 <dd>
1844 <ul>
1845 <li>Added support to generate v4 code fragments. </li>
1846 <li>Changed the secondary text color on {@link android.support.v7.widget.CardView}. </li>
1847 </ul>
1848 </dd>
1849 </dl>
1850 </div>
1851</div>
1852
1853
1854
1855<div class="toggle-content closed">
1856 <p id="rev21"><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07001857 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Rich Slogard7beb6d2014-12-11 15:51:18 -08001858/>Android Support Library, revision 21.0.1</a> <em>(November 2014)</em>
1859 </p>
1860 <div class="toggle-content-toggleme">
1861 <dl>
1862 <dt>Added <a href="{@docRoot}tools/support-library/features.html#multidex">
1863 multidex support library</a> to support multiple
1864 <a href="https://source.android.com/devices/tech/dalvik/">Dalvik</a> Executable (DEX) files
Rich Slogarf0a340e2015-08-05 18:02:17 -07001865 for multi-dex file support prior to Android 5.0.
Rich Slogard7beb6d2014-12-11 15:51:18 -08001866 </dt>
1867 </dl>
1868 </div>
1869</div>
1870
1871
1872
1873
1874<div class="toggle-content closed">
1875 <p id="rev21"><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07001876 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Andrew Solovay6f6d10e2014-10-02 11:23:42 -07001877/>Android Support Library, revision 21</a> <em>(October 2014)</em>
1878 </p>
1879 <div class="toggle-content-toggleme">
1880 <dl>
1881 <dt>Changes for <a href="features.html#v4">v4 support library:</a></dt>
1882 <dd>
1883 <ul>
1884 <li>Added support for {@link android.support.v4.app.Fragment}
1885 transitions for devices running Android 5.0 (API level 21).
1886 Be aware that transitions have no effect on devices running
1887 Android 4.4 and lower.
1888 </li>
1889 <li>Added {@link android.support.v4.provider.DocumentFile} to ease
1890 the transition from {@link java.io.File}
1891 while working with document trees. However, this class demands
1892 more processing overhead compared to the platform's
1893 {@link android.provider.DocumentsContract} API added in
1894 Android 4.4 (API level 19). So you should switch to using {@link
1895 android.provider.DocumentsContract} when running on Android 4.4
1896 and higher.</li>
1897 </ul>
1898 </dd>
1899 <dt>Changes for <a href="features.html#v7-appcompat">v7 appcompat
1900 library</a>:</dt>
1901 <dd>
1902 <ul>
1903 <li>Added support for <a href="{@docRoot}design/material/">material
1904 design</a> user interfaces.</li>
1905 <li>Added {@link android.support.v7.widget.Toolbar}, which generalizes
1906 the functionality of {@link android.support.v7.app.ActionBar} for
1907 use within app layouts.</li>
1908 <li>Updated {@link android.support.v7.app.ActionBarDrawerToggle},
1909 which contains the menu-to-arrow animation</li>
1910 <li>Updated common user interface widgets to allow tinting via theme
1911 attributes when running on pre-Android 5.0 devices</li>
1912 <li>Added {@link android.support.v7.widget.SwitchCompat}, a backport
Rich Slogara81ed3c2015-03-02 16:09:21 -08001913 of the {@link android.widget.Switch} widget that was added in
Andrew Solovay6f6d10e2014-10-02 11:23:42 -07001914 Android 4.0 (API level 14).</li>
1915 </ul>
1916 </dd>
1917 <dt>New <a href="features.html#v7-cardview">v7 cardview library</a>:</dt>
1918 <dd>
1919 <ul>
1920 <li>Added the {@link android.support.v7.widget.CardView} widget, which
1921 provides a material design-compatible implementation for displaying
1922 data items.</li>
1923 </ul>
1924 </dd>
1925 <dt>New <a href="features.html#v7-recyclerview">v7 recyclerview
1926 library</a>:</dt>
1927 <dd>
1928 <ul>
1929 <li>Added the {@link android.support.v7.widget.RecyclerView} widget,
1930 which provides a flexible list view for providing a limited window
1931 into a large data set.</li>
1932 </ul>
1933 </dd>
1934 <dt>New <a href="features.html#v7-palette">v7 palette library</a>:</dt>
1935 <dd>
1936 <ul>
1937 <li>Added {@link android.support.v7.graphics.Palette} class,
1938 which lets you extract prominent colors from an image.</li>
1939 </ul>
1940 </dd>
1941 <dt>New <a href="features.html#v17-leanback">v17 leanback library</a>:</dt>
1942 <dd>
1943 <ul>
1944 <li>Added support for building TV user interfaces, including
1945 {@link android.support.v17.leanback.app.BrowseFragment},
1946 {@link android.support.v17.leanback.app.DetailsFragment}, and
1947 {@link android.support.v17.leanback.app.PlaybackOverlayFragment}.
1948 For more information about using these user interface widgets,
1949 see <a href="{@docRoot}training/tv/playback/index.html">Building TV
1950 Playback Apps</a>.</li>
1951 </ul>
1952 </dd>
1953 </dl>
1954 </div>
1955</div>
1956
1957<div class="toggle-content closed">
1958 <p><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07001959 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Ricardo Cerveradc2bba12014-07-07 13:15:56 -07001960/>Android Support Library, revision 20</a> <em>(July 2014)</em>
1961 </p>
1962 <div class="toggle-content-toggleme">
1963 <dl>
1964 <dt>Changes for v4 support library:</dt>
1965 <dd>
1966 <ul>
1967 <li>Added extended notification support for Android Wear in
1968 {@link android.support.v4.app.NotificationCompat.WearableExtender}, which allows you
1969 to specify wearable-specific features in your notifications.</li>
1970 <li>Added {@link android.support.v4.app.NotificationCompat.Action.WearableExtender},
1971 which allows actions to be added on wearable notifications.</li>
1972 <li>Added {@link android.support.v4.app.NotificationManagerCompat}, which allows you
1973 to issue notifications that properly support wearable features.</li>
1974 <li>Added {@link android.support.v4.app.RemoteInput}, which allows a handheld device
1975 to receive voice input from a notification that appears on a wearable device.</li>
1976 <li>Improved the handling of touch feedback in
1977 {@link android.support.v4.widget.SwipeRefreshLayout}.</li>
1978 </ul>
1979 </dd>
1980 </dl>
1981 </div>
1982</div>
1983
1984<div class="toggle-content closed">
1985 <p><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07001986 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Ricardo Cervera40594d92014-03-21 11:57:59 -07001987/>Android Support Library, revision 19.1.0</a> <em>(March 2014)</em>
1988 </p>
1989 <div class="toggle-content-toggleme">
1990 <dl>
1991 <dt>Changes for v4 support library:</dt>
1992 <dd>
1993 <ul>
1994 <li>Added the {@link android.support.v4.widget.SwipeRefreshLayout} class,
1995 which enables users to refresh the contents of a view with a vertical
1996 swipe gesture.</li>
1997 <li>Fixed accessibility issues with navigation drawers.</li>
1998 </ul>
1999 </dd>
2000
2001 <dt>Changes for v7 appcompat library:</dt>
2002 <dd>
2003 <ul>
2004 <li>Fixed background issues with the action bar.</li>
2005 </ul>
2006 </dd>
2007 </dl>
2008 </div>
2009</div>
2010
2011<div class="toggle-content closed">
2012 <p><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07002013 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Joe Fernandez53b01db2013-11-21 16:16:22 -08002014/>Android Support Library, revision 19.0.1</a> <em>(December 2013)</em>
2015 </p>
2016 <div class="toggle-content-toggleme">
2017 <dl>
2018 <dt>Changes for v4 support library:</dt>
2019 <dd>
2020 <ul>
2021 <li>Improved {@link android.support.v4.print.PrintHelper} by adding asynchronous
2022 handling of printing.</li>
2023 <li>Fixed the {@link android.support.v4.widget.DrawerLayout} class approximation of
2024 the {@link android.view.View#addChildrenForAccessibility addChildrenForAccessibility()}
2025 method.</li>
2026 <li>Fixed slide drawable mirroring in {@link
2027 android.support.v4.app.ActionBarDrawerToggle}.</li>
2028 <li>Fixed off-by-one issue when removing an item from a collection iterator.</li>
2029 </ul>
2030 </dd>
2031
2032 <dt>Changes for v7 mediarouter library:</dt>
2033 <dd>
2034 <ul>
2035 <li>Improved route identification by using full component name in the {@link
2036 android.support.v7.media.MediaRouteProvider.ProviderMetadata}.</li>
2037 <li>Updated {@link android.support.v7.app.MediaRouteChooserDialog} to hide disabled
2038 routes.</li>
2039 </ul>
2040 </dd>
2041
Rich Slogarc9e841e2015-05-06 16:30:47 -07002042 <dt>Changes for <a href="features.html#v8-renderscript">v8 renderscript library</a></dt>
Joe Fernandez53b01db2013-11-21 16:16:22 -08002043 <dd>
2044 <ul>
2045 <li>Added error propagation for the RenderScript thunking layer.</li>
2046 </ul>
2047 </dd>
2048
2049 </dl>
2050 </div>
2051</div>
2052
2053
2054<div class="toggle-content closed">
2055 <p><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07002056 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Joe Fernandezdd697872013-10-24 08:28:11 -07002057/>Android Support Library, revision 19</a> <em>(October 2013)</em>
2058 </p>
2059 <div class="toggle-content-toggleme">
2060 <dl>
2061 <dt>Changes for v4 support library:</dt>
2062 <dd>
2063 <ul>
2064 <li>Added support for external Storage APIs with the
2065 {@link android.support.v4.content.ContextCompat#getObbDirs getObbDirs()},
2066 {@link android.support.v4.content.ContextCompat#getExternalFilesDirs getExternalFilesDirs()},
2067 {@link android.support.v4.content.ContextCompat#getExternalCacheDirs getExternalCacheDirs()},
2068 and {@link android.support.v4.os.EnvironmentCompat#getStorageState getStorageState()}.
2069 These helper methods always return a single file object on devices running Android
2070 4.3 (API level 18) and earlier. When running on Android 4.4 (API level 19) and higher,
2071 these methods may return more than one file object.</li>
2072 <li>Added {@link android.support.v4.print.PrintHelper} class that works with the
2073 Print APIs to print images with a minimum of code.</li>
2074 <li>Added drag-to-open user interface support for pop-up menus. For more information, see
2075 {@link android.support.v4.widget.PopupMenuCompat} and
2076 {@link android.support.v4.widget.ListPopupWindowCompat}.</li>
2077 <li>Improved accessibility support with the addition of a
2078 {@link android.support.v4.view.accessibility.AccessibilityNodeProviderCompat#findFocus
2079 findFocus()} method in
2080 {@link android.support.v4.view.accessibility.AccessibilityNodeProviderCompat} and the
2081 {@link android.support.v4.view.accessibility.AccessibilityNodeInfoCompat#getLiveRegion
2082 getLiveRegion()} method in
2083 {@link android.support.v4.view.accessibility.AccessibilityNodeInfoCompat}.</li>
2084 <li>Added helper class {@link android.support.v4.view.ScaleGestureDetectorCompat} for
2085 accessing new scaling gesture methods.</li>
2086 <li>Fixed problem with {@link android.support.v4.app.ActionBarDrawerToggle} in
2087 right-to-left language displays.</li>
2088 <li>Modified {@link android.support.v4.widget.AutoScrollHelper} option to consume
2089 touch events or allow them to be passed through to other views.</li>
2090 </ul>
2091 </dd>
2092
2093 <dt>Changes for v7 mediarouter library:</dt>
2094 <dd>
2095 <ul>
2096 <li>Added support for media playback queuing, setting HTTP header values and media
2097 playback duration.</li>
2098 <li>Added explicit start, get, and end session actions for explicitly managing media
2099 playback sessions with media router.</li>
2100 </ul>
2101 </dd>
2102 </dl>
2103 </div>
2104</div>
2105
2106<div class="toggle-content closed">
2107 <p><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07002108 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Joe Fernandez5ffbba62013-07-15 15:53:03 -07002109/>Android Support Library, revision 18</a> <em>(July 2013)</em>
2110 </p>
2111 <div class="toggle-content-toggleme">
2112 <dl>
2113 <dt>Changes for v4 support library:</dt>
2114 <dd>
2115 <ul>
2116 <li>User interface
2117 <ul>
2118 <li>Added {@link android.support.v4.text.BidiFormatter} for handling
2119 text strings that combine right to left and left to right-formatted text.</li>
2120 <li>Modified {@link android.support.v4.view.ViewPager} to better handle cases where the
2121 pager has a measured width of zero in the initial layout processing.</li>
2122 <li>Modified {@link android.support.v4.widget.DrawerLayout} and
2123 {@link android.support.v4.widget.SlidingPaneLayout} to not throw exceptions for
2124 measurement while the project code is being edited.</li>
2125 </ul>
2126 </li>
2127
2128 <li>Accessibility
2129 <ul>
2130 <li>Added {@link android.support.v4.widget.ExploreByTouchHelper} to simplify the
2131 implementation of accessibility for custom views.</li>
2132 <li>Fixed a problem with {@link android.support.v4.view.ViewPager} incorrectly
2133 populating {@link
2134 android.support.v4.view.accessibility.AccessibilityEventCompat#TYPE_VIEW_SCROLLED
2135 TYPE_VIEW_SCROLLED} accessibility events.</li>
2136 <li>Fixed a null pointer exception in {@link android.support.v4.view.ViewPager} when
2137 populating an accessibility event.</li>
2138 <li>Simplified {@link android.support.v4.view.accessibility.AccessibilityNodeInfoCompat}
2139 by changing {@link java.lang.CharSequence} inputs to {@link java.lang.String} objects.
2140 </li>
2141 <li>Deprecated an {@link android.support.v4.view.accessibility.AccessibilityRecordCompat}
2142 constructor that used an {@link java.lang.Object} as input.</li>
2143 </ul>
2144 </li>
2145
2146 <li>Media
2147 <ul>
2148 <li>Added {@link android.support.v4.media.TransportMediator} helper class to manage
2149 media transport control, such as play, pause, skip and other media actions.</li>
2150 <li>Added {@link android.support.v4.hardware.display.DisplayManagerCompat} for managing
2151 display output to one or more device displays.</li>
2152 </ul>
2153 </li>
2154
2155 <li>Other changes
2156 <ul>
2157 <li>Added {@link android.support.v4.content.WakefulBroadcastReceiver} helper class for
2158 implementing a common pattern of detecting a device wakeup event and passing work off
2159 to a {@link android.app.Service} while ensuring that the device does not go back to
2160 sleep before the handoff is complete.</li>
2161 <li>Added two new APIs,
2162 {@link android.support.v4.content.AsyncTaskLoader#commitContentChanged
2163 commitContentChanged()} and
2164 {@link android.support.v4.content.AsyncTaskLoader#rollbackContentChanged
2165 rollbackContentChanged()}, to {@link android.support.v4.content.AsyncTaskLoader} to
2166 help deal with background updates for data changes that are subsequently canceled.
2167 </li>
2168 </ul>
2169 </li>
2170 </ul>
2171 </dd>
2172
2173 <dt>New v7 appcompat library:</dt>
2174 <dd>
2175 <ul>
2176 <li>Added {@link android.support.v7.app.ActionBar} to allow implementation of the
Joe Fernandez7ec2cc52013-07-25 10:09:17 -07002177 action bar user interface <a href="{@docRoot}design/patterns/actionbar.html">design
Joe Fernandez5ffbba62013-07-15 15:53:03 -07002178 pattern</a> back to Android 2.1 (API level 7) and higher. Use of this class requires
2179 that you implement your activity by extending the new
2180 {@link android.support.v7.app.ActionBarActivity} class.</li>
2181 </ul>
2182 </dd>
2183
Dirk Dougherty37ec33742013-07-29 20:44:17 -07002184 <dt>New v7 mediarouter library:</dt>
2185 <dd>
2186 <p>Added a new mediarouter library that provides support for the <a
2187 href="https://developers.google.com/cast/">Google Cast developer preview</a>.
2188 The v7 mediarouter library APIs provide a means of controlling the routing of
2189 media channels and streams from the current device to external screens,
2190 speakers, and other destination devices, with compatibility back to Android 2.1
2191 (API level 7). See <a
2192 href="{@docRoot}tools/support-library/features.html#v7-mediarouter">V7
2193 mediarouter library</a> for more information. </p>
2194
2195 <p class="caution">The v7 mediarouter library APIs introduced in Support
2196 Library r18 are subject to change in later revisions of the Support
2197 Library. At this time, we recommend using the library only in connection
2198 with the <a href="https://developers.google.com/cast/">Google Cast
2199 developer preview</a>.</p>
2200 </dd>
2201
Joe Fernandez5ffbba62013-07-15 15:53:03 -07002202 </dl>
2203 </div>
2204</div>
2205
2206
2207<div class="toggle-content closed">
2208 <p><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07002209 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Joe Fernandez5ffbba62013-07-15 15:53:03 -07002210/>Android Support Library, revision 13</a> <em>(May 2013)</em>
Joe Fernandez41ad8952013-05-08 15:02:31 -07002211 </p>
2212 <div class="toggle-content-toggleme">
2213 <dl>
2214 <dt>Changes for v4 support library:</dt>
2215 <dd>
2216 <ul>
2217 <li>Added {@link android.support.v4.widget.DrawerLayout} for creating a
2218 <a href="{@docRoot}training/implementing-navigation/nav-drawer.html">Navigation
2219 Drawer</a> that can be pulled in from the edge of a window.</li>
2220 <li>Added {@link android.support.v4.widget.SlidingPaneLayout} widget for creating linked
2221 summary and detail views that appropriately adapt to various screen sizes.</li>
2222 <li>Added {@link android.support.v4.app.ActionBarDrawerToggle} as a way to tie
2223 together the functions of {@link android.support.v4.widget.DrawerLayout} and {@link
2224 android.app.ActionBar}.</li>
2225 <li>Added {@link android.support.v4.widget.ViewDragHelper} as a new common component
2226 for dragging views within a parent view.</li>
2227 <li>Added {@link android.support.v4.widget.ScrollerCompat} to provide {@link
2228 android.widget.Scroller} and {@link android.widget.OverScroller} compatibility support.
2229 </li>
Joe Fernandeza502c592013-05-23 11:16:09 -07002230 <li>Added {@link android.support.v4.content.FileProvider} to allow sharing of private
2231 files between applications.</li>
Joe Fernandez41ad8952013-05-08 15:02:31 -07002232 <li>Updated {@link android.support.v4.view.ViewPager} to throw an exception if the
Joe Fernandez5ffbba62013-07-15 15:53:03 -07002233 associated {@link android.support.v4.view.PagerAdapter} class is modified without a
2234 call to {@link android.support.v4.view.PagerAdapter#notifyDataSetChanged
2235 notifyDataSetChanged()}.
Joe Fernandez41ad8952013-05-08 15:02:31 -07002236 </li>
2237 <li>Fixed an issue with {@link android.support.v4.view.ViewPager} children drawing sort
2238 order.</li>
2239 <li>Fixed {@link android.support.v4.view.GestureDetectorCompat} to dispatch missing
2240 {@link android.view.GestureDetector.SimpleOnGestureListener#onSingleTapConfirmed} calls
2241 between tap timeout and long press events.</li>
2242 </ul>
2243 </dd>
Joe Fernandez5ffbba62013-07-15 15:53:03 -07002244
2245 <dt>New v7 gridlayout library:</dt>
2246 <dd>
2247 <ul>
2248 <li>Added {@link android.support.v7.widget.GridLayout} to provide support for the
2249 {@link android.widget.GridLayout} layout object.</li>
2250 <li>Added {@link android.support.v7.widget.Space} which can be used to create blank areas
2251 within a {@link android.support.v7.widget.GridLayout} layout object.</li>
2252 </ul>
Joe Fernandez41ad8952013-05-08 15:02:31 -07002253 </dl>
2254 </div>
2255</div>
2256
2257
2258<div class="toggle-content closed">
2259 <p><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07002260 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Joe Fernandez5ffbba62013-07-15 15:53:03 -07002261/>Android Support Library, revision 12</a> <em>(February 2013)</em>
Joe Fernandez02c78192013-02-13 14:03:27 -08002262 </p>
2263 <div class="toggle-content-toggleme">
2264 <dl>
2265 <dt>Changes for v4 support library:</dt>
2266 <dd>
2267 <ul>
2268 <li>Improved interaction behavior for {@link android.support.v4.view.ViewPager}.</li>
2269 <li>Fixed a bug that could cause {@link android.support.v4.view.ViewPager} to select the
2270 wrong page.</li>
2271 <li>Fixed use of {@link android.support.v4.view.ViewPager#removeView removeView()} method
2272 during layout for {@link android.support.v4.view.ViewPager}.</li>
2273 <li>Fixed issue with {@link android.support.v4.widget.SearchViewCompat} where using the
2274 back button to dismiss does not clear the search text. This fix only applies to
2275 host API levels 14 and higher.</li>
2276 </ul>
2277 </dd>
2278 </dl>
2279 </div>
2280</div>
2281
Joe Fernandez5ffbba62013-07-15 15:53:03 -07002282
Joe Fernandez02c78192013-02-13 14:03:27 -08002283<div class="toggle-content closed">
2284 <p><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07002285 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Joe Fernandez5ffbba62013-07-15 15:53:03 -07002286/>Android Support Library, revision 11</a> <em>(November 2012)</em>
Joe Fernandez1292f1e2012-11-09 10:52:22 -08002287 </p>
2288 <div class="toggle-content-toggleme">
2289 <dl>
2290 <dt>Changes for v4 support library:</dt>
2291 <dd>
2292 <ul>
2293 <li>User Interface
2294 <ul>
2295 <li>Added support for nested {@link android.support.v4.app.Fragment} classes.</li>
2296 <li>Added improvements to {@link android.support.v4.app.FragmentManager} debugging.
2297 </li>
2298 <li>Fixed problem in {@link android.support.v4.app.FragmentTabHost} where fragment
2299 and tab interaction could result in a {@link android.widget.ListView} state loss.
2300 </li>
2301 <li>Fixed issue with user-visible hint in
2302 {@link android.support.v4.app.FragmentStatePagerAdapter}.</li>
2303 <li>Added {@link android.support.v4.view.ViewPager.PageTransformer PageTransformer}
2304 interface to {@link android.support.v4.view.ViewPager} to allow applications to
2305 supply a custom transition behavior for scrolling.</li>
2306 <li>Added new features and fixes to {@link android.support.v4.app.TaskStackBuilder}
2307 from current release.</li>
2308 <li>Fixed {@link android.support.v4.view.PagerTitleStrip} to correctly track the
2309 {@link android.support.v4.view.PagerAdapter} currently in use.</li>
2310 <li>Fixed display flickering, positioning, and text clipping problems with
2311 {@link android.support.v4.view.PagerTitleStrip}.</li>
2312 <li>Fixed {@link android.support.v4.view.PagerTabStrip} to properly respect padding
2313 when drawing an underline.</li>
2314 </ul>
2315 </li>
2316 <li>Accessibility
2317 <ul>
2318 <li>Added support for new accessibility gesture and touch event types in
2319 {@link android.support.v4.view.accessibility.AccessibilityEventCompat}.</li>
2320 <li>Added support for new accessibility APIs in
2321 {@link android.support.v4.view.ViewCompat}.</li>
2322 <li>Added support for {@link android.support.v4.view.ViewCompat#performAccessibilityAction
2323 performAccessibilityAction()} method to {@link android.support.v4.view.ViewCompat}.
2324 </li>
2325 </ul>
2326 </li>
2327 <li>Added support for gestures with {@link android.support.v4.view.GestureDetectorCompat}.
2328 </li>
2329 <li>Added support for performing atomic operations on files using a new
2330 {@link android.support.v4.util.AtomicFile} class.</li>
2331 <li>Added support for the full set of {@code make} methods in
2332 {@link android.support.v4.content.IntentCompat}.</li>
2333 <li>Added {@link android.support.v4.util.LruCache#trimToSize trimToSize()} method in
2334 {@link android.support.v4.util.LruCache} utility class.</li>
2335 <li>Updated {@link android.support.v4.net.ConnectivityManagerCompat} to get NetworkInfo
2336 from a {@link android.net.ConnectivityManager#CONNECTIVITY_ACTION}
2337 broadcast.</li>
2338 </ul>
2339 </dd>
2340 </dl>
2341 </div>
2342</div>
Scott Main50e990c2012-06-21 17:14:39 -07002343
Joe Fernandez1292f1e2012-11-09 10:52:22 -08002344
2345<div class="toggle-content closed">
2346 <p><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07002347 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Joe Fernandez5ffbba62013-07-15 15:53:03 -07002348/>Android Support Library, revision 10</a> <em>(August 2012)</em>
Joe Fernandez1292f1e2012-11-09 10:52:22 -08002349 </p>
2350 <div class="toggle-content-toggleme">
Scott Main607079d2012-08-09 14:13:22 -07002351 <dl>
2352 <dt>Changes for v4 support library:</dt>
2353 <dd>
2354 <ul>
Joe Fernandez02c78192013-02-13 14:03:27 -08002355 <li>Added support for notification features introduced in Android 4.1 (API level 16) with
Scott Main607079d2012-08-09 14:13:22 -07002356 additions to {@link android.support.v4.app.NotificationCompat}.</li>
2357 </ul>
2358 </dd>
2359 </dl>
2360 </div>
2361</div>
2362
2363
Joe Fernandez1292f1e2012-11-09 10:52:22 -08002364<div class="toggle-content closed">
2365 <p><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07002366 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Joe Fernandez5ffbba62013-07-15 15:53:03 -07002367/>Android Support Library, revision 9</a> <em>(June 2012)</em>
Joe Fernandez1292f1e2012-11-09 10:52:22 -08002368 </p>
2369 <div class="toggle-content-toggleme">
Joe Fernandezf86f0e62012-06-19 09:54:07 -07002370 <dl>
2371 <dt>Changes for v4 support library:</dt>
2372 <dd>
2373 <ul>
2374
2375 <li>User Interface Support
2376 <ul>
2377 <li>Added {@link android.support.v4.view.PagerTabStrip} support, providing enhanced
2378functionality beyond {@link android.support.v4.view.PagerTitleStrip}.</li>
2379 <li>Fixed various bugs for {@link android.support.v4.view.PagerTitleStrip} and
2380{@link android.support.v4.view.PagerTabStrip}, including {@link
2381android.widget.TextView#setAllCaps setAllCaps} option, title alignment,
2382appearance improvements, minimum width constraints and touch navigation issues.</li>
2383 <li>Added support for {@link android.support.v4.view.ViewPager} page gutters, which
2384helps the {@link android.support.v4.view.ViewPager} class provide paging support for content with
2385a large horizontal scroll range, such as a map.</li>
2386 <li>Fixed numerous bugs for {@link android.support.v4.view.ViewPager}, including size
2387and data set change problems, page positioning, user interaction, scroll tracking and keyboard
2388navigation problems.</li>
2389 <li>Fixed many bugs for {@link android.support.v4.app.Fragment}, including proper
2390handling of {@link android.support.v4.app.Fragment#onActivityResult onActivityResult()} when
2391the target fragment no longer exists, dispatching selection events to invisible fragments, improved
2392{@link android.support.v4.app.FragmentTransaction#replace FragmentTransaction.replace()} behavior
2393and added better state handling for fragments being moved out of view.</li>
2394 <li>Added support for the {@link
2395android.support.v4.view.ViewCompat postOnAnimation()} method in {@link
2396android.support.v4.view.ViewCompat}.</li>
2397 <li>Updated {@link android.support.v4.app.NavUtils} to use Android 4.1 (API level 16)
2398<em>Up</em> navigation functionality when available.</li>
2399 </ul>
2400 </li>
2401
2402 <li>Accessibility
2403 <ul>
2404 <li>Updated accessibility support classes, including {@link
2405android.support.v4.view.accessibility.AccessibilityNodeInfoCompat}, to follow fixes made in Android
24064.1 (API level 16).</li>
2407 <li>Added support for accessibility scroll actions in {@link
2408android.support.v4.view.ViewPager}.</li>
2409 </ul>
2410 </li>
2411
2412 <li>General improvements
2413 <ul>
2414 <li>Updated {@link android.support.v4.app.TaskStackBuilder} to reflect API changes in
2415Android 4.1 (API level 16).</li>
2416 <li>Enhanced {@link android.support.v4.app.TaskStackBuilder} to allow it to be used
2417from a Service.</li>
2418 <li>Added support for {@link android.support.v4.content.IntentCompat EXTRA_HTML_TEXT}
2419to {@link android.support.v4.app.ShareCompat}.</li>
2420 <li>Updated {@link android.support.v4.app.NotificationCompat.Builder} to support the
2421{@link android.support.v4.app.NotificationCompat.Builder#setNumber setNumber()} method.</li>
2422 <li>Added support in {@link android.support.v4.net.ConnectivityManagerCompat} for the
2423{@link android.support.v4.net.ConnectivityManagerCompat#isActiveNetworkMetered
2424isActiveNetworkMetered()} method.</li>
2425 </ul>
2426 </li>
2427 </ul>
2428 </dd>
2429 </dl>
2430 </div>
2431</div>
2432
Joe Fernandez5ffbba62013-07-15 15:53:03 -07002433
Joe Fernandez1292f1e2012-11-09 10:52:22 -08002434<div class="toggle-content closed">
2435 <p><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07002436 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Joe Fernandez5ffbba62013-07-15 15:53:03 -07002437/>Android Support Library, revision 8</a> <em>(April 2012)</em>
Joe Fernandez1292f1e2012-11-09 10:52:22 -08002438 </p>
2439 <div class="toggle-content-toggleme">
Scott Main50e990c2012-06-21 17:14:39 -07002440 <dl>
2441 <dt>Changes for v4 support library:</dt>
2442 <dd>
2443 <ul>
2444 <li>Fixed intent flags for {@link android.app.PendingIntent} objects generated
2445 by {@link android.support.v4.app.TaskStackBuilder}.</li>
2446 <li>Removed unused attributes from the gridlayout library projects to make sure
Joe Fernandez02c78192013-02-13 14:03:27 -08002447 the library can be built with API level 7 and higher.</li>
Scott Main50e990c2012-06-21 17:14:39 -07002448 <li>Added {@code .classpath} and {@code .project} files for the gridlayout
2449 library project.</li>
2450 </ul>
2451 </dd>
2452 </dl>
Joe Fernandezf86f0e62012-06-19 09:54:07 -07002453 </div>
Scott Main50e990c2012-06-21 17:14:39 -07002454</div>
2455
Joe Fernandez5ffbba62013-07-15 15:53:03 -07002456
Joe Fernandez1292f1e2012-11-09 10:52:22 -08002457<div class="toggle-content closed">
2458 <p><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07002459 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Joe Fernandez5ffbba62013-07-15 15:53:03 -07002460/>Android Support Library, revision 7</a> <em>(March 2012)</em>
Joe Fernandez1292f1e2012-11-09 10:52:22 -08002461 </p>
2462 <div class="toggle-content-toggleme">
Scott Main50e990c2012-06-21 17:14:39 -07002463 <dl>
2464 <dt>Changes for v4 support library:</dt>
2465 <dd>
2466 <ul>
2467 <li>Added {@link android.support.v4.app.ShareCompat}, which provides helper classes
2468for sending and receiving content for social sharing applications, including new metadata for
2469attributing shared data to the source app. This class also provides compatible integration with the
2470new {@link android.widget.ShareActionProvider} in Android 4.0.</li>
2471 <li>Added {@link android.support.v4.app.NavUtils} and {@link
2472android.support.v4.app.TaskStackBuilder} to provide support for implementing the
Joe Fernandez1292f1e2012-11-09 10:52:22 -08002473<a href="{@docRoot}design/index.html">Android Design</a> guidelines for navigation. These
Scott Main50e990c2012-06-21 17:14:39 -07002474additions include a way to implement the action bar's <em>Up</em> button across versions.
2475For an example implementation of this pattern, see the AppNavigation sample in
Neil Fuller71fbb812015-11-30 09:51:33 +00002476(<code><em>&lt;sdk&gt;</em>/samples/<em>&lt;platform&gt;</em>/AppNavigation</code>).</li>
Scott Main50e990c2012-06-21 17:14:39 -07002477 <li>Added {@link android.support.v4.app.NotificationCompat.Builder} to provide a
2478compatibility implementation of Android 3.0's {@link android.app.Notification.Builder} helper class
2479for creating standardized system notifications.</li>
2480 </ul>
2481 </dd>
2482 </dl>
2483 </div>
Joe Fernandezf86f0e62012-06-19 09:54:07 -07002484</div>
Scott Main50e990c2012-06-21 17:14:39 -07002485
Joe Fernandez5ffbba62013-07-15 15:53:03 -07002486
Joe Fernandez1292f1e2012-11-09 10:52:22 -08002487<div class="toggle-content closed">
2488 <p><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07002489 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Joe Fernandez5ffbba62013-07-15 15:53:03 -07002490/>Android Support Library, revision 6</a> <em>(December 2011)</em>
Joe Fernandez1292f1e2012-11-09 10:52:22 -08002491 </p>
2492 <div class="toggle-content-toggleme">
Scott Main50e990c2012-06-21 17:14:39 -07002493
Scott Main50e990c2012-06-21 17:14:39 -07002494 <p class="note"><strong>Note:</strong> Reference for support library APIs are now available with
2495 the framework references, for example: {@link android.support.v4.app}.</p>
2496<dl>
2497 <dt>Changes for v4 support library:</dt>
2498 <dd>
2499 <ul>
2500 <li>Changes to ViewPager:
2501 <ul>
2502 <li>Added extra decorative view support for {@link android.support.v4.view.ViewPager}.
2503 Decorative views may be supplied as child views of a pager in XML layout.</li>
2504 <li>Added {@link android.support.v4.view.PagerAdapter#getPageTitle
2505 PagerAdapter.getPageTitle()} to supply title strings for pages, which defaults to no
2506 title for each page.</li>
2507 <li>Added {@link android.support.v4.view.PagerTitleStrip}, a non-interactive title
2508 strip, that can be added as a child of ViewPager. Developers can supply text
2509 appearance and color, as well as layout sizing and gravity information.</li>
2510 <li>Updated {@link android.support.v4.view.PagerAdapter} methods to take ViewGroup
2511 objects, rather than View to avoid class casting in adapter implementations.</li>
2512 <li>Updated {@link android.support.v4.view.ViewPager} to use Launcher-style
2513 fling behavior.</li>
2514 <li>Bug fixes for user interface interaction and test automation.</li>
2515 </ul>
2516 </li>
2517
2518 <li>Support for Fragments:
2519 <ul>
2520 <li>Changed {@code setStartDeferred()} method to {@link
2521 android.support.v4.app.Fragment#setUserVisibleHint}.</li>
2522 <li>Added deferred start for off-screen pages to improve performance.</li>
2523 </ul>
2524 </li>
2525
2526 <li>Support for Accessiblity APIs:
2527 <ul>
2528 <li>Updated {@link android.support.v4.view.AccessibilityDelegateCompat} methods
2529 to return empty lists instead of null.</li>
2530 <li>Added new APIs needed by the v4 samples.</li>
2531 </ul>
2532 </li>
2533
2534 </ul>
2535 </dd>
2536 </dl>
2537 </div>
Joe Fernandezf86f0e62012-06-19 09:54:07 -07002538</div>
Scott Main50e990c2012-06-21 17:14:39 -07002539
Joe Fernandez1292f1e2012-11-09 10:52:22 -08002540<div class="toggle-content closed">
2541 <p><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07002542 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Joe Fernandez5ffbba62013-07-15 15:53:03 -07002543/>Android Support Library, revision 5</a> <em>(December 2011)</em>
Joe Fernandez1292f1e2012-11-09 10:52:22 -08002544 </p>
2545 <div class="toggle-content-toggleme">
Scott Main50e990c2012-06-21 17:14:39 -07002546 <dl>
2547 <dt>Changes for v4 support library:</dt>
2548 <dd>
2549 <ul>
2550 <li>Support for Accessiblity APIs:
2551 <ul>
2552 <li>Added {@link android.support.v4.view.AccessibilityDelegateCompat}
2553 to support {@link android.view.View.AccessibilityDelegate}.</li>
2554
2555 <li>Added {@link android.support.v4.view.accessibility.AccessibilityEventCompat}
2556 to support {@link android.view.accessibility.AccessibilityEvent}.</li>
2557
2558 <li>Added {@link android.support.v4.view.accessibility.AccessibilityManagerCompat}
2559 to support {@link android.view.accessibility.AccessibilityManager}.</li>
2560
2561 <li>Added {@link android.support.v4.view.accessibility.AccessibilityNodeInfoCompat}
2562 to support {@link android.view.accessibility.AccessibilityNodeInfo}.</li>
2563
2564 <li>Added {@link android.support.v4.view.accessibility.AccessibilityRecordCompat}
2565 to support {@link android.view.accessibility.AccessibilityRecord}.</li>
2566
2567 <li>Added {@link
2568 android.support.v4.accessibilityservice.AccessibilityServiceInfoCompat}
2569 to support {@link android.accessibilityservice.AccessibilityServiceInfo}.</li>
2570
2571 <li>Added {@link android.support.v4.view.ViewGroupCompat}
2572 to support accessibility features in {@link android.view.ViewGroup}.
2573 </li>
2574
2575 <li>Modified {@link android.support.v4.view.ViewCompat}
2576 to support accessibility features in {@link android.view.View}.</li>
2577 </ul>
2578 </li>
2579
2580 <li>Changes to ViewPager:
2581 <ul>
2582 <li>Added support for margins between pages.
2583 An optional {@link android.graphics.drawable.Drawable} can be provided
2584 to fill the margins.</li>
2585 <li>Added support for {@link android.widget.EdgeEffect}.</li>
2586 <li>Added support for keyboard navigation</li>
2587 <li>Added support to control how many pages are kept to either side
2588 of the current page.</li>
2589 <li>Improved touch physics.</li>
2590 <li>Bug fixes for user interface behavior.</li>
2591 </ul>
2592 </li>
2593 </ul>
2594 </dd>
2595 </dl>
2596 </div>
Joe Fernandezf86f0e62012-06-19 09:54:07 -07002597</div>
Scott Main50e990c2012-06-21 17:14:39 -07002598
Joe Fernandez1292f1e2012-11-09 10:52:22 -08002599<div class="toggle-content closed">
2600 <p><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07002601 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Joe Fernandez5ffbba62013-07-15 15:53:03 -07002602/>Android Support Library, revision 4</a> <em>(October 2011)</em>
Joe Fernandez1292f1e2012-11-09 10:52:22 -08002603 </p>
2604 <div class="toggle-content-toggleme">
Scott Main50e990c2012-06-21 17:14:39 -07002605 <dl>
2606 <dt>Changes for v4 support library:</dt>
2607 <dd>
2608 <ul>
2609 <li>Added <code>EdgeEffectCompat</code> to
2610 support {@link android.widget.EdgeEffect}.</li>
2611
2612 <li>Added <code>LocalBroadcastManager</code> to allow applications to easily
2613 register for and receive intents within a single application without
2614 broadcasting them globally.</li>
2615
2616 <li>Added support in <code>ViewCompat</code> to check for and set overscroll
2617 modes for {@link android.view.View}s on Android 2.3 and later.</li>
2618 <li>Changes to Fragment APIs:
2619 <ul>
2620 <li>Added new APIs to control the visibility of new menus.</li>
2621 <li>Added custom animation APIs.</li>
2622 <li>Added APIs in <code>FragmentActivity</code> to retain custom,
2623 non-configuration instance data.</li>
2624 <li>Various bug fixes.</li>
2625 </ul>
2626 </li>
2627
2628 <li>Fixed a {@link android.content.Loader} bug that caused issues in
2629 canceling {@link android.os.AsyncTask}s when running on Froyo and older
2630 versions of the platform. The support
2631 code now uses its own version of {@link android.os.AsyncTask} to keep the same
2632 behavior on all platform versions.</li>
2633
2634 </ul>
2635 </dd>
2636 </dl>
2637 </div>
Scott Main50e990c2012-06-21 17:14:39 -07002638</div>
2639
2640
Joe Fernandez1292f1e2012-11-09 10:52:22 -08002641<div class="toggle-content closed">
2642 <p><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07002643 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Joe Fernandez5ffbba62013-07-15 15:53:03 -07002644/>Android Support Library, revision 3</a> <em>(July 2011)</em>
Joe Fernandez1292f1e2012-11-09 10:52:22 -08002645 </p>
2646 <div class="toggle-content-toggleme">
Scott Main50e990c2012-06-21 17:14:39 -07002647 <dl>
2648 <dt>Changes for v4 support library:</dt>
2649 <dd>
2650 <ul>
2651 <li>Adds support for {@link android.app.Fragment.SavedState}</li>
2652 <li>Adds {@code MotionEventCompat} to support newer {@link
2653android.view.MotionEvent} APIs</li>
2654 <li>Adds {@code VelocityTrackerCompat} to support a newer {@link
2655android.view.VelocityTracker} APIs</li>
2656 <li>Adds {@code ViewConfigurationCompat} to support a newer {@link
2657android.view.ViewConfiguration} APIs</li>
2658 <li>All new APIs (available only in the support library) that allow you to create UIs
2659with horizontal paging, allowing users to swipe left and right between content views. Classes to
2660support this include:
2661 <ul>
2662 <li>{@code ViewPager}: A {@link android.view.ViewGroup} that manages the
2663layout for the child views, which the user can swipe between.</li>
2664 <li>{@code PagerAdapter}: An adapter that populates the {@code ViewPager} with the
2665views that represent each page.</li>
2666 <li>{@code FragmentPagerAdapter}: An extension of {@code PagerAdapter} for flipping
2667between fragments.</li>
2668 <li>{@code FragmentStatePagerAdapter}: An extension of {@code PagerAdapter} for
2669flipping between fragments that uses the library's support for {@link
2670android.app.Fragment.SavedState}.</li>
2671 </ul>
2672 </li>
2673 </ul>
2674 </dd>
2675 <dt>New v13 support library:</dt>
2676 <dd>
2677 <ul>
2678 <li>Includes the {@code FragmentPagerAdapter} and {@code FragmentStatePagerAdapter}
2679to support the horizontal paging.
2680 <p>These are exactly the same as the APIs added to the v4 support library, but rely on
2681other platform components in Android 3.2. Use this library instead of v4 if you're developing for
2682Android 3.2 and higher (all other APIs in the v4 library are already available with API level
268313).</p>
2684 </li>
2685 </ul>
2686 </dd>
2687 </dl>
2688 </div>
Scott Main50e990c2012-06-21 17:14:39 -07002689</div>
2690
2691
Joe Fernandez1292f1e2012-11-09 10:52:22 -08002692<div class="toggle-content closed">
2693 <p><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07002694 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Joe Fernandez5ffbba62013-07-15 15:53:03 -07002695/>Android Support Library, revision 2</a> <em>(May 2011)</em>
Joe Fernandez1292f1e2012-11-09 10:52:22 -08002696 </p>
2697 <div class="toggle-content-toggleme">
Scott Main50e990c2012-06-21 17:14:39 -07002698 <dl>
2699 <dt>Changes for v4 library:</dt>
2700 <dd>
2701 <ul>
2702 <li>Support for fragment animations</li>
Joe Fernandez5ffbba62013-07-15 15:53:03 -07002703 <li>Fix {@link android.support.v4.app.Fragment#onActivityResult Fragment.onActivityResult()}
Scott Main50e990c2012-06-21 17:14:39 -07002704 bug</li>
2705 </ul>
2706 </dd>
2707 </dl>
2708 </div>
Scott Main50e990c2012-06-21 17:14:39 -07002709</div>
2710
2711
Joe Fernandez1292f1e2012-11-09 10:52:22 -08002712<div class="toggle-content closed">
2713 <p><a href="#" onclick="return toggleContent(this)">
Trevor Johns682c24e2016-04-12 10:13:47 -07002714 <img src="{@docRoot}assets/images/styles/disclosure_down.png" class="toggle-content-img" alt=""
Joe Fernandez5ffbba62013-07-15 15:53:03 -07002715/>Android Support Library, revision 1</a> <em>(March 2011)</em>
Joe Fernandez1292f1e2012-11-09 10:52:22 -08002716 </p>
2717 <div class="toggle-content-toggleme">
Scott Main50e990c2012-06-21 17:14:39 -07002718 <p>Initial release with the v4 library.</p>
2719 </div>
Scott Main50e990c2012-06-21 17:14:39 -07002720</div>
Dirk Dougherty6c1c2632015-05-02 16:31:11 -07002721