1page.title=Android 1.5, Release 3 2sdk.platform.version=1.5 3sdk.platform.apiLevel=3 4sdk.platform.majorMinor=major 5sdk.platform.releaseDate=April 2009 6sdk.platform.deployableDate=May 2009 7 8@jd:body 9 10<div id="qv-wrapper"> 11<div id="qv"> 12 13 <h2>In this document</h2> 14 <ol> 15 <li><a href="#features">Platform Highlights</a></li> 16 <li><a href="#apps">Built-in Applications</a></li> 17 <li><a href="#locs">Locales</a></li> 18 <li><a href="#skins">Emulator Skins</a></li> 19 <li><a href="#api">Framework API</a> 20 <ol> 21 <li><a href="#api-level">API level</a></li> 22 <li><a href="#api-changes">API changes summary</a></li> 23 <li><a href="{@docRoot}sdk/api_diff/{@sdkPlatformApiLevel}/changes.html">API differences report »</a> </li> 24 </ol></li> 25 </ol> 26 27 <h2>See Also</h2> 28 <ol> 29 <li><a href="{@docRoot}sdk/adding-components.html">Adding SDK Components</a></li> 30 </ol> 31 32</div> 33</div> 34 35<p> 36<em>Date:</em> {@sdkPlatformReleaseDate}<br /> 37<em>API Level:</em> <strong>{@sdkPlatformApiLevel}</strong></p> 38 39<p>Android {@sdkPlatformVersion} is a {@sdkPlatformMajorMinor} platform release 40deployable to Android-powered handsets starting in {@sdkPlatformDeployableDate}. 41The release includes new features for users and developers, as well as changes 42in the Android framework API. </p> 43 44<p>For developers, the Android {@sdkPlatformVersion} platform is available as a 45downloadable component for the Android SDK. The downloadable platform includes a 46fully compliant Android library and system image, as well as a set of emulator 47skins, sample applications, and more. The downloadable platform is fully 48compliant and includes no external libraries. </p> 49 50<p>To get started developing or testing against the Android 51{@sdkPlatformVersion} platform, use the Android SDK and AVD Manager tool to 52download the platform into your Android 1.6 or later SDK. For more information, 53see <a href="{@docRoot}sdk/adding-components.html">Adding SDK 54Components</a>.</p> 55 56 57<h2 id="features">Platform Highlights</h2> 58 59<p>For a list of new user features and platform highlights, see the <a 60href="http://developer.android.com/sdk/android-{@sdkPlatformVersion}-highlights.html">Android 61{@sdkPlatformVersion} Platform Highlights</a> document.</p> 62 63 64<h2 id="apps">Built-in Applications</h2> 65 66<p>The system image included in the downloadable platform provides these 67built-in applications:</p> 68 69<table style="border:0;padding-bottom:0;margin-bottom:0;"> 70<tr> 71<td style="border:0;padding-bottom:0;margin-bottom:0;"> 72 <ul> 73 <li>Alarm Clock</li> 74 <li>Browser</li> 75 <li>Calculator</li> 76 <li>Camcorder</li> 77 <li>Camera</li> 78 <li>Contacts</li> 79 <li>Custom Locale (developer app)</li> 80 <li>Dev Tools (developer app)</li> 81 </ul> 82</td> 83<td style="border:0;padding-bottom:0;margin-bottom:0;padding-left:5em;"> 84 <ul> 85 <li>Dialer</li> 86 <li>Email</li> 87 <li>Gallery</li> 88 <li>IME for Japanese text input</li> 89 <li>Messaging</li> 90 <li>Music</li> 91 <li>Settings</li> 92 <li>Spare Parts (developer app)</li> 93 </ul> 94</td> 95</tr> 96</table> 97 98<h2 id="locs" style="margin-top:.75em;">Locales</h2> 99 100<p>The system image included in the downloadable platform provides a variety of 101built-in locales. In some cases, region-specific strings are available for the 102locales. In other cases, a default version of the language is used. The 103languages that are available in the Android {@sdkPlatformVersion} system 104image are listed below (with <em>language</em>_<em>country/region</em> 105locale descriptor).</p> 106 107<table style="border:0;padding-bottom:0;margin-bottom:0;"> 108<tr> 109<td style="border:0;padding-bottom:0;margin-bottom:0;"> 110<ul> 111<li>Chinese, PRC (zh_CN)</li> 112<li>Chinese, Taiwan (zh_TW)</li> 113<li>Czech (cs_CZ)</li> 114<li>Dutch, Netherlands (nl_NL)</li> 115<li>Dutch, Belgium (nl_BE)</li> 116<li>English, US (en_US)</li> 117<li>English, Britain (en_GB)</li> 118<li>English, Canada (en_CA)</li> 119<li>English, Australia (en_AU)</li> 120<li>English, New Zealand (en_NZ)</li> 121<li>English, Singapore(en_SG)</li> 122<li>French, France (fr_FR)</li> 123<li>French, Belgium (fr_BE)</li> 124</ul> 125</td> 126<td style="border:0;padding-bottom:0;margin-bottom:0;padding-left:5em;"> 127<li>French, Canada (fr_CA)</li> 128<li>French, Switzerland (fr_CH)</li> 129<li>German, Germany (de_DE)</li> 130<li>German, Austria (de_AT)</li> 131<li>German, Switzerland (de_CH)</li> 132<li>German, Liechtenstein (de_LI)</li> 133<li>Italian, Italy (it_IT)</li> 134<li>Italian, Switzerland (it_CH)</li> 135<li>Japanese (ja_JP)</li> 136<li>Korean (ko_KR)</li> 137<li>Polish (pl_PL)</li> 138<li>Russian (ru_RU)</li> 139<li>Spanish (es_ES)</li> 140</td> 141</tr> 142</table> 143 144<p>Localized UI strings match the locales that are accessible 145through Settings.</p> 146 147<h2 id="skins">Emulator Skins</h2> 148 149<p>The downloadable platform includes a set of emulator skins that you can use for modeling your application in different screen sizes and resolutions. The emulator skins are: </p> 150 151<ul> 152 <li> 153 QVGA-P (240x320, low density, small screen) 154 </li> 155 <li> 156 QVGA-L (320x480, low density, small screen) 157 </li> 158 <li> 159 HVGA (320x480, medium density, normal screen) 160 </li> 161 <li> 162 HVGA-P (320x480, medium density, normal screen) 163 </li> 164 <li> 165 HVGA-L (320x480, medium density, normal screen) 166 </li> 167</ul> 168 169<p>For more information about how to develop an application that displays and functions properly on all Android-powered devices, see <a href="{@docRoot}guide/practices/screens_support.html">Supporting Multiple Screens</a>.</p> 170 171 172<h2 id="api">Framework API</h2> 173 174<p>The sections below provide information about the application framework API provided by the Android {@sdkPlatformVersion} platform. </p> 175 176 177<h3 id="api-level">API level</h3> 178 179<p>The Android {@sdkPlatformVersion} platform delivers an updated version of the framework 180API. As with previous versions, the Android {@sdkPlatformVersion} API 181is assigned an integer identifier — <strong>{@sdkPlatformApiLevel}</strong> — that is 182stored in the system itself. This identifier, called the "API Level", allows the 183system to correctly determine whether an application is compatible with 184the system, prior to installing the application. </p> 185 186<p>To use APIs introduced in Android {@sdkPlatformVersion} in your application, you need to 187set the proper value, "{@sdkPlatformApiLevel}", in the attributes of the <code><uses-sdk></code> 188element in your application's manifest. </p> 189 190<p>For more information about how to use API Level, see the <a 191href="{@docRoot}guide/appendix/api-levels.html">API Levels</a> document. </p> 192 193<h3 id="api-changes">API changes summary</h3> 194 195<h4>UI framework</h4> 196 <ul> 197 <li>Framework for easier background/UI thread interaction</li> 198 <li>New {@link android.widget.SlidingDrawer SlidingDrawer} widget</li> 199 <li>New {@link android.widget.HorizontalScrollView HorizontalScrollview} widget</li> 200 </ul> 201 202<h4>AppWidget framework</h4> 203 <ul> 204 <li>APIs for creating secure home screen {@link android.appwidget 205AppWidgets}. For information about how to use AppWidgets, see the Developer's 206Guide <a href="{@docRoot}guide/topics/appwidgets/index.html">AppWidgets</a> 207documentation. Also see <a 208href="http://android-developers.blogspot.com/2009/04/introducing-home-screen-widgets-and.html"> 209Introducing home screen widgets and the AppWidget 210framework</a> on the Android Developer's Blog.</li> 211 <li>APIs for populating {@link android.provider.LiveFolders Live Folders} 212 with custom content.</li> 213 </ul> 214 215<h4>Media framework</h4> 216 <ul> 217 <li>Raw audio recording and playback APIs</li> 218 <li>Interactive MIDI playback engine</li> 219 <li>Video recording APIs for developers (3GP format)</li> 220 <li>Video and photo sharing Intents</li> 221 <li>Media search Intent</li> 222 </ul> 223 224<h4>Input Method framework </h4> 225 <ul> 226 <li>{@link android.inputmethodservice.InputMethodService Input Method 227 Service} framework</li> 228 <li>Text-prediction engine</li> 229 <li>Ability to provide downloadable IMEs to users</li> 230 </ul> 231 232<h4>Application-defined hardware requirements</h4> 233 <p>Applications can now use a new element in their manifest files, <a 234href="{@docRoot}guide/topics/manifest/uses-configuration-element.html"><code><uses-configuration></code></a> 235 to indicate to the Android system what hardware features 236they require in order to function properly. For example, an application might 237use the element to specify that it requires a physical keyboard or a particular 238navigation device, such as a trackball. Prior to installing the application, the 239Android system checks the attributes defined for the 240<code><uses-configuration></code> element and allows the installation to 241continue only if the required hardware is present.</p> 242 243<h4>Speech recognition framework</h4> 244 <ul> 245 <li>Support for using speech recognition libraries via Intent. See {@link 246android.speech.RecognizerIntent RecognizerIntent}.</li> 247 </ul> 248 249<h4>Miscellaneous API additions</h4> 250 <ul> 251 <li>LocationManager - Applications can get location change updates via 252 Intent</li> 253 <li>WebView - Touch start/end/move/cancel DOM event support</li> 254 <li>Redesigned {@link android.hardware.SensorManager Sensor Manager 255 APIs}</li> 256 <li>GLSurfaceView - convenience framework for creating OpenGL 257 applications</li> 258 <li>Broadcast Intent for app update install succeeded - for smoother app 259 upgrade experience</li> 260 </ul> 261 262 263<h3 id="api-diff">API differences report</h3> 264 265<p>For a detailed view of API changes in Android {@sdkPlatformVersion} (API Level {@sdkPlatformApiLevel}), as compared to 266the previous version, see the <a href="{@docRoot}sdk/api_diff/{@sdkPlatformApiLevel}/changes.html">API 267Differences Report</a>.</p> 268