diff options
Diffstat (limited to 'docs/html/guide/topics/manifest/uses-sdk-element.jd')
| -rw-r--r-- | docs/html/guide/topics/manifest/uses-sdk-element.jd | 80 |
1 files changed, 40 insertions, 40 deletions
diff --git a/docs/html/guide/topics/manifest/uses-sdk-element.jd b/docs/html/guide/topics/manifest/uses-sdk-element.jd index f9e2785..3b3bb8f 100644 --- a/docs/html/guide/topics/manifest/uses-sdk-element.jd +++ b/docs/html/guide/topics/manifest/uses-sdk-element.jd @@ -26,14 +26,14 @@ parent.link=manifest-intro.html </div> </div> -<div class="sidebox-wrapper"> +<div class="sidebox-wrapper"> <div class="sidebox"> - <img src="{@docRoot}assets/images/icon_play.png" style="float:left;margin:0;padding:0;"> - <p style="color:#669999;padding-top:1em;">Google Play Filtering</p> + <img src="{@docRoot}assets/images/icon_play.png" style="float:left;margin:0;padding:0;"> + <p style="color:#669999;padding-top:1em;">Google Play Filtering</p> <p style="padding-top:1em;">Google Play uses the <code><uses-sdk></code> - attributes declared in your app manifest to filter your app from devices + attributes declared in your app manifest to filter your app from devices that do not meet it's platform version requirements. Before setting these - attributes, make sure that you understand + attributes, make sure that you understand <a href="{@docRoot}google/play/filters.html">Google Play filters</a>. </p> </div> </div> @@ -41,7 +41,7 @@ parent.link=manifest-intro.html <dl class="xml"> <dt>syntax:</dt> <dd><pre> -<uses-sdk android:<a href="#min">minSdkVersion</a>="<i>integer</i>" +<uses-sdk android:<a href="#min">minSdkVersion</a>="<i>integer</i>" android:<a href="#target">targetSdkVersion</a>="<i>integer</i>" android:<a href="#max">maxSdkVersion</a>="<i>integer</i>" /></pre></dd> @@ -55,14 +55,14 @@ API Level of a given Android system, which may vary among different Android devi </p> <p>Despite its name, this element is used to specify the API Level, <em>not</em> -the version number of the SDK (software development kit) or Android platform. +the version number of the SDK (software development kit) or Android platform. The API Level is always a single integer. You cannot derive the API Level from its associated Android version number (for example, it is not the same as the major version or the sum of the major and minor versions).</p> <p>Also read the document about <a href="{@docRoot}tools/publishing/versioning.html">Versioning Your Applications</a>. -</p></dd> +</p></dd> <dt>attributes:</dt> @@ -117,8 +117,8 @@ the corresponding platform version.</p> </dd> <dt><a name="max"></a>{@code android:maxSdkVersion}</dt> - <dd>An integer designating the maximum API Level on which the application is - designed to run. + <dd>An integer designating the maximum API Level on which the application is + designed to run. <p>In Android 1.5, 1.6, 2.0, and 2.0.1, the system checks the value of this attribute when installing an application and when re-validating the application @@ -165,7 +165,7 @@ installation or re-validation. Google Play will continue to use the attribute as a filter, however, when presenting users with applications available for download. </div> </dd> - + </dl></dd> @@ -217,7 +217,7 @@ modification.</p> <p>The framework API that an Android platform delivers is specified using an integer identifier called "API Level". Each Android platform version supports exactly one API Level, although support is implicit for all earlier API Levels -(down to API Level 1). The initial release of the Android platform provided +(down to API Level 1). The initial release of the Android platform provided API Level 1 and subsequent releases have incremented the API Level.</p> <p>The table below specifies the API Level supported by each version of the @@ -227,8 +227,8 @@ Versions dashboards page</a>.</p> <table> <tr><th>Platform Version</th><th>API Level</th><th>VERSION_CODE</th><th>Notes</th></tr> - - <tr><td><a href="{@docRoot}about/versions/android-4.2.html">Android 4.2</a></td> + + <tr><td><a href="{@docRoot}about/versions/android-4.2.html">Android 4.2, 4.2.2</a></td> <td><a href="{@docRoot}sdk/api_diff/17/changes.html" title="Diff Report">17</a></td> <td>{@link android.os.Build.VERSION_CODES#JELLY_BEAN_MR1}</td> <td><a href="{@docRoot}about/versions/jelly-bean.html">Platform @@ -250,70 +250,70 @@ Highlights</a></td></tr> <td><a href="{@docRoot}sdk/api_diff/14/changes.html" title="Diff Report">14</a></td> <td>{@link android.os.Build.VERSION_CODES#ICE_CREAM_SANDWICH}</td> </tr> - + <tr><td><a href="{@docRoot}about/versions/android-3.2.html">Android 3.2</a></td> <td><a href="{@docRoot}sdk/api_diff/13/changes.html" title="Diff Report">13</a></td> <td>{@link android.os.Build.VERSION_CODES#HONEYCOMB_MR2}</td> <td><!-- <a href="{@docRoot}about/versions/android-3.2-highlights.html">Platform Highlights</a>--></td></tr> - + <tr><td><a href="{@docRoot}about/versions/android-3.1.html">Android 3.1.x</a></td> <td><a href="{@docRoot}sdk/api_diff/12/changes.html" title="Diff Report">12</a></td> <td>{@link android.os.Build.VERSION_CODES#HONEYCOMB_MR1}</td> <td><a href="{@docRoot}about/versions/android-3.1-highlights.html">Platform Highlights</a></td></tr> - + <tr><td><a href="{@docRoot}about/versions/android-3.0.html">Android 3.0.x</td> <td><a href="{@docRoot}sdk/api_diff/11/changes.html" title="Diff Report">11</a></td> <td>{@link android.os.Build.VERSION_CODES#HONEYCOMB}</td> <td><a href="{@docRoot}about/versions/android-3.0-highlights.html">Platform Highlights</a></td></tr> - + <tr><td><a href="{@docRoot}about/versions/android-2.3.3.html">Android 2.3.4<br>Android 2.3.3</td> <td><a href="{@docRoot}sdk/api_diff/10/changes.html" title="Diff Report">10</a></td> <td>{@link android.os.Build.VERSION_CODES#GINGERBREAD_MR1}</td> <td rowspan="2"><a href="{@docRoot}about/versions/android-2.3-highlights.html">Platform Highlights</a></td></tr> - + <tr><td><a href="{@docRoot}about/versions/android-2.3.html">Android 2.3.2<br>Android 2.3.1<br>Android 2.3</td> <td><a href="{@docRoot}sdk/api_diff/9/changes.html" title="Diff Report">9</a></td> <td>{@link android.os.Build.VERSION_CODES#GINGERBREAD}</td> </tr> - + <tr><td><a href="{@docRoot}about/versions/android-2.2.html">Android 2.2.x</td> <td ><a href="{@docRoot}sdk/api_diff/8/changes.html" title="Diff Report">8</a></td> <td>{@link android.os.Build.VERSION_CODES#FROYO}</td> <td><a href="{@docRoot}about/versions/android-2.2-highlights.html">Platform Highlights</a></td></tr> - + <tr><td><a href="{@docRoot}about/versions/android-2.1.html">Android 2.1.x</td> <td><a href="{@docRoot}sdk/api_diff/7/changes.html" title="Diff Report">7</a></td> <td>{@link android.os.Build.VERSION_CODES#ECLAIR_MR1}</td> <td rowspan="3" ><a href="{@docRoot}about/versions/android-2.0-highlights.html">Platform Highlights</a></td></tr> - + <tr><td><a href="{@docRoot}about/versions/android-2.0.1.html">Android 2.0.1</td> <td><a href="{@docRoot}sdk/api_diff/6/changes.html" title="Diff Report">6</a></td> <td>{@link android.os.Build.VERSION_CODES#ECLAIR_0_1}</td> </tr> - + <tr><td><a href="{@docRoot}about/versions/android-2.0.html">Android 2.0</td> <td><a href="{@docRoot}sdk/api_diff/5/changes.html" title="Diff Report">5</a></td> <td>{@link android.os.Build.VERSION_CODES#ECLAIR}</td> </tr> - + <tr><td><a href="{@docRoot}about/versions/android-1.6.html">Android 1.6</td> <td><a href="{@docRoot}sdk/api_diff/4/changes.html" title="Diff Report">4</a></td> <td>{@link android.os.Build.VERSION_CODES#DONUT}</td> <td><a href="{@docRoot}about/versions/android-1.6-highlights.html">Platform Highlights</a></td></tr> - + <tr><td><a href="{@docRoot}about/versions/android-1.5.html">Android 1.5</td> <td><a href="{@docRoot}sdk/api_diff/3/changes.html" title="Diff Report">3</a></td> <td>{@link android.os.Build.VERSION_CODES#CUPCAKE}</td> <td><a href="{@docRoot}about/versions/android-1.5-highlights.html">Platform Highlights</a></td></tr> - + <tr><td><a href="{@docRoot}about/versions/android-1.1.html">Android 1.1</td> <td>2</td> <td>{@link android.os.Build.VERSION_CODES#BASE_1_1}</td><td></td></tr> - + <tr><td>Android 1.0</td> <td>1</td> <td>{@link android.os.Build.VERSION_CODES#BASE}</td> @@ -324,10 +324,10 @@ Highlights</a></td></tr> <h2 id="uses">Uses of API Level in Android</h2> <p>The API Level identifier serves a key role in ensuring the best possible -experience for users and application developers: +experience for users and application developers: <ul> -<li>It lets the Android platform describe the maximum framework API revision +<li>It lets the Android platform describe the maximum framework API revision that it supports</li> <li>It lets applications describe the framework API revision that they require</li> @@ -349,7 +349,7 @@ on which the application is able to run. The default value is "1".</li> <li><code>android:targetSdkVersion</code> — Specifies the API Level on which the application is designed to run. In some cases, this allows the application to use manifest elements or behaviors defined in the target -API Level, rather than being restricted to using only those defined +API Level, rather than being restricted to using only those defined for the minimum API Level.</li> <li><code>android:maxSdkVersion</code> — Specifies the maximum API Level on which the application is able to run. <strong>Important:</strong> Please read the <a @@ -375,7 +375,7 @@ installation to begin only if these conditions are met:</p> must be less than or equal to the system's API Level integer. If not declared, the system assumes that the application requires API Level 1. </li> <li>If a <code>android:maxSdkVersion</code> attribute is declared, its value -must be equal to or greater than the system's API Level integer. +must be equal to or greater than the system's API Level integer. If not declared, the system assumes that the application has no maximum API Level. Please read the <a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html"><code><uses-sdk></code></a> @@ -470,7 +470,7 @@ might not receive an update for a significant amount of time. </p> <p>When you are developing your application, you will need to choose the platform version against which you will compile the application. In general, you should compile your application against the lowest possible -version of the platform that your application can support. +version of the platform that your application can support. <p>You can determine the lowest possible platform version by compiling the application against successively lower build targets. After you determine the @@ -513,7 +513,7 @@ download other platform versions as necessary. </p> located in the <sdk>/tools directory. You can launch the SDK updater by executing <code>android sdk</code>. You can also simply double-click the android.bat (Windows) or android (OS X/Linux) file. -In ADT, you can also access the updater by selecting +In ADT, you can also access the updater by selecting <strong>Window</strong> > <strong>Android SDK Manager</strong>.</p> @@ -552,9 +552,9 @@ 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 -by API Level" control in the top-right area of each page. You can use the -control to show documentation only for parts of the API that are actually -accessible to your application, based on the API Level that it specifies in +by API Level" control in the top-right area of each page. You can use the +control to show documentation only for parts of the API that are actually +accessible to your application, based on the API Level that it specifies in the <code>android:minSdkVersion</code> attribute of its manifest file. </p> <p>To use filtering, select the checkbox to enable filtering, just below the @@ -574,10 +574,10 @@ disabled, so that you can view the full framework API, regardless of API Level. </p> <p>Also note that the reference documentation for individual API elements -specifies the API Level at which each element was introduced. The API Level -for packages and classes is specified as "Since <api level>" at the -top-right corner of the content area on each documentation page. The API Level -for class members is specified in their detailed description headers, +specifies the API Level at which each element was introduced. The API Level +for packages and classes is specified as "Since <api level>" at the +top-right corner of the content area on each documentation page. The API Level +for class members is specified in their detailed description headers, at the right margin. </p> |