1 page.title=Support Library 2 3 @jd:body 4 5 <div id="qv-wrapper"> 6 <div id="qv"> 7 8 <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> 13 14 <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> 21 22 </div> 23 </div> 24 25 <p>The Android Support Library package is a set of code libraries that provide 26 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> 30 31 <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> 33 34 35 <h2 id="overview">Overview</h2> 36 37 <p>Including the Support Libraries in your Android project is considered a best practice for 38 application developers, depending on the range of platform versions your app is targeting 39 and the APIs that it uses. Using the features the libraries provide can help you improve the look of your 40 application, increase performance and broaden the reach of your application to more users. 41 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> 60 61 62 <div class="toggle-content opened"> 63 <p><a href="#" onclick="return toggleContent(this)"> 64 <img src="{@docRoot}assets/images/triangle-opened.png" class="toggle-content-img" alt="" 65 />Android Support Library, revision 18</a> <em>(July 2013)</em> 66 </p> 67 <div class="toggle-content-toggleme"> 68 <dl> 69 <dt>Changes for v4 support library:</dt> 70 <dd> 71 <ul> 72 <li>User interface 73 <ul> 74 <li>Added {@link android.support.v4.text.BidiFormatter} for handling 75 text strings that combine right to left and left to right-formatted text.</li> 76 <li>Modified {@link android.support.v4.view.ViewPager} to better handle cases where the 77 pager has a measured width of zero in the initial layout processing.</li> 78 <li>Modified {@link android.support.v4.widget.DrawerLayout} and 79 {@link android.support.v4.widget.SlidingPaneLayout} to not throw exceptions for 80 measurement while the project code is being edited.</li> 81 </ul> 82 </li> 83 84 <li>Accessibility 85 <ul> 86 <li>Added {@link android.support.v4.widget.ExploreByTouchHelper} to simplify the 87 implementation of accessibility for custom views.</li> 88 <li>Fixed a problem with {@link android.support.v4.view.ViewPager} incorrectly 89 populating {@link 90 android.support.v4.view.accessibility.AccessibilityEventCompat#TYPE_VIEW_SCROLLED 91 TYPE_VIEW_SCROLLED} accessibility events.</li> 92 <li>Fixed a null pointer exception in {@link android.support.v4.view.ViewPager} when 93 populating an accessibility event.</li> 94 <li>Simplified {@link android.support.v4.view.accessibility.AccessibilityNodeInfoCompat} 95 by changing {@link java.lang.CharSequence} inputs to {@link java.lang.String} objects. 96 </li> 97 <li>Deprecated an {@link android.support.v4.view.accessibility.AccessibilityRecordCompat} 98 constructor that used an {@link java.lang.Object} as input.</li> 99 </ul> 100 </li> 101 102 <li>Media 103 <ul> 104 <li>Added {@link android.support.v4.media.TransportMediator} helper class to manage 105 media transport control, such as play, pause, skip and other media actions.</li> 106 <li>Added {@link android.support.v4.hardware.display.DisplayManagerCompat} for managing 107 display output to one or more device displays.</li> 108 </ul> 109 </li> 110 111 <li>Other changes 112 <ul> 113 <li>Added {@link android.support.v4.content.WakefulBroadcastReceiver} helper class for 114 implementing a common pattern of detecting a device wakeup event and passing work off 115 to a {@link android.app.Service} while ensuring that the device does not go back to 116 sleep before the handoff is complete.</li> 117 <li>Added two new APIs, 118 {@link android.support.v4.content.AsyncTaskLoader#commitContentChanged 119 commitContentChanged()} and 120 {@link android.support.v4.content.AsyncTaskLoader#rollbackContentChanged 121 rollbackContentChanged()}, to {@link android.support.v4.content.AsyncTaskLoader} to 122 help deal with background updates for data changes that are subsequently canceled. 123 </li> 124 </ul> 125 </li> 126 </ul> 127 </dd> 128 129 <dt>New v7 appcompat library:</dt> 130 <dd> 131 <ul> 132 <li>Added {@link android.support.v7.app.ActionBar} to allow implementation of the 133 action bar user interface <a href="{@docRoot}design/patterns/actionbar.html">design 134 pattern</a> back to Android 2.1 (API level 7) and higher. Use of this class requires 135 that you implement your activity by extending the new 136 {@link android.support.v7.app.ActionBarActivity} class.</li> 137 </ul> 138 </dd> 139 140 <dt>New v7 mediarouter library:</dt> 141 <dd> 142 <p>Added a new mediarouter library that provides support for the <a 143 href="https://developers.google.com/cast/">Google Cast developer preview</a>. 144 The v7 mediarouter library APIs provide a means of controlling the routing of 145 media channels and streams from the current device to external screens, 146 speakers, and other destination devices, with compatibility back to Android 2.1 147 (API level 7). See <a 148 href="{@docRoot}tools/support-library/features.html#v7-mediarouter">V7 149 mediarouter library</a> for more information. </p> 150 151 <p class="caution">The v7 mediarouter library APIs introduced in Support 152 Library r18 are subject to change in later revisions of the Support 153 Library. At this time, we recommend using the library only in connection 154 with the <a href="https://developers.google.com/cast/">Google Cast 155 developer preview</a>.</p> 156 </dd> 157 158 </dl> 159 </div> 160 </div> 161 162 163 <div class="toggle-content closed"> 164 <p><a href="#" onclick="return toggleContent(this)"> 165 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" 166 />Android Support Library, revision 13</a> <em>(May 2013)</em> 167 </p> 168 <div class="toggle-content-toggleme"> 169 <dl> 170 <dt>Changes for v4 support library:</dt> 171 <dd> 172 <ul> 173 <li>Added {@link android.support.v4.widget.DrawerLayout} for creating a 174 <a href="{@docRoot}training/implementing-navigation/nav-drawer.html">Navigation 175 Drawer</a> that can be pulled in from the edge of a window.</li> 176 <li>Added {@link android.support.v4.widget.SlidingPaneLayout} widget for creating linked 177 summary and detail views that appropriately adapt to various screen sizes.</li> 178 <li>Added {@link android.support.v4.app.ActionBarDrawerToggle} as a way to tie 179 together the functions of {@link android.support.v4.widget.DrawerLayout} and {@link 180 android.app.ActionBar}.</li> 181 <li>Added {@link android.support.v4.widget.ViewDragHelper} as a new common component 182 for dragging views within a parent view.</li> 183 <li>Added {@link android.support.v4.widget.ScrollerCompat} to provide {@link 184 android.widget.Scroller} and {@link android.widget.OverScroller} compatibility support. 185 </li> 186 <li>Added {@link android.support.v4.content.FileProvider} to allow sharing of private 187 files between applications.</li> 188 <li>Updated {@link android.support.v4.view.ViewPager} to throw an exception if the 189 associated {@link android.support.v4.view.PagerAdapter} class is modified without a 190 call to {@link android.support.v4.view.PagerAdapter#notifyDataSetChanged 191 notifyDataSetChanged()}. 192 </li> 193 <li>Fixed an issue with {@link android.support.v4.view.ViewPager} children drawing sort 194 order.</li> 195 <li>Fixed {@link android.support.v4.view.GestureDetectorCompat} to dispatch missing 196 {@link android.view.GestureDetector.SimpleOnGestureListener#onSingleTapConfirmed} calls 197 between tap timeout and long press events.</li> 198 </ul> 199 </dd> 200 201 <dt>New v7 gridlayout library:</dt> 202 <dd> 203 <ul> 204 <li>Added {@link android.support.v7.widget.GridLayout} to provide support for the 205 {@link android.widget.GridLayout} layout object.</li> 206 <li>Added {@link android.support.v7.widget.Space} which can be used to create blank areas 207 within a {@link android.support.v7.widget.GridLayout} layout object.</li> 208 </ul> 209 </dl> 210 </div> 211 </div> 212 213 214 <div class="toggle-content closed"> 215 <p><a href="#" onclick="return toggleContent(this)"> 216 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" 217 />Android Support Library, revision 12</a> <em>(February 2013)</em> 218 </p> 219 <div class="toggle-content-toggleme"> 220 <dl> 221 <dt>Changes for v4 support library:</dt> 222 <dd> 223 <ul> 224 <li>Improved interaction behavior for {@link android.support.v4.view.ViewPager}.</li> 225 <li>Fixed a bug that could cause {@link android.support.v4.view.ViewPager} to select the 226 wrong page.</li> 227 <li>Fixed use of {@link android.support.v4.view.ViewPager#removeView removeView()} method 228 during layout for {@link android.support.v4.view.ViewPager}.</li> 229 <li>Fixed issue with {@link android.support.v4.widget.SearchViewCompat} where using the 230 back button to dismiss does not clear the search text. This fix only applies to 231 host API levels 14 and higher.</li> 232 </ul> 233 </dd> 234 </dl> 235 </div> 236 </div> 237 238 239 <div class="toggle-content closed"> 240 <p><a href="#" onclick="return toggleContent(this)"> 241 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" 242 />Android Support Library, revision 11</a> <em>(November 2012)</em> 243 </p> 244 <div class="toggle-content-toggleme"> 245 <dl> 246 <dt>Changes for v4 support library:</dt> 247 <dd> 248 <ul> 249 <li>User Interface 250 <ul> 251 <li>Added support for nested {@link android.support.v4.app.Fragment} classes.</li> 252 <li>Added improvements to {@link android.support.v4.app.FragmentManager} debugging. 253 </li> 254 <li>Fixed problem in {@link android.support.v4.app.FragmentTabHost} where fragment 255 and tab interaction could result in a {@link android.widget.ListView} state loss. 256 </li> 257 <li>Fixed issue with user-visible hint in 258 {@link android.support.v4.app.FragmentStatePagerAdapter}.</li> 259 <li>Added {@link android.support.v4.view.ViewPager.PageTransformer PageTransformer} 260 interface to {@link android.support.v4.view.ViewPager} to allow applications to 261 supply a custom transition behavior for scrolling.</li> 262 <li>Added new features and fixes to {@link android.support.v4.app.TaskStackBuilder} 263 from current release.</li> 264 <li>Fixed {@link android.support.v4.view.PagerTitleStrip} to correctly track the 265 {@link android.support.v4.view.PagerAdapter} currently in use.</li> 266 <li>Fixed display flickering, positioning, and text clipping problems with 267 {@link android.support.v4.view.PagerTitleStrip}.</li> 268 <li>Fixed {@link android.support.v4.view.PagerTabStrip} to properly respect padding 269 when drawing an underline.</li> 270 </ul> 271 </li> 272 <li>Accessibility 273 <ul> 274 <li>Added support for new accessibility gesture and touch event types in 275 {@link android.support.v4.view.accessibility.AccessibilityEventCompat}.</li> 276 <li>Added support for new accessibility APIs in 277 {@link android.support.v4.view.ViewCompat}.</li> 278 <li>Added support for {@link android.support.v4.view.ViewCompat#performAccessibilityAction 279 performAccessibilityAction()} method to {@link android.support.v4.view.ViewCompat}. 280 </li> 281 </ul> 282 </li> 283 <li>Added support for gestures with {@link android.support.v4.view.GestureDetectorCompat}. 284 </li> 285 <li>Added support for performing atomic operations on files using a new 286 {@link android.support.v4.util.AtomicFile} class.</li> 287 <li>Added support for the full set of {@code make} methods in 288 {@link android.support.v4.content.IntentCompat}.</li> 289 <li>Added {@link android.support.v4.util.LruCache#trimToSize trimToSize()} method in 290 {@link android.support.v4.util.LruCache} utility class.</li> 291 <li>Updated {@link android.support.v4.net.ConnectivityManagerCompat} to get NetworkInfo 292 from a {@link android.net.ConnectivityManager#CONNECTIVITY_ACTION} 293 broadcast.</li> 294 </ul> 295 </dd> 296 </dl> 297 </div> 298 </div> 299 300 301 <div class="toggle-content closed"> 302 <p><a href="#" onclick="return toggleContent(this)"> 303 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" 304 />Android Support Library, revision 10</a> <em>(August 2012)</em> 305 </p> 306 <div class="toggle-content-toggleme"> 307 <dl> 308 <dt>Changes for v4 support library:</dt> 309 <dd> 310 <ul> 311 <li>Added support for notification features introduced in Android 4.1 (API level 16) with 312 additions to {@link android.support.v4.app.NotificationCompat}.</li> 313 </ul> 314 </dd> 315 </dl> 316 </div> 317 </div> 318 319 320 <div class="toggle-content closed"> 321 <p><a href="#" onclick="return toggleContent(this)"> 322 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" 323 />Android Support Library, revision 9</a> <em>(June 2012)</em> 324 </p> 325 <div class="toggle-content-toggleme"> 326 <dl> 327 <dt>Changes for v4 support library:</dt> 328 <dd> 329 <ul> 330 331 <li>User Interface Support 332 <ul> 333 <li>Added {@link android.support.v4.view.PagerTabStrip} support, providing enhanced 334 functionality beyond {@link android.support.v4.view.PagerTitleStrip}.</li> 335 <li>Fixed various bugs for {@link android.support.v4.view.PagerTitleStrip} and 336 {@link android.support.v4.view.PagerTabStrip}, including {@link 337 android.widget.TextView#setAllCaps setAllCaps} option, title alignment, 338 appearance improvements, minimum width constraints and touch navigation issues.</li> 339 <li>Added support for {@link android.support.v4.view.ViewPager} page gutters, which 340 helps the {@link android.support.v4.view.ViewPager} class provide paging support for content with 341 a large horizontal scroll range, such as a map.</li> 342 <li>Fixed numerous bugs for {@link android.support.v4.view.ViewPager}, including size 343 and data set change problems, page positioning, user interaction, scroll tracking and keyboard 344 navigation problems.</li> 345 <li>Fixed many bugs for {@link android.support.v4.app.Fragment}, including proper 346 handling of {@link android.support.v4.app.Fragment#onActivityResult onActivityResult()} when 347 the target fragment no longer exists, dispatching selection events to invisible fragments, improved 348 {@link android.support.v4.app.FragmentTransaction#replace FragmentTransaction.replace()} behavior 349 and added better state handling for fragments being moved out of view.</li> 350 <li>Added support for the {@link 351 android.support.v4.view.ViewCompat postOnAnimation()} method in {@link 352 android.support.v4.view.ViewCompat}.</li> 353 <li>Updated {@link android.support.v4.app.NavUtils} to use Android 4.1 (API level 16) 354 <em>Up</em> navigation functionality when available.</li> 355 </ul> 356 </li> 357 358 <li>Accessibility 359 <ul> 360 <li>Updated accessibility support classes, including {@link 361 android.support.v4.view.accessibility.AccessibilityNodeInfoCompat}, to follow fixes made in Android 362 4.1 (API level 16).</li> 363 <li>Added support for accessibility scroll actions in {@link 364 android.support.v4.view.ViewPager}.</li> 365 </ul> 366 </li> 367 368 <li>General improvements 369 <ul> 370 <li>Updated {@link android.support.v4.app.TaskStackBuilder} to reflect API changes in 371 Android 4.1 (API level 16).</li> 372 <li>Enhanced {@link android.support.v4.app.TaskStackBuilder} to allow it to be used 373 from a Service.</li> 374 <li>Added support for {@link android.support.v4.content.IntentCompat EXTRA_HTML_TEXT} 375 to {@link android.support.v4.app.ShareCompat}.</li> 376 <li>Updated {@link android.support.v4.app.NotificationCompat.Builder} to support the 377 {@link android.support.v4.app.NotificationCompat.Builder#setNumber setNumber()} method.</li> 378 <li>Added support in {@link android.support.v4.net.ConnectivityManagerCompat} for the 379 {@link android.support.v4.net.ConnectivityManagerCompat#isActiveNetworkMetered 380 isActiveNetworkMetered()} method.</li> 381 </ul> 382 </li> 383 </ul> 384 </dd> 385 </dl> 386 </div> 387 </div> 388 389 390 <div class="toggle-content closed"> 391 <p><a href="#" onclick="return toggleContent(this)"> 392 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" 393 />Android Support Library, revision 8</a> <em>(April 2012)</em> 394 </p> 395 <div class="toggle-content-toggleme"> 396 <dl> 397 <dt>Changes for v4 support library:</dt> 398 <dd> 399 <ul> 400 <li>Fixed intent flags for {@link android.app.PendingIntent} objects generated 401 by {@link android.support.v4.app.TaskStackBuilder}.</li> 402 <li>Removed unused attributes from the gridlayout library projects to make sure 403 the library can be built with API level 7 and higher.</li> 404 <li>Added {@code .classpath} and {@code .project} files for the gridlayout 405 library project.</li> 406 </ul> 407 </dd> 408 </dl> 409 </div> 410 </div> 411 412 413 <div class="toggle-content closed"> 414 <p><a href="#" onclick="return toggleContent(this)"> 415 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" 416 />Android Support Library, revision 7</a> <em>(March 2012)</em> 417 </p> 418 <div class="toggle-content-toggleme"> 419 <dl> 420 <dt>Changes for v4 support library:</dt> 421 <dd> 422 <ul> 423 <li>Added {@link android.support.v4.app.ShareCompat}, which provides helper classes 424 for sending and receiving content for social sharing applications, including new metadata for 425 attributing shared data to the source app. This class also provides compatible integration with the 426 new {@link android.widget.ShareActionProvider} in Android 4.0.</li> 427 <li>Added {@link android.support.v4.app.NavUtils} and {@link 428 android.support.v4.app.TaskStackBuilder} to provide support for implementing the 429 <a href="{@docRoot}design/index.html">Android Design</a> guidelines for navigation. These 430 additions include a way to implement the action bar's <em>Up</em> button across versions. 431 For an example implementation of this pattern, see the AppNavigation sample in 432 ({@code <em><sdk></em>/samples/<em><platform></em>/AppNavigation}).</li> 433 <li>Added {@link android.support.v4.app.NotificationCompat.Builder} to provide a 434 compatibility implementation of Android 3.0's {@link android.app.Notification.Builder} helper class 435 for creating standardized system notifications.</li> 436 </ul> 437 </dd> 438 </dl> 439 </div> 440 </div> 441 442 443 <div class="toggle-content closed"> 444 <p><a href="#" onclick="return toggleContent(this)"> 445 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" 446 />Android Support Library, revision 6</a> <em>(December 2011)</em> 447 </p> 448 <div class="toggle-content-toggleme"> 449 450 <p class="note"><strong>Note:</strong> Reference for support library APIs are now available with 451 the framework references, for example: {@link android.support.v4.app}.</p> 452 <dl> 453 <dt>Changes for v4 support library:</dt> 454 <dd> 455 <ul> 456 <li>Changes to ViewPager: 457 <ul> 458 <li>Added extra decorative view support for {@link android.support.v4.view.ViewPager}. 459 Decorative views may be supplied as child views of a pager in XML layout.</li> 460 <li>Added {@link android.support.v4.view.PagerAdapter#getPageTitle 461 PagerAdapter.getPageTitle()} to supply title strings for pages, which defaults to no 462 title for each page.</li> 463 <li>Added {@link android.support.v4.view.PagerTitleStrip}, a non-interactive title 464 strip, that can be added as a child of ViewPager. Developers can supply text 465 appearance and color, as well as layout sizing and gravity information.</li> 466 <li>Updated {@link android.support.v4.view.PagerAdapter} methods to take ViewGroup 467 objects, rather than View to avoid class casting in adapter implementations.</li> 468 <li>Updated {@link android.support.v4.view.ViewPager} to use Launcher-style 469 fling behavior.</li> 470 <li>Bug fixes for user interface interaction and test automation.</li> 471 </ul> 472 </li> 473 474 <li>Support for Fragments: 475 <ul> 476 <li>Changed {@code setStartDeferred()} method to {@link 477 android.support.v4.app.Fragment#setUserVisibleHint}.</li> 478 <li>Added deferred start for off-screen pages to improve performance.</li> 479 </ul> 480 </li> 481 482 <li>Support for Accessiblity APIs: 483 <ul> 484 <li>Updated {@link android.support.v4.view.AccessibilityDelegateCompat} methods 485 to return empty lists instead of null.</li> 486 <li>Added new APIs needed by the v4 samples.</li> 487 </ul> 488 </li> 489 490 </ul> 491 </dd> 492 </dl> 493 </div> 494 </div> 495 496 <div class="toggle-content closed"> 497 <p><a href="#" onclick="return toggleContent(this)"> 498 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" 499 />Android Support Library, revision 5</a> <em>(December 2011)</em> 500 </p> 501 <div class="toggle-content-toggleme"> 502 <dl> 503 <dt>Changes for v4 support library:</dt> 504 <dd> 505 <ul> 506 <li>Support for Accessiblity APIs: 507 <ul> 508 <li>Added {@link android.support.v4.view.AccessibilityDelegateCompat} 509 to support {@link android.view.View.AccessibilityDelegate}.</li> 510 511 <li>Added {@link android.support.v4.view.accessibility.AccessibilityEventCompat} 512 to support {@link android.view.accessibility.AccessibilityEvent}.</li> 513 514 <li>Added {@link android.support.v4.view.accessibility.AccessibilityManagerCompat} 515 to support {@link android.view.accessibility.AccessibilityManager}.</li> 516 517 <li>Added {@link android.support.v4.view.accessibility.AccessibilityNodeInfoCompat} 518 to support {@link android.view.accessibility.AccessibilityNodeInfo}.</li> 519 520 <li>Added {@link android.support.v4.view.accessibility.AccessibilityRecordCompat} 521 to support {@link android.view.accessibility.AccessibilityRecord}.</li> 522 523 <li>Added {@link 524 android.support.v4.accessibilityservice.AccessibilityServiceInfoCompat} 525 to support {@link android.accessibilityservice.AccessibilityServiceInfo}.</li> 526 527 <li>Added {@link android.support.v4.view.ViewGroupCompat} 528 to support accessibility features in {@link android.view.ViewGroup}. 529 </li> 530 531 <li>Modified {@link android.support.v4.view.ViewCompat} 532 to support accessibility features in {@link android.view.View}.</li> 533 </ul> 534 </li> 535 536 <li>Changes to ViewPager: 537 <ul> 538 <li>Added support for margins between pages. 539 An optional {@link android.graphics.drawable.Drawable} can be provided 540 to fill the margins.</li> 541 <li>Added support for {@link android.widget.EdgeEffect}.</li> 542 <li>Added support for keyboard navigation</li> 543 <li>Added support to control how many pages are kept to either side 544 of the current page.</li> 545 <li>Improved touch physics.</li> 546 <li>Bug fixes for user interface behavior.</li> 547 </ul> 548 </li> 549 </ul> 550 </dd> 551 </dl> 552 </div> 553 </div> 554 555 <div class="toggle-content closed"> 556 <p><a href="#" onclick="return toggleContent(this)"> 557 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" 558 />Android Support Library, revision 4</a> <em>(October 2011)</em> 559 </p> 560 <div class="toggle-content-toggleme"> 561 <dl> 562 <dt>Changes for v4 support library:</dt> 563 <dd> 564 <ul> 565 <li>Added <code>EdgeEffectCompat</code> to 566 support {@link android.widget.EdgeEffect}.</li> 567 568 <li>Added <code>LocalBroadcastManager</code> to allow applications to easily 569 register for and receive intents within a single application without 570 broadcasting them globally.</li> 571 572 <li>Added support in <code>ViewCompat</code> to check for and set overscroll 573 modes for {@link android.view.View}s on Android 2.3 and later.</li> 574 <li>Changes to Fragment APIs: 575 <ul> 576 <li>Added new APIs to control the visibility of new menus.</li> 577 <li>Added custom animation APIs.</li> 578 <li>Added APIs in <code>FragmentActivity</code> to retain custom, 579 non-configuration instance data.</li> 580 <li>Various bug fixes.</li> 581 </ul> 582 </li> 583 584 <li>Fixed a {@link android.content.Loader} bug that caused issues in 585 canceling {@link android.os.AsyncTask}s when running on Froyo and older 586 versions of the platform. The support 587 code now uses its own version of {@link android.os.AsyncTask} to keep the same 588 behavior on all platform versions.</li> 589 590 </ul> 591 </dd> 592 </dl> 593 </div> 594 </div> 595 596 597 <div class="toggle-content closed"> 598 <p><a href="#" onclick="return toggleContent(this)"> 599 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" 600 />Android Support Library, revision 3</a> <em>(July 2011)</em> 601 </p> 602 <div class="toggle-content-toggleme"> 603 <dl> 604 <dt>Changes for v4 support library:</dt> 605 <dd> 606 <ul> 607 <li>Adds support for {@link android.app.Fragment.SavedState}</li> 608 <li>Adds {@code MotionEventCompat} to support newer {@link 609 android.view.MotionEvent} APIs</li> 610 <li>Adds {@code VelocityTrackerCompat} to support a newer {@link 611 android.view.VelocityTracker} APIs</li> 612 <li>Adds {@code ViewConfigurationCompat} to support a newer {@link 613 android.view.ViewConfiguration} APIs</li> 614 <li>All new APIs (available only in the support library) that allow you to create UIs 615 with horizontal paging, allowing users to swipe left and right between content views. Classes to 616 support this include: 617 <ul> 618 <li>{@code ViewPager}: A {@link android.view.ViewGroup} that manages the 619 layout for the child views, which the user can swipe between.</li> 620 <li>{@code PagerAdapter}: An adapter that populates the {@code ViewPager} with the 621 views that represent each page.</li> 622 <li>{@code FragmentPagerAdapter}: An extension of {@code PagerAdapter} for flipping 623 between fragments.</li> 624 <li>{@code FragmentStatePagerAdapter}: An extension of {@code PagerAdapter} for 625 flipping between fragments that uses the library's support for {@link 626 android.app.Fragment.SavedState}.</li> 627 </ul> 628 </li> 629 </ul> 630 </dd> 631 <dt>New v13 support library:</dt> 632 <dd> 633 <ul> 634 <li>Includes the {@code FragmentPagerAdapter} and {@code FragmentStatePagerAdapter} 635 to support the horizontal paging. 636 <p>These are exactly the same as the APIs added to the v4 support library, but rely on 637 other platform components in Android 3.2. Use this library instead of v4 if you're developing for 638 Android 3.2 and higher (all other APIs in the v4 library are already available with API level 639 13).</p> 640 </li> 641 </ul> 642 </dd> 643 </dl> 644 </div> 645 </div> 646 647 648 <div class="toggle-content closed"> 649 <p><a href="#" onclick="return toggleContent(this)"> 650 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" 651 />Android Support Library, revision 2</a> <em>(May 2011)</em> 652 </p> 653 <div class="toggle-content-toggleme"> 654 <dl> 655 <dt>Changes for v4 library:</dt> 656 <dd> 657 <ul> 658 <li>Support for fragment animations</li> 659 <li>Fix {@link android.support.v4.app.Fragment#onActivityResult Fragment.onActivityResult()} 660 bug</li> 661 </ul> 662 </dd> 663 </dl> 664 </div> 665 </div> 666 667 668 <div class="toggle-content closed"> 669 <p><a href="#" onclick="return toggleContent(this)"> 670 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" 671 />Android Support Library, revision 1</a> <em>(March 2011)</em> 672 </p> 673 <div class="toggle-content-toggleme"> 674 <p>Initial release with the v4 library.</p> 675 </div> 676 </div> 677 678
