diff --git a/docs/html/sdk/compatibility-library.jd b/docs/html/sdk/compatibility-library.jd index c8cd5b24b07f8..8b19fb47aa126 100644 --- a/docs/html/sdk/compatibility-library.jd +++ b/docs/html/sdk/compatibility-library.jd @@ -1,4 +1,4 @@ -page.title=Compatibility Package +page.title=Support Package @jd:body @@ -8,7 +8,7 @@ page.title=Compatibility Package

In this document

  1. Revisions
    2. -
  2. Downloading the Compatibility Package
    3. +
  3. Downloading the Support Package
  4. Setting Up a Project to Use a Library
  5. Using the v4 Library APIs
  6. Reference Docs
    7. @@ -27,28 +27,118 @@ href="{@docRoot}guide/practices/optimizing-for-3.0.html">Optimizing Apps for And

    Minimum API level supported: 4

    -

    The Compatibility Package includes static "support libraries" that you can add to your Android +

    The Support Package includes static "support libraries" that you can add to your Android application in order to use APIs that are either not available for older platform versions or that offer "utility" APIs that aren't a part of the framework APIs. The goal is to simplify your development by offering more APIs that you can bundle with your application so you can worry less about platform versions.

    -

    Note: The Compatibility Package includes more than one support +

    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. The minimum version is indicated +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/}.

    Revisions

    The sections below provide notes about successive releases of -the Compatibility Package, as denoted by revision number.

    +the Support Package, as denoted by revision number.

    +

    + Support Package, revision 4 (October 2011) +

    + +
    +
    +
    Changes for v4 support library:
    +
    +
      +
    • Support for Accessiblity APIs: +
        +
      • Added AccessibilityDelegateCompat to support + {@link android.view.View.AccessibilityDelegate}.
        • + +
      • Added AccessibilityEventCompat to support + {@link android.view.accessibility.AccessibilityEvent}.
        • + +
      • Added AccessibilityManagerCompat to support + {@link android.view.accessibility.AccessibilityManager}.
        • + +
      • Added AccessibilityNodeInfoCompat to support + {@link android.view.accessibility.AccessibilityNodeInfo}.
        • + +
      • Added AccessibilityRecordCompat to support + {@link android.view.accessibility.AccessibilityRecord}.
        • + +
      • Added AccessibilityServiceInfoCompat to support + {@link android.accessibilityservice.AccessibilityServiceInfo}.
        • + +
      • Added ViewGroupCompat + to support accessibility features in {@link android.view.ViewGroup}. +
        • + +
      • Modified ViewCompat + to support accessibility features in {@link android.view.View}.
        • +
      +
      • + +
    • 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.
      • + +
    • Added support in ViewCompat to check for and set overscroll + modes for {@link android.view.View}s on Android 2.3 and later.
      • +
    • Changes to Fragment APIs: +
        +
      • Added new APIs to control the visibility of new menus.
        • +
      • Added custom animation APIs.
        • +
      • Added APIs in FragmentActivity to retain custom, + non-configuration instance data.
        • +
      • Various bug fixes.
        • +
      +
      • +
    • Changes to ViewPager: +
        +
      • Added support for margins between pages. + An optional {@link android.graphics.drawable.Drawable} can be provided + to fill the margins.
        • +
      • Added support for {@link android.widget.EdgeEffect}.
        • +
      • Added support for keyboard navigation
        • +
      • Added support to control how many pages are kept to either side + of the current page.
        • +
      • Improved touch physics.
        • +
      +
      • + +
    • 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 + code now uses its own version of {@link android.os.AsyncTask} to keep the same + behavior on all platform versions.
      • + +
    +
    +
    +
    + + + +
    + + +
    + +

    + Compatibility Package, revision 3 (July 2011)

    @@ -136,9 +226,9 @@ Android 3.2 and higher (all other APIs in the v4 library are already available w -

    Downloading the Compatibility Package

    +

    Downloading the Support Package

    -

    The Compatibility Package is provided as a downloadable package from the Android SDK and AVD +

    The Support Package is provided as a downloadable package from the Android SDK and AVD Manager. To install:

      @@ -147,13 +237,13 @@ Manager. To install:

      > 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 <sdk>/tools/} directory.

      -
    1. Expand the Android Repository, check Android Compatibility package +
    2. Expand the Android Repository, check Android Support package and click Install selected.
    3. Proceed to install the package.

    When done, all files (including source code, samples, and the {@code .jar} files) are saved -into the <sdk>/extras/android/compatibility/ directory. This directory contains +into the <sdk>/extras/android/support/ directory. This directory contains each of the different support libraries, such as the library for API level 4 and up and the library for API level 13 and up, each named with the respective version (such as {@code v4/}).

    @@ -167,7 +257,7 @@ project (next to {@code src/}, {@code res/}, etc.)
  7. Locate the JAR file for the library you want to use and copy it into the {@code libs/} directory.

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

    +<sdk>/extras/android/support/v4/android-support-v4.jar}.

  8. Add the JAR to your project build path.

    In Eclipse, right-click the JAR file in the Package Explorer, select Build @@ -181,7 +271,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/compatibility/<version>/samples/}.

    +apps in {@code 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 @@ -265,7 +355,7 @@ for the library version you're using). In this example, documentation is generat library:

    -cd <sdk>/extras/android/compatibility/v4/
+cd <sdk>/extras/android/support/v4/
 mkdir docs
 javadoc -sourcepath src/java/ -subpackages android.support.v4 -d docs
    @@ -275,8 +365,8 @@ javadoc -sourcepath src/java/ -subpackages android.support.v4 -d docs

    Samples

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

    +Support Package, inside each support library directory. For example, at {@code +extras/android/support/v4/samples/}.

    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 diff --git a/docs/html/sdk/sdk_toc.cs b/docs/html/sdk/sdk_toc.cs index 9bc9b9a33bb60..269457d5416eb 100644 --- a/docs/html/sdk/sdk_toc.cs +++ b/docs/html/sdk/sdk_toc.cs @@ -150,11 +150,11 @@ class="new">new!