The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 1 | page.title=SDK Release Notes |
| 2 | @jd:body |
| 3 | |
Dirk Dougherty | fe1f789 | 2009-04-21 18:52:41 -0700 | [diff] [blame] | 4 | <p>This document provides version-specific information about Android SDK |
| 5 | releases. For the latest known issues, please ensure that you're viewing this |
Dirk Dougherty | 3f9de8b | 2009-05-22 16:04:18 -0700 | [diff] [blame] | 6 | page at <a href="http://developer.android.com/sdk/RELEASENOTES.html">http://developer.android.com/sdk/RELEASENOTES.html</a>.</p> |
| 7 | |
Dirk Dougherty | 4b50875 | 2009-07-16 08:51:33 -0700 | [diff] [blame] | 8 | <h2 id="1.5_r3">Android 1.5 SDK, Release 3</h2> |
| 9 | |
| 10 | <p>Provides an updated Android 1.5 system image that includes permissions |
| 11 | fixes, as described below, and a new application — an IME for Japanese |
| 12 | text input. Also provides the same set of developer tools included in the |
| 13 | previous SDK, but with bug fixes and several new features.</p> |
| 14 | |
| 15 | <h3>Permissions Fixes</h3> |
| 16 | |
| 17 | <p>The latest version of the Android platform, deployable to |
| 18 | Android-powered devices, includes fixes to the permissions-checking |
| 19 | in certain areas of the framework. Specifically, the Android system |
| 20 | now properly checks and enforces several existing permissions where it |
| 21 | did not do so in the previous release. Because of these changes in |
| 22 | enforcement, you are strongly encouraged to test your application |
| 23 | against the new Android 1.5 system image included in this SDK, to ensure |
| 24 | that it functions normally. </p> |
| 25 | |
| 26 | <p>In particular, if your application uses any of the system areas listed below, |
| 27 | you should add the required permissions to the application's manifest and then |
| 28 | test the areas of your code that depend on the permission-protected services. |
| 29 | Even if you believe your application does not use the permissions-protected |
| 30 | services, you should compile and test your application under the latest platform |
| 31 | version to ensure that users will not encounter problems when using your |
| 32 | application. </p> |
| 33 | |
| 34 | <p>The changes to permissions are as follows:</p> |
| 35 | |
| 36 | <ul> |
| 37 | <li>When an application requests access to device camera (through |
| 38 | android.hardware.camera), the <code>CAMERA</code> permission check is now |
| 39 | properly enforced. </li> |
| 40 | <li>When an application requests access to device audio capture (through |
| 41 | android.media.MediaRecorder), the <code>RECORD_AUDIO</code> permission check is |
| 42 | now properly enforced.</li> |
| 43 | </ul> |
| 44 | |
| 45 | <p>For more information, see the issue described in the oCert advisory |
| 46 | below:</p> |
| 47 | |
| 48 | <p style="margin-left: 2em;"><a href="http://www.ocert.org/advisories/ocert-2009-011.html">http://www.ocert.org/advisories/ocert-2009-011.html</a> </p> |
| 49 | |
| 50 | <h3>Resolved Issues, Changes</h3> |
| 51 | |
| 52 | <ul> |
| 53 | <li>The SDK includes a new version of the Google APIs add-on. The add-on |
| 54 | provides an updated com.google.android.maps external library that fixes compile |
| 55 | errors related to certain classes such as GeoPoint. For information about the |
| 56 | Google APIs add-on and the library it provides, see: |
| 57 | |
| 58 | <p style="margin-left:2em;"><a |
| 59 | href="http://code.google.com/android/add-ons/google-apis">http://code.google.com/android/add-ons/google-apis</a> </p></li> |
| 60 | |
| 61 | <li>The SDK add-on architecture now lets device manufacturers specify a USB |
| 62 | Vendor ID in their add-ons. |
| 63 | <li>The <code>android</code> tool provides a new command that scans SDK add-ons |
| 64 | for their USB Vendor IDs and makes them available to adb (OS X and Linux |
| 65 | versions of the SDK only). The command is <code>android update adb</code>. On |
| 66 | Windows versions of the SDK, a custom USB driver is included that supports the |
| 67 | "Google" and "HTC" Vendor IDs, which allow adb to recognize G1 and HTC |
| 68 | Magic devices. For other devices, contact the device manufacturer |
| 69 | to obtain a USB driver, especially if you have an SDK add-on that defines |
| 70 | a new USB Vendor ID.</li> |
| 71 | <li>The telephony, sensor, and geo fix issues in the emulator are now |
| 72 | fixed.</li> |
| 73 | <li>When you use adb to uninstall an upgraded application, the Android system |
| 74 | now properly restores any permissions that had already been granted to the |
| 75 | previous (downgrade) version of the application</li> |
| 76 | </ul> |
| 77 | |
Dirk Dougherty | 3f9de8b | 2009-05-22 16:04:18 -0700 | [diff] [blame] | 78 | <h2 id="1.5_r2">Android 1.5 SDK, Release 2</h2> |
| 79 | |
| 80 | <p>This SDK release provides the same developer tools as the Android 1.5 SDK, |
| 81 | Release 1, but provides an updated Android 1.5 system image that includes a |
| 82 | security patch for the issue described in the oCert advisory below:</p> |
| 83 | |
| 84 | <p style="margin-left:2em;"><a href="http://www.ocert.org/advisories/ocert-2009-006.html">http://www.ocert.org/advisories/ocert-2009-006.html</a></p> |
Dirk Dougherty | fe1f789 | 2009-04-21 18:52:41 -0700 | [diff] [blame] | 85 | |
| 86 | <h2 id="1.5_r1">Android 1.5 SDK, Release 1</h2> |
| 87 | |
| 88 | <p>This SDK provides updates to the development tools and Android system that |
| 89 | you use to create applications for compliant Android-powered devices. </p> |
| 90 | |
| 91 | <h3>Release Overview</h3> |
| 92 | |
| 93 | <p>This SDK release includes many new features for developers. Highlights of the |
| 94 | changes include: </p> |
| 95 | |
| 96 | <ul> |
| 97 | <li>Multiple versions of the Android platform are included (Android 1.1, |
| 98 | Android 1.5). The tools are updated to let you deploy your application |
Elliott Hughes | 7f87706 | 2009-07-30 17:00:34 -0700 | [diff] [blame^] | 99 | on any platform in the SDK, which helps you ensure forward-compatibility and, |
Dirk Dougherty | fe1f789 | 2009-04-21 18:52:41 -0700 | [diff] [blame] | 100 | if applicable, backward-compatibility.</li> |
| 101 | <li>Introduces <a href="{@docRoot}guide/developing/tools/avd.html">Android |
| 102 | Virtual Devices</a> — (AVD) configurations of options that you |
| 103 | run in the emulator to better model actual devices. Each AVD gets its |
| 104 | own dedicated storage area, making it much easier to work with multiple emulators |
| 105 | that are running concurrently.</li> |
| 106 | <li>Support for SDK add-ons, which extend the |
| 107 | Android SDK to give you access to one or more external Android libraries and/or |
| 108 | a customized (but compliant) system image that can run in the emulator. </li> |
Dirk Dougherty | 1f8059f | 2009-05-07 11:15:03 -0700 | [diff] [blame] | 109 | <li>The new Eclipse ADT plugin (version 0.9.x) offers new Wizards to let you |
Elliott Hughes | 7f87706 | 2009-07-30 17:00:34 -0700 | [diff] [blame^] | 110 | create projects targeted for specific Android configurations, generate XML |
Dirk Dougherty | fe1f789 | 2009-04-21 18:52:41 -0700 | [diff] [blame] | 111 | resources (such as layouts, animations, and menus), generate alternate layouts, |
| 112 | and export and sign your application for publishing.</li> |
| 113 | <li>Improved JUnit support in ADT</li> |
| 114 | <li>Easier profiling of performance</li> |
| 115 | <li>Easier management of localized applications. You can now include or |
| 116 | exclude locale resources when building your APK from a single |
| 117 | Android project.</li> |
| 118 | <li>A new tool called "android" replaces the activitycreator script.</li> |
| 119 | </ul> |
| 120 | |
| 121 | <p>For details about the Android platforms included in the SDK — including |
| 122 | bug fixes, features, and API changes — please read the Version Notes |
| 123 | documents available at left. For a list of Android platforms included in this |
| 124 | release, see the <a href="{@docRoot}sdk/1.5_r1/index.html">Download |
| 125 | page</a>.</p> |
| 126 | |
| 127 | <h3>Installation and Upgrade Notes</h3> |
| 128 | |
| 129 | <p>If you've been developing an application using an Android 1.1 SDK, you need |
| 130 | to make a few changes to your development environment to migrate to the new SDK. |
| 131 | Tools and documentation are provided to assist you. No changes to the source |
| 132 | code of an existing application should be needed, provided that your application |
| 133 | is not using Android internal structures or APIs.</p> |
| 134 | |
| 135 | <p>To ensure that your existing application will work properly on a device |
| 136 | running the latest version of the Android platform, you are strongly encouraged |
| 137 | to migrate the application to the new SDK, compile it using the platform |
| 138 | matching the application's original API Level, and run it against the most |
| 139 | current platform. </p> |
| 140 | |
| 141 | <p>If you're installing the Android SDK for the first time, please see |
| 142 | the instructions in <a |
| 143 | href="{@docRoot}sdk/1.5_r1/installing.html">Installing the SDK</a>. |
| 144 | |
| 145 | <h3>SDK Add-Ons</h3> |
| 146 | |
| 147 | <p>This version of the SDK introduces support for SDK add-ons, which extend the |
| 148 | Android SDK to give you access to one or more external Android libraries and/or |
| 149 | a customized (but compliant) system image that can run in the emulator. The |
| 150 | purpose of an SDK add-on is to give you a way to develop applications for a |
| 151 | specific actual device (or family of devices) that extends the APIs available to |
| 152 | Android applications through external libraries or system customizations. </p> |
| 153 | |
| 154 | <p>From the perspective of your Android development environment, an SDK add-on |
| 155 | is similar to any of the Android platform targets included in the SDK — it |
| 156 | includes an external library, a system image, as well as custom emulator skins |
| 157 | and system properties. The add-on differs in that the Android platform it |
| 158 | provides may include customized UI, resources, or behaviors, a different set of |
| 159 | preinstalled applications, or other similar modifications. |
| 160 | |
| 161 | <p>The SDK includes a single SDK add-on — the Google APIs add-on. The |
| 162 | Google APIs add-on gives your application access to the com.google.android.maps |
| 163 | external library that is included on many (if not most) Android-powered devices. |
| 164 | The Google APIs add-on also includes a {@link android.location.Geocoder Geocoder} |
| 165 | backend service implementation. For more information, see the "Maps External |
| 166 | Library" section below. </p> |
| 167 | |
| 168 | <h3>Android Virtual Devices (AVDs)</h3> |
| 169 | |
| 170 | <p>The SDK now gives you the capability to compile an application against any |
| 171 | one of several system targets, then run it in the emulator on top of any |
| 172 | compatible system image. There are two types of targets:</p> |
| 173 | <ul> |
| 174 | <li>Targets that represent core Android platform versions. </li> |
| 175 | <li>Targets that are SDK add-ons, which typically provide application access to |
| 176 | one or more external libraries and/or a customized (but compliant) system image |
| 177 | that can run in the emulator. |
| 178 | </ul> |
| 179 | |
| 180 | <p>A new tool called "android" lets you discover what targets and AVDs are |
| 181 | available to use.</p> |
| 182 | |
| 183 | <p>For more information about AVDs, see <a |
| 184 | href="{@docRoot}guide/developing/tools/avd.html">Android Virtual Devices</a> |
| 185 | |
| 186 | <h3>Other Notes</h3> |
| 187 | |
| 188 | <p><strong>Maps External Library</strong></p> |
| 189 | |
| 190 | <p>In previous versions of the SDK, the com.google.android.maps package was |
| 191 | included in the standard Android library and system image. In the Android 1.5 |
| 192 | SDK, that is not the case. The Android 1.5 library and system image do not |
| 193 | include the Maps external library (com.google.android.maps). However, the Maps |
| 194 | external library is available as part of the Google APIs add-on for the Android |
| 195 | SDK, downloadable from this location: </p> |
| 196 | |
| 197 | <p style="margin-left:2em;"><a |
| 198 | href="http://code.google.com/android/add-ons/google-apis">http://code.google.com |
| 199 | /android/add-ons/google-apis</a> </p> |
| 200 | |
| 201 | <p>For your convenience, the Google APIs add-on is included in the SDK. </p> |
| 202 | |
| 203 | <p>For information about how to register for a Maps API Key, see |
| 204 | <a href="http://code.google.com/android/add-ons/google-apis/mapkey.html"> |
| 205 | Obtaining a Maps API Key</a>.</p> |
| 206 | |
| 207 | <p><strong>USB Drivers for Windows</strong></p> |
| 208 | |
| 209 | <p>If you are using Windows and want to develop or test your application on an |
| 210 | Android-powered device (such as the T-Mobile G1), you need an appropriate USB |
| 211 | driver. For your convenience, the Windows version of the Android SDK includes |
| 212 | these USB drivers that you can install, to let you develop on the device:</p> |
| 213 | |
| 214 | <ul> |
| 215 | <li>USB driver for 32-bit XP and Vista</li> |
| 216 | <li>USB driver for 64-bit Vista only</li> |
| 217 | </ul> |
| 218 | |
| 219 | <p>The USB driver files are located in the |
| 220 | <code><SDK>/usb_driver</code> directory. For details and |
| 221 | installation instructions, see <a |
| 222 | href="{@docRoot}guide/developing/device.html#setting-up">Setting Up a |
| 223 | Device for Development</a>.</p> |
| 224 | </p> |
| 225 | |
| 226 | <h3>Resolved Issues, Changes</h3> |
| 227 | |
| 228 | <p><strong>Media</strong></p> |
| 229 | <ul> |
| 230 | <li>Updated documentation for {@link android.media.SoundPool |
| 231 | android.media.SoundPool}</li> |
| 232 | <li>{@link android.webkit.WebView} objects no longer automatically save |
| 233 | thumbnails. The {@link android.webkit.WebView#capturePicture() capturePicture()} |
| 234 | method will need to be called manually.</li> |
| 235 | </ul> |
| 236 | |
| 237 | <h3>Known Issues</h3> |
| 238 | |
| 239 | <p><strong>Sensor problems in Emulator</strong></p> |
| 240 | |
| 241 | <ul> |
| 242 | <li>If your application uses the Sensor API and you are running it in the |
| 243 | emulator on the Android 1.5 system image, you may experience problems. Your |
| 244 | application may generate ANR messages or crash when using the sensors. The |
| 245 | problem is being investigated.</li> |
| 246 | </ul> |
| 247 | |
| 248 | <p><strong>Other</strong></p> |
| 249 | |
| 250 | <ul> |
| 251 | <li>We regret to inform developers that Android 1.5 will not include support for |
| 252 | the Zilog Z80 processor architecture.</li> |
| 253 | </ul> |
| 254 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 255 | |
| 256 | <h2 id="1.1_r1">Android 1.1 SDK, Release 1</h2> |
| 257 | |
Dirk Dougherty | fe1f789 | 2009-04-21 18:52:41 -0700 | [diff] [blame] | 258 | <p>This SDK provides the development tools and Android system image you need to |
| 259 | create applications for Android-powered devices. Applications developed on this |
| 260 | SDK will be compatible with mobile devices running the Android 1.1 platform. |
| 261 | </p> |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 262 | |
Dirk Dougherty | fe1f789 | 2009-04-21 18:52:41 -0700 | [diff] [blame] | 263 | <p>This release provides an updated system image (Android 1.1), updated |
| 264 | documentation, and the same set of development tools provided in the Android 1.0 |
| 265 | r2 SDK. The updated system image includes bug fixes and some smaller features, |
| 266 | as well as a few minor API changes from the 1.0 version. </p> |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 267 | |
Dirk Dougherty | fe1f789 | 2009-04-21 18:52:41 -0700 | [diff] [blame] | 268 | <p>For details about the Android 1.1 system image included in the SDK — |
| 269 | including bug fixes, features, and API changes — please read the <a |
| 270 | href="{@docRoot}sdk/android-1.1.html">Android 1.1 Version Notes</a>.</p> |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 271 | |
| 272 | <h3>App Versioning for Android 1.1</h3> |
| 273 | |
Dirk Dougherty | fe1f789 | 2009-04-21 18:52:41 -0700 | [diff] [blame] | 274 | <p>If you are using this SDK to build an application that is compatible |
| 275 | <em>only</em> with Android-powered devices running the Android 1.1 platform, |
| 276 | please note that you <strong>must</strong> set the the |
| 277 | <code>android:minSdkVersion</code> attribute in the application's manifest to |
| 278 | the API Level of Android 1.1 — "2".</p> |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 279 | |
Dirk Dougherty | fe1f789 | 2009-04-21 18:52:41 -0700 | [diff] [blame] | 280 | <p>Specifically, you specify the <code>android:minSdkVersion</code> attribute in |
| 281 | a <code><uses-sdk></code> element as a child of |
| 282 | <code><manifest></code> in the manifest file. When set, the attribute |
| 283 | looks like this: </p> |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 284 | |
| 285 | <pre><code><manifest> |
| 286 | ... |
Dirk Dougherty | 1432cd8 | 2009-05-01 10:02:17 -0700 | [diff] [blame] | 287 | <uses-sdk android:minSdkVersion="2" /> |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 288 | ... |
| 289 | </manifest></code> |
| 290 | </pre> |
| 291 | |
Dirk Dougherty | fe1f789 | 2009-04-21 18:52:41 -0700 | [diff] [blame] | 292 | <p>By setting <code>android:minSdkVersion</code> in this way, you ensure that |
| 293 | users will only be able to install your application if their devices are running |
| 294 | the Android 1.1 platform. In turn, this ensures that your application will |
| 295 | function properly on their devices, especially if it uses APIs introduced in |
| 296 | Android 1.1. </p> |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 297 | |
Dirk Dougherty | fe1f789 | 2009-04-21 18:52:41 -0700 | [diff] [blame] | 298 | <p>If your application uses APIs introduced in Android 1.1 but does not declare |
Dirk Dougherty | 1432cd8 | 2009-05-01 10:02:17 -0700 | [diff] [blame] | 299 | <code><uses-sdk android:minSdkVersion="2" /></code>, then it will run properly on |
Dirk Dougherty | fe1f789 | 2009-04-21 18:52:41 -0700 | [diff] [blame] | 300 | Android 1.1 devices but <em>not</em> on Android 1.0 devices. </p> |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 301 | |
Dirk Dougherty | fe1f789 | 2009-04-21 18:52:41 -0700 | [diff] [blame] | 302 | <p>If your application does not use any new APIs introduced in Android 1.1, you |
Dirk Dougherty | 1432cd8 | 2009-05-01 10:02:17 -0700 | [diff] [blame] | 303 | can indicate Android 1.0 compatibility by removing <code>android:minSdkVersion</code> or |
Dirk Dougherty | fe1f789 | 2009-04-21 18:52:41 -0700 | [diff] [blame] | 304 | setting the attribute to "1". However, before publishing your application, you |
| 305 | must make sure to compile your application against the Android 1.0 system image |
| 306 | (available in the Android 1.0 SDK), to ensure that it builds and functions |
| 307 | properly for Android 1.0 devices. You should test the application against system |
| 308 | images corresponding to the API Levels that the application is designed to be |
| 309 | compatible with.</p> |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 310 | |
Dirk Dougherty | fe1f789 | 2009-04-21 18:52:41 -0700 | [diff] [blame] | 311 | <p>If you are sure your application is not using Android 1.1 APIs and has no |
| 312 | need to use them, you might find it easier to keep working in the Android 1.0 |
| 313 | SDK, rather than migrating to the Android 1.1 SDK and having to do additional |
| 314 | testing.</p> |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 315 | |
| 316 | |
| 317 | <h3>ADT Plugin Compatibility</h3> |
| 318 | |
| 319 | <p>For this version of the SDK — Android 1.1 SDK, Release 1 |
| 320 | — the compatible version of the Android Development Tools (ADT) |
| 321 | Plugin for Eclipse is <strong>0.8.0</strong>. If you are using a |
| 322 | previous version of ADT, you should update to the latest version for use |
| 323 | with this SDK. For information about how to update your ADT plugin, see |
| 324 | <a href="{@docRoot}sdk/1.1_r1/upgrading.html#update-plugin">Upgrading |
| 325 | the SDK</a>.</p> |
| 326 | |
| 327 | <h3>Installation and Upgrade Notes</h3> |
| 328 | |
| 329 | <p>If you've been developing an application using an Android 1.0 SDK no |
| 330 | changes to your application are needed. You may want to wipe application |
| 331 | user data (emulator option <code>-wipe-data</code>) when running your |
| 332 | application on the Android 1.1 emulator for the first time.</p> |
| 333 | |
| 334 | <p>If you're installing the Android SDK for the first time, please see |
| 335 | the instructions in <a |
Dirk Dougherty | fe1f789 | 2009-04-21 18:52:41 -0700 | [diff] [blame] | 336 | href="{@docRoot}sdk/1.5_r1/installing.html">Installing the SDK</a>. |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 337 | |
| 338 | <h3>Other Notes</h3> |
| 339 | |
| 340 | <p><strong>MapView API Key</strong></p> |
| 341 | |
| 342 | <p>com.google.android.maps.MapView is a class that lets you |
| 343 | easily integrate Google Maps into your application. Before you can |
| 344 | access the maps data, you will need to register with the Google Maps |
| 345 | service and receive a Maps API Key, which you then add to your MapView |
| 346 | for authentication to the server.</p> |
| 347 | |
| 348 | <p>Developers should note that the registration service for MapView is now |
| 349 | active and Google Maps is actively enforcing the Maps API Key requirement. |
| 350 | For information about how to register for a Maps API Key, see |
Dirk Dougherty | 1432cd8 | 2009-05-01 10:02:17 -0700 | [diff] [blame] | 351 | <a href="http://code.google.com/android/add-ons/google-apis/mapkey.html"> |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 352 | Obtaining a Maps API Key</a>.</p> |
| 353 | |
| 354 | <p><strong>USB Drivers for Windows</strong></p> |
| 355 | |
| 356 | <p>If you using Windows and want to develop or test your application on an |
| 357 | Android-powered device (such as the T-Mobile G1), you need an appropriate USB |
| 358 | driver. For your convenience, the Windows version of the Android SDK includes |
| 359 | these USB drivers that you can install, to let you develop on the device:</p> |
| 360 | |
| 361 | <ul> |
| 362 | <li>USB driver for 32-bit XP and Vista</li> |
| 363 | <li>USB driver for 64-bit Vista only</li> |
| 364 | </ul> |
| 365 | |
| 366 | <p>The USB driver files are located in the |
| 367 | <code><SDK>/usb_driver</code> directory. For details and |
| 368 | installation instructions, see <a |
| 369 | href="{@docRoot}guide/developing/device.html#setting-up">Setting Up a |
| 370 | Device for Development</a>.</p> |
| 371 | </p> |
| 372 | |
| 373 | <h3>Resolved Issues, Changes</h3> |
| 374 | |
| 375 | <p><strong>Emulator</strong></p> |
| 376 | <ul> |
| 377 | <li>Emulator now saves the user image in <android>/SDK1.1/</code></li> |
| 378 | </ul> |
| 379 | |
| 380 | <h3>Known Issues</h3> |
| 381 | |
| 382 | <p><strong>JUnit and Eclipse/ADT</strong></p> |
| 383 | <ul> |
| 384 | <li>If you are developing in Eclipse/ADT and want to add JUnit test |
| 385 | classes, you can do so. However, you need to set up a custom JUnit configuration |
| 386 | before your tests will run properly. For detailed information about how to set |
| 387 | up the JUnit configuration, see the troubleshooting topic <a |
| 388 | href="{@docRoot}guide/appendix/faq/troubleshooting.html#addjunit">Running a Junit test class |
| 389 | in Eclipse</a>.</li> |
| 390 | </ul> |
| 391 | |
| 392 | <p><strong>Other</strong></p> |
| 393 | |
| 394 | <ul> |
| 395 | <li>It is not possible to send MMS messages between emulator instances. </li> |
| 396 | <li>In some cases, you may encounter problems when using the browser on an |
| 397 | emulator started with the command-line option <code>-http-proxy</code>. </li> |
| 398 | <li>On the OSX platform, if you manually remove the ~/.android directory |
| 399 | using <code>rm -rf ~/.android</code>, then try to run |
| 400 | the emulator, it crashes. This happens because the emulator fails to create |
| 401 | a new .android directory before attempting to create the child SDK1.0 directory. |
| 402 | To work around this issue, manually create a new .android directory using |
| 403 | <code>mkdir ~/.android</code>, then run the emulator. The emulator |
| 404 | creates the SDK1.0 directory and starts normally. </li> |
| 405 | <li>We regret to inform developers that Android 1.1 will not include support |
| 406 | for ARCNet network interfaces.</li> |
| 407 | <li>The final set of Intent patterns honored by Android 1.0 has not yet been |
| 408 | fully documented. Documentation will be provided in future releases.</li> |
| 409 | <li>In ADT Editor, you can add at most ten new resource values at a time, |
| 410 | in a given res/values/*.xml, using the form in the Android Resources pane. |
| 411 | If you add more than ten, the Android Resources pane will not display the |
| 412 | attributes fields for the additional resource entries. To work around this |
| 413 | problem, you can close the file in the editor and open it again, or you |
| 414 | can edit the resource entries in the XML text mode. </li> |
| 415 | <li>The emulator's battery-control commands (<code>power <option></code>) |
| 416 | are not working in this release.</li> |
| 417 | </ul> |
| 418 | |
| 419 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 420 | <h2 id="1.0_r2">Android 1.0 SDK, Release 2</h2> |
| 421 | |
| 422 | <p>This SDK release includes the Android 1.0 platform and application API. |
| 423 | Applications developed on this SDK will be compatible with mobile devices |
| 424 | running the Android 1.0 platform.</p> |
| 425 | |
| 426 | <p>This release includes mainly bug fixes, although some smaller features were |
| 427 | added.</p> |
| 428 | |
| 429 | <h3>ADT Plugin Compatibility</h3> |
| 430 | |
| 431 | <p>For this release of the SDK, the compatible version of the Android |
| 432 | Development Tools (ADT) Plugin for Eclipse is <strong>0.8.0</strong>. If you are |
| 433 | using a previous version of ADT, you should update to the latest version for use |
| 434 | with this SDK. For information about how to update your ADT plugin, see <a |
Scott Main | 8a4c53a | 2009-04-24 13:41:44 -0700 | [diff] [blame] | 435 | href="{@docRoot}sdk/1.0_r2/upgrading.html">Upgrading the SDK</a>.</p> |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 436 | |
| 437 | <h3>Installation and Upgrade Notes</h3> |
| 438 | |
| 439 | <p>If you're installing the Android SDK for the first time, please see the |
Scott Main | 8a4c53a | 2009-04-24 13:41:44 -0700 | [diff] [blame] | 440 | instructions in <a href="{@docRoot}sdk/1.0_r2/installing.html">Installing the |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 441 | SDK</a>. |
| 442 | |
| 443 | <h3>Other Notes</h3> |
| 444 | |
Elliott Hughes | 7f87706 | 2009-07-30 17:00:34 -0700 | [diff] [blame^] | 445 | <p><strong>T-Mobile G1 Compatibility</strong></p> |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 446 | |
Elliott Hughes | 7f87706 | 2009-07-30 17:00:34 -0700 | [diff] [blame^] | 447 | <p>This version of the SDK has been tested for compatibility with the first |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 448 | Android-powered mobile device, the <a href="http://www.t-mobileg1.com">T-Mobile |
| 449 | G1</a>. </p> |
| 450 | |
| 451 | <p><strong>MapView API Key</strong></p> |
| 452 | |
| 453 | <p>MapView is a class that lets you easily integrate Google Maps into your |
| 454 | application. Before you can access the maps data, you will need to register with |
| 455 | the Google Maps service and receive a Maps API Key, which you then add to your |
| 456 | MapView for authentication to the server.</p> |
| 457 | |
| 458 | <p>Developers should note that the registration service for MapView is now |
| 459 | active and Google Maps is actively enforcing the Maps API Key requirement. For |
| 460 | information about how to register for a Maps API Key, see <a |
Scott Main | 8a4c53a | 2009-04-24 13:41:44 -0700 | [diff] [blame] | 461 | href="http://code.google.com/android/add-ons/google-apis/mapkey.html">http://code.google.com/android/add-ons/google-apis/mapkey.html</a>. |
| 462 | </p> |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 463 | |
| 464 | <p><strong>USB Driver for Windows</strong></p> |
| 465 | <p>If you using Windows and want to develop or test your application on an |
| 466 | Android-powered device (such as the T-Mobile G1), you need an appropriate USB |
| 467 | driver. For your convenience, the Windows version of the Android SDK includes a |
| 468 | USB driver that you can install, to let you develop on the device. The USB |
| 469 | driver files are located in the <code><SDK>/usb_driver</code> directory. |
| 470 | |
| 471 | </p> |
| 472 | |
| 473 | <h3>Resolved Issues, Changes</h3> |
| 474 | <ul> |
| 475 | <li>The android.jar in this SDK release now includes several classes that were |
| 476 | missing from the previous SDK. </li> |
| 477 | <li>The android.R.styleable class and its fields were removed from the public |
| 478 | API, to better ensure forward-compatibility for applications. The constants |
| 479 | declared in android.R.styleable were platform-specific and subject to arbitrary |
| 480 | change across versions, so were not suitable for use by applications. You can |
| 481 | still access the platform's styleable attributes from your resources or code. To |
| 482 | do so, declare a custom resource element using a |
| 483 | <code><declare-styleable></code> in your project's res/values/R.attrs |
| 484 | file, then declare the attribute inside. For examples, see |
| 485 | <sdk>/samples/ApiDemos/res/values/attrs.xml. For more information about |
| 486 | custom resources, see <a |
Scott Main | 8a4c53a | 2009-04-24 13:41:44 -0700 | [diff] [blame] | 487 | href="{@docRoot}guide/topics/resources/available-resources.html#customresources">Custom |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 488 | Layout Resources</a>. Note that the android.R.styleable documentation is still |
| 489 | provided in the SDK, but only as a reference of the platform's styleable |
| 490 | attributes for the various elements.</li> |
| 491 | <li>The VM now properly ensures that private classes are not |
| 492 | available to applications through reflection. If you were using reflection |
| 493 | to access private classes in a previous release, you will now get a run-time |
| 494 | error. </li> |
| 495 | |
| 496 | <li>The Settings and Email applications are now included in the SDK and |
| 497 | available in the emulator.</li> |
| 498 | <li>We regret to inform developers that SDK 1.0_r2 does not support MFM, RLL, |
| 499 | or Winchester hard disk drives.</li> |
| 500 | <li>In the emulator, the control key for enabling/disabling trackball mode |
| 501 | is changed from Control-T to F6. You can also enter trackball mode temporarily |
| 502 | using the Delete key. While the key is pressed, you can send trackball events.</li> |
| 503 | </ul> |
| 504 | |
| 505 | <p>Unless otherwise noted, Known Issues from the previous SDK release also apply |
| 506 | to this release.</p> |
| 507 | |
| 508 | |
| 509 | |
| 510 | |
| 511 | |
| 512 | |
| 513 | <h2 id="1.0_r1">Android 1.0 SDK, Release 1</h2> |
| 514 | |
| 515 | <p>This SDK release is the first to include the Android 1.0 platform and application API. Applications developed on this SDK will be compatible with mobile devices running the Android 1.0 platform, when such devices are available.</p> |
| 516 | |
Scott Main | 8a4c53a | 2009-04-24 13:41:44 -0700 | [diff] [blame] | 517 | <p>This release includes mainly bug fixes, although some smaller features were added. The Android 1.0 also includes several API changes from the 0.9 version. For those porting from the M5 release, the SDK also includes the legacy changes overview and API Differences Reports. See the current Overview of Changes for more information. </p> |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 518 | |
| 519 | <h3>ADT Plugin Compatibility</h3> |
| 520 | |
Scott Main | 8a4c53a | 2009-04-24 13:41:44 -0700 | [diff] [blame] | 521 | <p>For this version of the SDK — Android 1.0 SDK, Release 1 — the compatible version of the Android Development Tools (ADT) Plugin for Eclipse is <strong>0.8.0</strong>. If you are using a previous version of ADT, you should update to the latest version for use with this SDK. For information about how to update your ADT plugin, see <a href="{@docRoot}sdk/1.0_r1/upgrading.html">Upgrading the SDK</a>.</p> |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 522 | |
| 523 | <h3>Installation and Upgrade Notes</h3> |
| 524 | |
Scott Main | 8a4c53a | 2009-04-24 13:41:44 -0700 | [diff] [blame] | 525 | <p>If you've been developing an application using a previous SDK version and you want the application to run on Android-powered mobile devices, you must port the application to the Android 1.0 SDK. Please see <a href="{@docRoot}sdk/1.0_r1/upgrading.html">Upgrading the SDK</a> for detailed instructions on how to make the transition to this release. Be sure to wipe application user data (emulator option <code>-wipe-data</code>) when running your application on the Android 1.0 SDK emulator.</p> |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 526 | |
Scott Main | 8a4c53a | 2009-04-24 13:41:44 -0700 | [diff] [blame] | 527 | <p>If you're installing the Android SDK for the first time, please see the instructions in <a href="{@docRoot}sdk/1.0_r1/installing.html">Installing the SDK</a>. |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 528 | |
| 529 | <h3>Other Notes</h3> |
| 530 | |
| 531 | <p><strong>MapView API Key</strong></p> |
| 532 | |
Scott Main | 8a4c53a | 2009-04-24 13:41:44 -0700 | [diff] [blame] | 533 | <p>MapView is a class that lets you easily integrate Google Maps into your application. Before you can access the maps data, you will need to register with the Google Maps service and receive a Maps API Key, which you then add to your MapView for authentication to the server.</p> |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 534 | |
| 535 | <p>Currently, the registration service for MapView is not yet active and Google Maps is not yet enforcing the Maps API Key requirement. However, note that the registration service will be activated soon, so that MapViews in any application deployed to a mobile device will require registration and a valid Maps API Key. </p> |
| 536 | |
Scott Main | 8a4c53a | 2009-04-24 13:41:44 -0700 | [diff] [blame] | 537 | <p>As soon as the registration service becomes available, we will update the page at <a href="http://code.google.com/android/add-ons/google-apis/mapkey.html">http://code.google.com/android/add-ons/google-apis/mapkey.html</a> with details about how and where to register. Please check that page periodically for registration information, if you are using a MapView.</p> |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 538 | |
| 539 | |
| 540 | <h3>Resolved Issues, Changes</h3> |
| 541 | |
| 542 | <p><strong>Emulator</strong></p> |
| 543 | <ul> |
| 544 | <li>Emulator now saves the user image in <android>/SDK1.0/</code></li> |
| 545 | <li>Fixed EsounD-related freezes on Linux.</li> |
| 546 | <li>Fixed the documentation in -help-audio. '-audio list' doesn't work, one |
| 547 | needs to call -help-audio-out and -help-audio-in to get the list of valid |
| 548 | audio backends.</li> |
| 549 | <li>Fixed scrollwheel Dpad emulation in rotated mode. before that, using the |
| 550 | scroll-wheel would always generated Dpad Up/Down events, even when in |
| 551 | landscape mode.</li> |
| 552 | |
| 553 | <li>Several Obsolete command options were removed.</li> |
| 554 | <li>Setting the network speed through the console or the -netspeed option will |
| 555 | properly modify the connectivity icon on the device.</li> |
| 556 | <li>Setting the GSM voice registration state to 'roaming' in the console will |
| 557 | properly modify the voice icon on the device</li> |
| 558 | </ul> |
| 559 | |
| 560 | <p><strong>SQLite</strong></p> |
| 561 | <ul> |
| 562 | <li>SQLite is now included in the SDK package on all platforms. </li> |
| 563 | </ul> |
| 564 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 565 | <p><strong>Other</strong></p> |
| 566 | |
| 567 | <ul> |
| 568 | <li>It is not possible to send MMS messages between emulator instances. </li> |
| 569 | <li>In some cases, you may encounter problems when using the browser on an |
| 570 | emulator started with the command-line option <code>-http-proxy</code>. </li> |
| 571 | |
| 572 | <li>We regret to inform developers that Android 1.0 will not include support for |
| 573 | dot-matrix printers.</li> |
| 574 | <li>On the OSX platform, if you manually remove the ~/.android directory |
| 575 | using <code>rm -rf ~/.android</code>, then try to run |
| 576 | the emulator, it crashes. This happens because the emulator fails to create |
| 577 | a new .android directory before attempting to create the child SDK1.0 directory. |
| 578 | To work around this issue, manually create a new .android directory using |
| 579 | <code>mkdir ~/.android</code>, then run the emulator. The emulator |
| 580 | creates the SDK1.0 directory and starts normally. </li> |
| 581 | <li>The final set of Intent patterns honored by Android 1.0 has not yet been |
| 582 | fully documented. Documentation will be provided in future releases.</li> |
| 583 | <li>In ADT Editor, you can add at most ten new resource values at a time, |
| 584 | in a given res/values/*.xml, using the form in the Android Resources pane. |
| 585 | If you add more than ten, the Android Resources pane will not display the |
| 586 | attributes fields for the additional resource entries. To work around this |
| 587 | problem, you can close the file in the editor and open it again, or you |
| 588 | can edit the resource entries in the XML text mode. </li> |
| 589 | <li>The emulator's battery-control commands (<code>power <option></code>) |
| 590 | are not working in this release.</li> |
| 591 | |
| 592 | </ul> |
| 593 | |