Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge change 27064 into donut

Browse Source 
* changes:
  docs only. add information on provisional api level and fix some link titles
This commit is contained in:
Android (Google) Code Review
2009-09-25 20:51:31 -04:00
parent 1224267800 16a6e86d36
commit 60d8b78041
1 changed files with 25 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
docs/html/guide/appendix/api-levels.jd
View File

@@ -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