diff options
| author | Dirk Dougherty <ddougherty@google.com> | 2009-10-16 15:25:15 -0700 |
|---|---|---|
| committer | Dirk Dougherty <ddougherty@google.com> | 2009-10-22 00:59:47 -0700 |
| commit | ee58d1bf9c54eaed623c4419e1d9db269a9c4137 (patch) | |
| tree | 76dd7cec7266833966dfdd9d305790a0f6f224c2 /docs/html/guide/appendix | |
| parent | 6797b9fa06b4c86b92da117a7f84277f7a380820 (diff) | |
| download | frameworks_base-ee58d1bf9c54eaed623c4419e1d9db269a9c4137.zip frameworks_base-ee58d1bf9c54eaed623c4419e1d9db269a9c4137.tar.gz frameworks_base-ee58d1bf9c54eaed623c4419e1d9db269a9c4137.tar.bz2 | |
doc change: Add docs for SDK. Support new modular structure. In Android.mk, change @since level identifier to 5.xml, expose adt downloadable vars. Fix links that pointed to @sdkCurrent.
Change-Id:I368345755dd753b1056fb06ff25e4b32f3020e4d
Bug:2160782
Diffstat (limited to 'docs/html/guide/appendix')
| -rw-r--r-- | docs/html/guide/appendix/api-levels.jd | 44 |
1 files changed, 26 insertions, 18 deletions
diff --git a/docs/html/guide/appendix/api-levels.jd b/docs/html/guide/appendix/api-levels.jd index 3158192..3f3b6c6 100644 --- a/docs/html/guide/appendix/api-levels.jd +++ b/docs/html/guide/appendix/api-levels.jd @@ -83,6 +83,7 @@ Android platform.</p> <table> <tr><th>Platform Version</th><th>API Level</th></tr> + <tr><td>Android 2.0</td><td>5</td></tr> <tr><td>Android 1.6</td><td>4</td></tr> <tr><td>Android 1.5</td><td>3</td></tr> <tr><td>Android 1.1</td><td>2</td></tr> @@ -115,6 +116,10 @@ they are designed to support. The element offers two key attributes:</p> <ul> <li><code>android:minSdkVersion</code> — Specifies the minimum API Level 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 those in the minimum API Level.</li> <li><code>android:maxSdkVersion</code> — Specifies the maximum API Level on which the application is able to run.</li> </ul> @@ -146,7 +151,7 @@ element might look like this: </p> <pre><manifest> ... - <uses-sdk android:minSdkVersion="4" /> + <uses-sdk android:minSdkVersion="5" /> ... </manifest></pre> @@ -288,23 +293,26 @@ 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> +<p>In some cases, an "Early Look" Android SDK platform may be available. To let +you begin developing on the platform although the APIs may not be final, the +platform's API Level integer will not be specified. You must instead use the +platform's <em>provisional API Level</em> in your application manifest, in order +to build applications against the platform. A provisional API Level is not an +integer, but a string matching the codename of the unreleased platform version. +The provisional API Level will be specified in the release notes for 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 +and can only be used to run applications in the emulator. An application using +the provisional API Level can never be installed on an Android device. At the +final release of the platform, you must replace any instances of the provisional +API Level in your application manifest with the final platform's actual API +Level integer.</p> <h2 id="filtering">Filtering the Reference Documentation by API Level</h2> |