Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit f80e7d9c authored by Scott Main's avatar Scott Main Committed by Android Git Automerger
Browse files

am 60d8b780: Merge change 27064 into donut 

Merge commit '60d8b780' into eclair

* commit '60d8b780':
  docs only.
parents a16ca5ec 60d8b780

docs/html/guide/appendix/api-levels.jd

+25 −3
Original line number Diff line number Diff line
@@ -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