diff options
Diffstat (limited to 'docs/html/guide/appendix/api-levels.jd')
-rw-r--r-- | docs/html/guide/appendix/api-levels.jd | 28 |
1 files changed, 25 insertions, 3 deletions
diff --git a/docs/html/guide/appendix/api-levels.jd b/docs/html/guide/appendix/api-levels.jd index acf6899..3158192 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 <h2>In this document</h2> <ol> <li><a href="intro">What is API Level?</a></li> - <li><a href="#uses">Uses of API Level</a></li> + <li><a href="#uses">Uses of API Level in Android</a></li> <li><a href="#considerations">Development Considerations</a> <ol> <li><a href="#fc">Application forward compatibility</a></li> <li><a href="#bc">Application backward compatibility</a></li> - <li><a href="#platform">Selecting a platform version for compiling</a></li> + <li><a href="#platform">Selecting a platform version and API Level</a></li> <li><a href="#apilevel">Declaring a minimum API Level</a></li> <li><a href="#testing">Testing against higher API Levels</a></li> </ol> </li> - <li><a href="#filtering">Filtering the documentation</a></li> + <li><a href="#provisional">Using a Provisional API Level</a></li> + <li><a href="#filtering">Filtering the Reference Documentation by API Level</a></li> </ol> <h2>See also</h2> @@ -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. </p> +<h2 id="provisional">Using a Provisional API Level</h2> + +<p>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.</p> + +<p>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.</p> + +<p>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.</p> + + <h2 id="filtering">Filtering the Reference Documentation by API Level</h2> <p>Reference documentation pages on the Android Developers site offer a "Filter |