From 71d5c1db17b057ae5022bf6f0bec5bcb67f00bf4 Mon Sep 17 00:00:00 2001 From: Joe Fernandez Date: Thu, 15 Dec 2011 22:33:41 -0800 Subject: docs: Release Notes v2 for Android 4.0.3, ADT 16.0.1, Support lib r5-r6 Change-Id: I628cd076cd37f6252837de276c4b7a9040c37bc1 --- docs/html/sdk/compatibility-library.jd | 130 ++++++++++++++++++--------------- docs/html/sdk/tools-notes.jd | 4 +- 2 files changed, 72 insertions(+), 62 deletions(-) diff --git a/docs/html/sdk/compatibility-library.jd b/docs/html/sdk/compatibility-library.jd index 0ef5770828df..df715520daa8 100644 --- a/docs/html/sdk/compatibility-library.jd +++ b/docs/html/sdk/compatibility-library.jd @@ -4,7 +4,7 @@ page.title=Support Package
- +

In this document

  1. Revisions
    2. @@ -35,7 +35,8 @@ worry less about platform versions.

    Note: The Support Package includes more than one support library. Each one has a different minimum API level. For example, one library requires API -level 4 or higher, while another requires API level 13 or higher (v13 is a superset of v4 and includes additional +level 4 or higher, while another requires API level 13 or higher (v13 is a superset of v4 and +includes additional support classes to work with v13 APIs). The minimum version is indicated by the directory name, such as {@code v4/} and {@code v13/}.

    @@ -54,7 +55,9 @@ the Support Package, as denoted by revision number.

    -
    +

    Note: Reference for support library APIs are now available with + the framework references, for example: {@link android.support.v4.app}.

    +
    Changes for v4 support library:
      @@ -68,22 +71,22 @@ the Support Package, as denoted by revision number.

    • Added {@link android.support.v4.view.PagerTitleStrip}, a non-interactive title strip, that can be added as a child of ViewPager. Developers can supply text appearance and color, as well as layout sizing and gravity information.
      • -
    • Updated PagerAdapter methods to take ViewGroup objects, rather than View to avoid - class casting in adapter implementations. For more information, see - {@link android.support.v4.view.PagerAdapter}.
      • -
    • Updated ViewPager to use Launcher Workspace-style fling behavior.
      • +
    • Updated {@link android.support.v4.view.PagerAdapter} methods to take ViewGroup + objects, rather than View to avoid class casting in adapter implementations.
      • +
    • Updated {@link android.support.v4.view.ViewPager} to use Launcher-style + fling behavior.
    • Bug fixes for user interface interaction and test automation.
    - +
  2. Support for Fragments:
    • Changed {@code setStartDeferred()} method to {@link android.support.v4.app.Fragment#setUserVisibleHint}.
    • Added deferred start for off-screen pages to improve performance.
      • -
    +
    3. - +
  3. Support for Accessiblity APIs:
    • Updated {@link android.support.v4.view.AccessibilityDelegateCompat} methods @@ -91,7 +94,7 @@ the Support Package, as denoted by revision number.

    • Added new APIs needed by the v4 samples.
    4. - +
    @@ -111,34 +114,35 @@ the Support Package, as denoted by revision number.

    • Support for Accessiblity APIs:
        -
      • Added AccessibilityDelegateCompat to support - {@link android.view.View.AccessibilityDelegate}.
        • +
      • Added {@link android.support.v4.view.AccessibilityDelegateCompat} + to support {@link android.view.View.AccessibilityDelegate}.
        • -
      • Added AccessibilityEventCompat to support - {@link android.view.accessibility.AccessibilityEvent}.
        • +
      • Added {@link android.support.v4.view.accessibility.AccessibilityEventCompat} + to support {@link android.view.accessibility.AccessibilityEvent}.
        • -
      • Added AccessibilityManagerCompat to support - {@link android.view.accessibility.AccessibilityManager}.
        • +
      • Added {@link android.support.v4.view.accessibility.AccessibilityManagerCompat} + to support {@link android.view.accessibility.AccessibilityManager}.
        • -
      • Added AccessibilityNodeInfoCompat to support - {@link android.view.accessibility.AccessibilityNodeInfo}.
        • +
      • Added {@link android.support.v4.view.accessibility.AccessibilityNodeInfoCompat} + to support {@link android.view.accessibility.AccessibilityNodeInfo}.
        • -
      • Added AccessibilityRecordCompat to support - {@link android.view.accessibility.AccessibilityRecord}.
        • +
      • Added {@link android.support.v4.view.accessibility.AccessibilityRecordCompat} + to support {@link android.view.accessibility.AccessibilityRecord}.
        • -
      • Added AccessibilityServiceInfoCompat to support - {@link android.accessibilityservice.AccessibilityServiceInfo}.
        • +
      • Added {@link + android.support.v4.accessibilityservice.AccessibilityServiceInfoCompat} + to support {@link android.accessibilityservice.AccessibilityServiceInfo}.
        • -
      • Added ViewGroupCompat +
      • Added {@link android.support.v4.view.ViewGroupCompat} to support accessibility features in {@link android.view.ViewGroup}.
        • -
      • Modified ViewCompat +
      • Modified {@link android.support.v4.view.ViewCompat} to support accessibility features in {@link android.view.View}.
      • -
    • Changes to ViewPager: +
    • Changes to ViewPager:
      • Added support for margins between pages. An optional {@link android.graphics.drawable.Drawable} can be provided @@ -170,7 +174,7 @@ the Support Package, as denoted by revision number.

        • Added EdgeEffectCompat to support {@link android.widget.EdgeEffect}.
          • - +
        • Added LocalBroadcastManager to allow applications to easily register for and receive intents within a single application without broadcasting them globally.
          • @@ -186,7 +190,7 @@ the Support Package, as denoted by revision number.

        • Various bug fixes.
        • - +
      • Fixed a {@link android.content.Loader} bug that caused issues in canceling {@link android.os.AsyncTask}s when running on Froyo and older versions of the platform. The support @@ -210,7 +214,7 @@ the Support Package, as denoted by revision number.

        Compatibility Package, revision 3 (July 2011)

        -
        +
        Changes for v4 support library:
        @@ -264,7 +268,7 @@ Android 3.2 and higher (all other APIs in the v4 library are already available w Compatibility Package, revision 2 (May 2011)

        -
        +
        Changes for v4 library:
        @@ -287,7 +291,7 @@ Android 3.2 and higher (all other APIs in the v4 library are already available w Compatibility Package, revision 1 (March 2011)

        -
        +

        Initial release with the v4 library.

        @@ -301,7 +305,7 @@ Android 3.2 and higher (all other APIs in the v4 library are already available w Manager. To install:

          -
        1. Launch the SDK and AVD Manager. +
        2. Launch the SDK and AVD Manager.

          From Eclipse, you can select Window > Android SDK and AVD Manager. Or, launch {@code SDK Manager.exe} from the {@code <sdk>/} directory (on Windows only) or {@code android} from the {@code @@ -328,7 +332,7 @@ libs/} directory.

          For example, the library that supports API level 4 and up is located at {@code <sdk>/extras/android/support/v4/android-support-v4.jar}.

          3. -
        3. Add the JAR to your project build path. +
        4. Add the JAR to your project build path.

          In Eclipse, right-click the JAR file in the Package Explorer, select Build Path > Add to Build Path.

          5. @@ -339,7 +343,7 @@ provided APIs are available in the {@code android.support} package (for example, {@code android.support.v4}).

          Tip: To see the library APIs in action, take a look at the sample -apps in {@code extras/android/support/<version>/samples/}.

          +apps in {@code <sdk>/extras/android/support/<version>/samples/}.

          Warning: Be certain that you not confuse the standard {@code android} packages with those in {@code android.support} library. Some code completion tools @@ -377,17 +381,20 @@ differences, however. Most notably:

          • When creating an activity to use fragments, you must declare your activity to extend the -{@code FragmentActivity} class (instead of the traditional {@link android.app.Activity} -class).
            • -
          • To manage your fragments and loaders, you must use the methods {@code -FragmentActivity.getSupportFragmentManager()} and {@code -FragmentActivity.getSupportLoaderManager()} (instead of the {@link -android.app.Activity#getFragmentManager()} and {@link android.app.Activity#getLoaderManager()} -methods).
            • +{@link android.support.v4.app.FragmentActivity} class (instead of the traditional +{@link android.app.Activity} class). +
          • To manage your fragments and loaders, you must use the methods + {@link android.support.v4.app.FragmentActivity#getSupportFragmentManager + FragmentActivity.getSupportFragmentManager()} and + {@link android.support.v4.app.FragmentActivity#getSupportLoaderManager + FragmentActivity.getSupportLoaderManager()} (instead of the + {@link android.app.Activity#getFragmentManager()} and + {@link android.app.Activity#getLoaderManager()} methods).
          • The {@link android.app.ActionBar} is not supported by the library. However, when creating your Options Menu, you can declare which items should be added to the Action Bar when it's available (on -Android 3.0 or later). You can do so with the {@code MenuCompat.setShowAsAction()} method. For +Android 3.0 or later). You can do so with the +{@link android.support.v4.view.MenuCompat#setShowAsAction MenuCompat.setShowAsAction()} method, for example: 
             public boolean onCreateOptionsMenu(Menu menu) {
@@ -397,16 +404,19 @@ public boolean onCreateOptionsMenu(Menu menu) {
     return true;
 }
            +

            Also see the Action Bar +Compatibility sample for a demonstration of how to use {@link android.app.ActionBar} on Android +3.0+ and also support action bar functionality on older versions.

          Tip: To enable the Holographic theme on devices running Android 3.0 or higher, declare in your manifest file that your application targets -API level 11. For example:

          +API level 11, for example:

           <uses-sdk android:minSdkVersion="4" android:targetSdkVersion="11" />
          -

          This way, your application automatically receives the Holographic theme and the Action Bar for +

          This way, your application automatically receives the Holographic theme and the Action Bar for each activity when running on Android 3.0 and higher.

          @@ -417,29 +427,29 @@ Apps for Android 3.0.

          Reference Docs

          -

          The libraries currently do not provide reference documentation for the included APIs. To generate -your own set using the {@code javadoc} tool, perform the following from a command (as appropriate -for the library version you're using). In this example, documentation is generated for the v4 -library:

          +

          The reference documentation for the Support Packages is included as part of the Android +online developer documentation:

          -
          -cd <sdk>/extras/android/support/v4/
-mkdir docs
-javadoc -sourcepath src/java/ -subpackages android.support.v4 -d docs
-
          -

          Open the {@code docs/index.html} file to begin browsing the generated documentation.

          +

          Samples

          If you want to see some code that uses the support libraries, samples are included with the -Support Package, inside each support library directory. For example, at {@code -extras/android/support/v4/samples/}.

          +Support Package, inside each support library directory, for example; {@code +<sdk>/extras/android/support/v4/samples/}. You can also view these samples as part of the +Android online developer documentation:

          + +

          Additionally, the Google I/O App is a complete application that uses the v4 support library to provide a single APK for both handsets and tablets and also demonstrates some of Android's best practices in Android UI design.

          - - - - diff --git a/docs/html/sdk/tools-notes.jd b/docs/html/sdk/tools-notes.jd index b1f4d0739841..91bcb7d2c33e 100644 --- a/docs/html/sdk/tools-notes.jd +++ b/docs/html/sdk/tools-notes.jd @@ -94,7 +94,7 @@ padding: .25em 1em;