diff --git a/docs/html/guide/appendix/api-levels.jd b/docs/html/guide/appendix/api-levels.jd index acf68997d70d7..31581924c7443 100644 --- a/docs/html/guide/appendix/api-levels.jd +++ b/docs/html/guide/appendix/api-levels.jd @@ -7,17 +7,18 @@ page.title=Android API Levels

In this document

  1. What is API Level?
  2. -
  3. Uses of API Level
  4. +
  5. Uses of API Level in Android
  6. Development Considerations
    1. Application forward compatibility
    2. Application backward compatibility
    3. -
    4. Selecting a platform version for compiling
    5. +
    6. Selecting a platform version and API Level
    7. Declaring a minimum API Level
    8. Testing against higher API Levels
  7. -
  8. Filtering the documentation
  9. +
  10. Using a Provisional API Level
  11. +
  12. Filtering the Reference Documentation by API Level

See also

@@ -285,6 +286,27 @@ of the Android platform it runs. See the table at the top of this document for a list of platform versions and their API Levels.

+

Using a Provisional API Level

+ +

During an "Early Look" SDK release, the APIs may not be final, so the API Level integer +will not be specified. You must instead use a provisional API Level in your application +manifest in order to build applications against the Early Look platform. In this case, +the provisional API Level is not an integer, but a string matching the codename of the +unreleased platform version (for example, "Eclair"). The provisional API Level will be specified +in the Early Look SDK release notes and is case-sensitive.

+ +

The use of a provisional API Level is designed to protect developers +and device users from inadvertently publishing or installing applications based on the +Early Look framework API, which may not run properly on actual devices running the final +system image.

+ +

The provisional API Level will only be valid while using the Early Look SDK to run +applications in the emulator. An application using the provisional API Level can never be +installed on an Android device. When the final SDK is released, you must replace any +instances of the provisional API Level in your application manifest with the final +API Level integer.

+ +

Filtering the Reference Documentation by API Level

Reference documentation pages on the Android Developers site offer a "Filter