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

Commit 60d8b780 authored by Android (Google) Code Review's avatar Android (Google) Code Review
Browse files

Merge change 27064 into donut 

* changes:
  docs only. add information on provisional api level and fix some link titles
parents 12242678 16a6e86d

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