1 page.title=Release Notes for Older SDK Versions 2 excludeFromSuggestions=true 3 @jd:body 4 5 <div class="special"> 6 <p><strong>Note:</strong> These are the release notes for the "early-look" SDK versions, released 7 before the full Android 1.0 release in September 2008. 8 Release notes for the Android 1.0 and later SDK versions are provided in the main 9 <a href="{@docRoot}sdk/RELEASENOTES.html">Release Notes</a> document.</p> 10 </div> 11 12 13 14 <a name="0.9_r1" id="0.9_r1"></a> 15 <h2>Android 0.9 SDK Beta (r1)</h2> 16 17 <p>This beta SDK release contains a large number of bug fixes and improvements from the early-look SDKs. 18 The sections below describe the highlights of the release. 19 20 <h3>New Features and Notable Changes</h3> 21 22 <p><strong>Behavior and System Changes</strong></p> 23 <ul> 24 <li>New Home screen and many user interface updates 25 </li> 26 <li>Minor changes to Activity lifecycle and task management 27 </li> 28 <li>New window option to request OpenGL acceleration for certain kinds of View structures 29 </li> 30 </ul> 31 <p> 32 <b> 33 Significant API Changes</b> 34 </p> 35 <ul> 36 <li>onFreeze(Bundle) renamed to onSaveInstanceState(Bundle), to better reflect the fact that it does not represent an actual change in application lifecycle 37 </li> 38 <li>IntentReceivers are now known as BroadcastReceivers (but still operate on Intents.) 39 </li> 40 <li>Various parts of the API cleaned up to use Intents instead of Bundles; Intent itself improved to reduce the need for separate payload Bundles.</li> 41 <li>ContentProvider Cursors have had significant changes to make them easier to create and remove certain data consistency bugs. 42 </li> 43 <li>Changes to menus to make them more flexible; also added context menus (similar to "right mouse button" menus) 44 </li> 45 <li>Changes to the Sensor API to make reading sensors more convenient and reduce the need to poll 46 </li> 47 <li>Improvements to the Camera API 48 </li> 49 <li>Significant changes to the Location API to make it easier to use and better self-documenting 50 </li> 51 <li>API cleanup on MapViews 52 </li> 53 <li>Performance-related changes to the MediaPlayer, as well as support for new types of ringtones 54 </li> 55 <li>Apache HTTPClient installation upgraded to 4.x of that API; 3.x version is removed 56 </li> 57 <li>HTTPClient 4.x removes multipart methods, include HttpMime which is an extension of Mime4j (http://james.apache.org/mime4j/index.html) in your project instead 58 </li> 59 <li>Improvements to WiFi and related networking 60 </li> 61 <li>New Preferences API to easily store small amounts of data 62 </li> 63 <li>Improvements to the Telephony API, including ability to obtain source number of incoming phone calls 64 </li> 65 <li>Variety of improvements to the View API 66 </li> 67 <li>Variety of improvements to component management, such as the ability to keep components private, better control over when processes are started, and ability to "alias" an Activity to more than one entry in AndroidManifest.xml 68 </li> 69 <li>Improvements to how the Browser and WebView, such as better control over content downloads 70 </li> 71 <li>A number of enhancements to XML layouts, such as the new <merge> tag 72 </li> 73 <li>Numerous improvements to the standard widgets 74 </li> 75 <li>Network access now requires that applications obtain a permission in their AndroidManifest.xml files. 76 </li> 77 </ul> 78 <p> 79 <b> 80 Maps & Location</b> 81 </p> 82 <ul> 83 <li>The MapView will require an API key on final Android 1.0 devices. This key can be obtained at no cost from Google, and will allow access to the full MapView API. In this release, the API key must be provided but can be any dummy value. In the final 1.0-compatible SDKs, this will need to be a real key. 84 </li> 85 <li>The KML-based mock location provider supported in previous releases is no longer supported. In the current SDK, you can use the emulator console to send GPS fix updates to the emulator and applications running on it. Also, the DDMS tool provides an UI that you can use to easily upload GPX and KML files. DDMS handles playback of the KML or GPX tracks automatically. </li> 86 </ul> 87 <p> 88 <b>ADT Plugin for Eclipse</b></p> 89 <p>The ADT Plugin that accompanies this SDK includes a preview of the Graphical Layout Editor. Files located in <project>/res/layout[-qualifiers]/ will be opened with the new layout editor. This is very much a work in progress, and provided here for preview purpose. The editor feature is subject to change. 90 </p> 91 <ul> 92 <li>Dual page editor with a WYSIWYG page (the graphical editor) and an XML page with content assist. 93 </li> 94 <li>The interactivity in the editor itself is limited to selection at the moment. Actions on the layout elements can be done from the following standard Eclipse views: Outline (add/remove/up/down), and Properties (editing of all the element properties with a tooltip in the status bar). 95 </li> 96 <li>Top part of the editor allows you to display the layout in different configurations (language, orientation, size, etc...), and different themes. 97 98 <ul> 99 <li>All referenced resources (strings, bitmaps, etc...) are resolved based on the selected configuration/theme. 100 </li> 101 <li>A green check mark next to a resource qualifier indicates that the opened file matches the value of the qualifier. A warning sign indicates that the opened file does not specifies any value for this qualifier. 102 </li> 103 <li>If a different version of the opened layout matches the new configuration selection (in a different res/layout-qualifier folder) then the editor automatically switches to that new file. 104 </li> 105 </ul> 106 </li> 107 <li>Custom Views are supported, however if they do too much in their constructor/onDraw method, it may not work (the layout library used by the editor only includes a sub-part of the Android framework). Check the android console for errors/exceptions. 108 </li> 109 </ul> 110 111 <p>Known issues/limitations for Graphical Layout Editor include:</p> 112 113 <ul> 114 <li>Font display is very close but not equals to on-device rendering since the font engine in Java slightly differs from the font engine in Android. This should not have any impact on your layouts. 115 </li> 116 <li>Creating new views in a relative layout automatically puts each new elements below each other using the <i>layout_below</i> attribute. However, until the layout file is saved, they will appear stacked on top of each other. 117 </li> 118 <li>Some XML based drawables don't draw. Fading in the scroll/list view appears as a white rectangle. Generally do not expect every single fancy drawing feature of the android framework to be supported in the layout editor (but we're working on it). 119 </li> 120 <li>Themes defined in the project are not added to the theme drop-down. 121 </li> 122 <li>No animation support! 123 </li> 124 <li>No support for WebView, MapView and SurfaceView. 125 </li> 126 <li>No UI support for <merge>, <include>, <ViewStub> elements. You can add these elements to your manifest using the xml editor only. 127 </li> 128 <li>If a layout fails to render in a way that prevents the whole editor from opening, you can: 129 130 <ul> 131 <li>open that particular file in a different editor: right click the file in the package explorer and choose Open With... > XML editor 132 </li> 133 <li>completely disable the layout editor, by setting a system wide environment variable called ANDROID_DISABLE_LAYOUT to any value. 134 </li> 135 </ul> 136 <li>If a layout fails to render, check the android console (in the standard Eclipse Console view). Errors/Exceptions will be displayed in there. 137 </li> 138 </ul> 139 </li> 140 </ul> 141 <p>Other ADT features/notes include:</p> 142 <ul> 143 <li>There is a new launch option for activity. You can choose to launch the default activity (finds an activity configured to show up in the home screen), or a specific activity, or none.</li> 144 <li>Normal Java resources (non Java files placed in package folders) are now properly packaged in the final package, and can be accessed through normal java API such as ClassLoader.getResourceAsStream()</li> 145 <li>Launch configuration now has an option to wipe emulator data on launch. This always asks for confirmation.</li> 146 <li>Launch configuration now has an option to disable the boot animation. This will let the emulator start faster on older computers.</li> 147 <li>Installation of application is now more robust and will notify of installation failure. Also installation is blocking, removing issues where ADT tried to launch the activity before the app was installed.</li> 148 149 </ul> 150 151 <p><b>Ant Build Tools</b></p> 152 153 <ul> 154 <li><span>External jar libraries are now directly supported by build.xml, just drop them in the libs directory.</li> 155 </ul> 156 157 <p><b>Emulator</b></p> 158 159 <ul> 160 <li>The console port number of a given emulator instance is now displayed in its window's title bar.</li> 161 <li>You can define the console port number used by a given emulator instance. 162 To do so, start the instance with the '-port <port>' option and 163 specify which port the emulator should bind to for the console. <port> must be an *even* integer between 5554 and 5584 inclusive. The corresponding ADB port will be <port>+1.</li> 164 <li>The <code>-adb-port</code> command is deprecated. Please do not use it, as it will be removed soon and you cannot use both -port and -adb-port at the same time.</li> 165 <li>Voice/sms are automatically forwarded to other emulator instances running on the same machine, as long as you use their console port number as the destination phone number. For example, if you have two emulators running, the first one will typically use console port 5554, and the second one will use port 5556, dialing 5556 on the first emulator will generate an incoming call on the second emulator. You can also hold/unhold calls. This also works when sending SMS messages from one emulator to the other.</li> 166 <li>A new <code>-scale <fraction></code> option allows you to scale the emulator window. </li> 167 <li>A new <code>-no-boot-anim</code> option tells the emulator to disable the boot animation. On slower systems, this can significantly reduce the time to boot the system in the emulator.</li> 168 169 </ul> 170 171 <p> 172 <b>Other Development Tools</b> 173 </p> 174 175 <p>The SDK includes several new development tools, such as</p> 176 <ul> 177 <li><a href="{@docRoot}tools/help/hierarchy-viewer.html">HierarchyViewer</a> is a visual tool for inspecting and debugging your user interfaces and layout. </li> 178 <li><a href="{@docRoot}tools/help/draw9patch.html">Draw 9-patch</a> allows you to easily create a NinePatch graphic using a WYSIWYG editor. </li> 179 <li>The <a href="{@docRoot}tools/help/monkey.html">UI/Application Exerciser Monkey</a> generates pseudo-random system and user events, for testing your application. </li> 180 </ul> 181 <p> 182 <b>Application Signing</b> 183 </p> 184 <ul> 185 <li>Starting with this release, Android .apk files must be cryptographically signed, or the system will reject them upon installation. The purpose of this requirement is to securely and uniquely identify developers, so that the system can -- for example -- safely let multiple .apk files signed by the same developer share resources. 186 </li> 187 <li>There are no requirements on the key used to sign .apk files; locally-generated and self-signed keys are allowed. There is no PKI, and developers will not be required to purchase certificates, or similar. For developers who use the Eclipse/ADT plugin, application signing will be largely automatic. Developers who do not use Eclipse/ADT can use the standard Java jarsigner tool to sign .apk files. 188 </li> 189 </ul> 190 <p> 191 <b>Sample Code</b> 192 </p> 193 <ul> 194 <li>LunarLander has been converted to render into a SurfaceView via a background Thread, for better performance. 195 </li> 196 <li>New sample: the source code for the now-obsolete Home screen from M5 is included as an example of how to construct a Home screen replacement. 197 </li> 198 </ul> 199 <p> 200 <b> 201 Removed Functionality</b> 202 </p> 203 <ul> 204 <li>Due to significant API changes in the upstream open-source project and due to the timeline of getting certain Bluetooth profile implementations certified, a comprehensive Bluetooth API will not be possible or present in Android 1.0. 205 </li> 206 <li>Due to the security risks inherent in accepting arbitrary data from "outside" the device, the data messaging facility of the GTalkService will not be present in Android 1.0. The GTalkService will provide connectivity to Google's servers for Google Talk instant messaging, but the API has been removed from this release while we improve the service. Note that this will be a Google-specific service and is not part of the core of Android. 207 </li> 208 <li>We know that these changes will affect many developers who have worked with the prior early looks at the SDK, and we are very sorry for the resulting inconvenience. We look forward to the possibilty of restoring some or all of this functionality in a later version of the Android platform. 209 </li> 210 </ul> 211 <p> 212 <b> 213 Miscellaneous</b> 214 </p> 215 <ul> 216 <li>Many internal and non-public APIs have been removed from the documentation. Classes and methods that are not present in the documentation are non-public and should not be used, even though they may appear in tools such as IDEs. A future version of the SDK will ship with an android.jar file that contains only public classes, to help developers avoid accidentally using non-public APIs. 217 </li> 218 <li>A few extraneous APIs (such as unnecessary packages under java.awt) have been removed. 219 </li> 220 <li>Several additional tools are included, such as a utility for easily drawing 9-patch images. 221 </li> 222 <li>The DDMS utility has been refactored into library form. This is not of direct interest to application developers, but may be of interest to vendors interested in integrating the Android SDK into their products. Watch for more information about the ddmlib library soon. 223 </li> 224 <li>For performance and maintainability reasons, some APIs were moved into separate modules that must be explicitly included in the application via a directive in AndroidManifest.xml. Notable APIs that fall into this category are the MapView, and the java.awt.* classes, which each now reside in separate modules that must be imported. Developers who overlook this requirement will see ClassNotFoundExceptions that seem spurious. 225 </li> 226 <li>Developers who use 'adb push' to install applications must now use 'adb install', since the full package manager is now implemented. 'adb push' will no longer work to install .apk files. 227 </li> 228 <li>The emulator supports a variety of new options, and some existing options have been changed. Please consult the updated emulator documentation for details. 229 </li> 230 </ul> 231 232 <h3> 233 Resolved Issues 234 </h3> 235 <p> 236 The list below is not comprehensive, but instead highlights the most interesting fixes since the last SDK release. 237 </p> 238 <ul> 239 <li>More of the standard Android user applications are now included, such as the Music and Messaging applications. 240 </li> 241 <li>Many bug fixes to the Media Player 242 </li> 243 <li>Emulator performance is improved, especially for startup 244 </li> 245 <li>More internal APIs are removed from class documentation. (However, this work is not quite yet complete.) 246 </li> 247 <li>It's now much easier to add media content to the SD card and have the ContentProvider locate and expose it to other applications. 248 </li> 249 </ul> 250 251 <h3> 252 Known Issues 253 </h3> 254 <ul> 255 <li>The final set of Intent patterns honored by Android 1.0 has not yet been fully documented. Documentation will be provided in future releases. 256 </li> 257 <li>We regret to inform developers that Android 1.0 will not support 3.5" floppy disks. 258 </li> 259 <li>Unfortunately, the ability to play audio streams from memory (such as via an InputStream or Reader) will not be possible in Android 1.0. As a workaround, we recommend that developers save media content to SD card and use MediaPlayer to play from a file URI, or embed a small HTTP server and play from a URI on localhost (such as http://127.0.0.1:4242/something). 260 </li> 261 <li>Android now supports modules or libraries that can be optionally linked into applications; a good example is the MapView, which has been moved into such a library. However, Android 1.0 will not support the ability for third-party developers to create such libraries for sharing with other applications. 262 </li> 263 <li>We believe that we have eliminated the problem with very long emulator startups on Windows, but had some trouble reproducing the issue. We are interested in feedback from developers, if this issue persists. 264 </li> 265 </ul> 266 267 268 269 270 <a name="m5-rc15"></a> 271 <h2>Version m5-rc15</h2> 272 273 <h3>New Features</h3> 274 <p>m5-rc15 does not introduce any new features.</p> 275 276 <h3>Resolved Issues</h3> 277 <ul> 278 <li>1012640: Incorrect handling of BMP images.</li> 279 </ul> 280 281 <h3>Known Issues</h3> 282 <p>Unless otherwise noted, Known Issues from m5-rc14 also apply to m5-rc15.</p> 283 284 285 286 287 <a name="m5-rc14"></a> 288 <h2>Version m5-rc14</h2> 289 290 <h3>New Features</h3> 291 292 <p>In addition to changes in the Android APIs, m5-rc14 also introduces changes to the Android Developer Tools:</p> 293 294 <h4>emulator</h4> 295 <ul> 296 <li>The Android emulator now support SD card images up to 128 GB in size. The previous limit was 2 GB.</li> 297 </ul> 298 299 <h4>DDMS</h4> 300 <ul> 301 <li>Support for managing multiple devices has been integrated into DDMS. This should make it easier to debug applications that are run on multiple device scenarios.</li> 302 </ul> 303 304 <h4>ADT</h4> 305 <ul> 306 <li>ADT now attempts to connect a debugger to any application that shows up 307 in the wait-for-debugger state, even if this application was not launched 308 from Eclipse. 309 <br /><br /> 310 The connection is actually established only if there exists a project 311 in the Eclipse workspace that contains an <code>AndroidManifest.xml</code> 312 declaring a package matching the name of the process. 313 To force this connection from your code, use <code>Debug.waitForDebugger()</code>. Activities declaring that they require their own process through the 314 "process" attribute with a value like ":someProcess" will be 315 recognized and a debugger will be connected accordingly. 316 This should make it easier to debug intent receivers, services, 317 providers, and other activities not launched from the standard app 318 launcher.<br /><br /></li> 319 <li>ADT has launch modes for device target selection. Automatic mode will: 1) launch an emulator if no device is present, 2) automatically target the device if only one is connected, and 3) prompt the user if 2 or more are connected. Manual mode will always prompt the user.<br /><br /></li> 320 <li>ADT also contains the same support for multiple devices that has been introduced into DDMS.</li> 321 </ul> 322 323 <h4>AIDL</h4> 324 <ul> 325 <li>AIDL files that import and reuse types is now supported by activityCreator.py and ADT.</li> 326 </ul> 327 328 <h4>traceview</h4> 329 <ul> 330 <li>The <a href="{@docRoot}tools/help/traceview.html">traceview</a> tool is now included in the SDK.</li> 331 </ul> 332 333 <h3>Resolved Issues</h3> 334 335 <p>The following Known Issues from m3-rc20 have been resolved:</p> 336 <ul> 337 <li>917572: The activityCreator created incorrect IntelliJ scripts</li> 338 <li>917465: Unanswered incoming calls placed from the emulator console will result in an unfinished call UI if you press the call back button</li> 339 <li>917247: dmtracedump and traceview tools are not available in the SDK</li> 340 <li>912168: Extremely rapid or prolonged scrolling in the Maps application or MapsView will result in application errors</li> 341 <li>905852: adb emits warnings about deprecated API use on Mac OS X 10.5</li> 342 <li>905242: The Run dialog sometimes failed to show the Android Launcher</li> 343 <li>901122: The focus ring in the browser is sometimes incorrect</li> 344 <li>896274: On Windows, the emulator sometimes starts off-screen</li> 345 <li>778432: Icons for newly installed applications do not display</li> 346 </ul> 347 348 <h3>Known Issues</h3> 349 350 <p>The following are known issues in m5-rc14:</p> 351 352 <ul> 353 <li>1017312: The emulator window size has been reduced slightly, to allow it to be fully visible on smaller screens. This causes a slight clipping of the HVGA emulator skin but does not affect its function.</li> 354 <li>1021777: Setting a power requirement in a <code>Criteria</code> object passed to <code>{@link android.location.LocationManager#getBestProvider getBestProvider()}</code> will result in a value not being returned.</li> 355 <li>1025850: Emulator failing to launch from the Eclipse plugin due to wrong custom command line parameters do not report the error anywhere and silently fails.</li> 356 </ul> 357 358 <p>Unless otherwise noted, Known Issues from m3-rc20a also apply to m5-rc14.</p> 359 360 361 362 363 <a name="m3-rc37a"></a> 364 <h2>Version m3-rc37a</h2> 365 366 <p>Version m3-rc37a and ADT 0.3.3 were released on December 14, 2007.</p> 367 368 <h3>New Features</h3> 369 370 <h4>Android Debug Bridge (ADB)</h4> 371 <ul> 372 <li>Now supports multiple emulators on one host computer. Please note that you need to use the <code>-data</code> option when starting secondary emulators, to allow those instances to save their data across sessions. Also, DDMS does not yet support debugging on multiple emulators yet. </li> 373 </ul> 374 375 <h4>ADT Plugin for Eclipse</h4> 376 <ul> 377 <li>Adds editor capabilities for working with Android manifest files, such as syntax highlighting and autocompletion. The editor capabilities require the Web Tools WST plugin for Eclipse, which is included in <a href="http://www.eclipse.org/downloads/moreinfo/compare.php">most Eclipse packages</a>. Not having WST does not prevent the ADT plugin from working. If necessary, you can download and install WST from the Web Tools Project <a href="http://download.eclipse.org/webtools/downloads">downloads page</a>. To update directly from an Eclipse installation, you can add a remote update site with this URL: http://download.eclipse.org/webtools/updates . Note that installing WST on Eclipse 3.4 will require installing other packages, as detailed on the WTP downloads page</a>. 378 </li> 379 <li>Now retries to launch the app on the emulator if it fails due to timing issues when the emulator is booting.</li> 380 <li>Adds support for loading custom skins from the <SDK>/lib/images/skins/ directory. The Skin dropdown in the Emulator tab is now built from the content of the skins/ directory in order to support developer-made skins.</li> 381 <li>Adds an Emulator control panel. This is a UI on top of the emulator console that allows you to change the state of the network and gsm connection, and to initiate incoming voice call. (This is also present in standalone DDMS.)</li> 382 <li>Adds support for referenced projects. Android projects will add to the apk package any code from referenced projects.</li> 383 <li>Eclipse console now warns if an .apk that is pushed to the device declares the same package as another already installed package.</li> 384 <li>Java classes generated by the Eclipse plugin are now marked as derived automatically, so that Team plugins do not consider them as regular source.</li> 385 </ul> 386 387 <h4>Emulator Console</h4> 388 <ul> 389 <li>Now provides support for emulating inbound SMS messages. The ADT plugin and DDMS provide integrated access to 390 this capability. For more information about how to emulate inbound SMS from the console, 391 see <a href="{@docRoot}tools/help/emulator.html#sms">SMS Emulation</a>. </li> 392 </ul> 393 394 <h4>Emulator</h4> 395 <ul><li>The default emulator skin has been changed to HVGA-P from QVGA-L. For information 396 about emulator skins and how to load a specific skin when starting the emulator, see 397 <a href="{@docRoot}tools/help/emulator.html#skins">Using Emulator Skins</a>.</li> 398 </ul> 399 400 <h3>Resolved Issues</h3> 401 402 <h4>907947</h4> 403 <p><code>adb -version</code> now returns a version number.</p> 404 405 <h4>917462</h4> 406 <p>Audio on Windows is fixed and is no longer 'choppy'. </p> 407 408 <h4>Removed Manifest File Locking on Mac OS X</h4> 409 410 <p>ADT plugin now uses a custom java editor for R.java/Manifest.java, to make those files non-editable. This is to replace the current locking mechanism which causes issues on Mac OS (preventing projects from being deleted). Note that your project must recompile at least once for the lock to be removed from the files.</p> 411 412 <h4>The following known issues noted in m3-rc20 are now fixed:</h4> 413 <p> 414 <ul> 415 <li>890937: Emulator does not support non-qwerty keyboards. 416 <li>894618: <code>adb shell</code> may fail to connect when used the first time. 417 <li>896274: On Windows, the emulator window may start off-screen. 418 <li>899949: The emulator may fail to start with <code>-useaudio</code> on some environments. 419 <li>912619: Emulator console listens on non-local ports 5554-5584. 420 <li>917399: On Windows, running multiple emulator consoles can result in unexpected behavior when simulating incoming telephone calls. 421 </ul> 422 </p> 423 424 <h3>Known Issues</h3> 425 426 <p>Unless otherwise noted, Known Issues from m3-rc22a also apply to m3-rc37a.</p> 427 428 429 430 431 <a name="m3-rc22a"></a> 432 <h2>Version m3-rc22a</h2> 433 434 <p>Version m3-rc22a and ADT 0.3.1 were released on November 16, 2007.</p> 435 436 <h3>Resolved Issues</h3> 437 438 <h4>920067</h4> 439 <p>The New Android Project wizard provided by ADT 0.3.1 now properly displays error messages when used with Eclipse 3.2 on Windows.</p> 440 441 <h4>920045</h4> 442 <p>The <code>AndroidManifest.xml</code> files generated by ADT 0.3.1 now include the XML element required for displaying the associated app in the "Applications" menu. If you have applications created with ADT 0.3.0, simply ensure that your <code>AndroidManifest.xml</code> file contains the following highlighted line:</p> 443 <pre> 444 ... 445 <intent-filter> 446 <action android:value="android.intent.action.MAIN" /> 447 <strong><category android:value="android.intent.category.LAUNCHER" /></strong> 448 </intent-filter> 449 ... 450 </pre> 451 452 <h4>920098</h4> 453 <p>ADT 0.3.1 is now compatible with Eclipse 3.4.</p> 454 455 <h4>920282</h4> 456 <p>Fixes a NullPointerException that is thrown in certain situations with the DDMS perspective in Eclipse.</p> 457 458 <h4>918637</h4> 459 <p>Address a keyboard lock-up issue when using <code>adb</code> on Mac OS X 10.4 and 10.5.</p> 460 461 <h3>Known Issues</h3> 462 463 <p>Unless otherwise noted, known issues from m3-rc20a also apply to m3-rc22a.</p> 464 465 <a name="m3-rc20a"></a> 466 467 <h2>Version m3-rc20a</h2> 468 <h3>Known Issues</h3> 469 470 <p>The following are known issues in m3-rc20a:</p> 471 472 <h4>778432 - <span style="font-weight: normal; font-size: 13px; font-style: italic">Resolved in <a href="#m5-rc14">m5</a></span></h4> 473 <p>In certain circumstances, icons for newly installed applications do not display as expected.</p> 474 475 <h4>890937 - <span style="font-weight: normal; font-size: 13px; font-style: italic">Resolved in <a href="#m3-rc37a">m3-rc37a</a></span></h4> 476 <p>The emulator currently does not support non-QWERTY keyboards.</p> 477 478 <h4>894618 - <span style="font-weight: normal; font-size: 13px; font-style: italic">Resolved in <a href="#m3-rc37a">m3-rc37a</a></span></h4> 479 <p>The adb shell command may fail to connect when used for the first time.</p> 480 481 <h4>896274 - <span style="font-weight: normal; font-size: 13px; font-style: italic">Resolved in <a href="#m5-rc14">m5</a></span></h4> 482 <p>On Windows, the emulator screen will sometimes show up off-screen when it is started. The workaround for this is to right-click on the emulator taskbar entry, select Move, and move the window using keyboard arrow keys</p> 483 484 <h4>899949 - <span style="font-weight: normal; font-size: 13px; font-style: italic">Resolved in <a href="#m3-rc37a">m3-rc37a</a></span></h4> 485 <p>The emulator may fail to start when using the <code>-useaudio</code> in some environments</p> 486 487 <h4>901122 - <span style="font-weight: normal; font-size: 13px; font-style: italic">Resolved in <a href="#m5-rc14">m5</a></span></h4> 488 <p>The focus ring shown in the browser may sometimes not properly wrap links.</p> 489 490 <h4>905242 - <span style="font-weight: normal; font-size: 13px; font-style: italic">Resolved in <a href="#m5-rc14">m5</a></span></h4> 491 <p>On Mac OS X 10.5, the Eclipse plugin's Run Dialog may sometimes fail to show the option to select the Android Launcher.</p> 492 493 <h4>905852 - <span style="font-weight: normal; font-size: 13px; font-style: italic">Resolved in <a href="#m5-rc14">m5</a></span></h4> 494 <p>On Mac OS X 10.5, adb will emit warnings about deprecated API use when first used.</p> 495 496 <h4>912168 - <span style="font-weight: normal; font-size: 13px; font-style: italic">Resolved in <a href="#m5-rc14">m5</a></span></h4> 497 <p>extremely rapid or prolonged scrolling in the Maps application or in a MapView will result in application errors.</p> 498 499 <h4>912619 - <span style="font-weight: normal; font-size: 13px; font-style: italic">Resolved in <a href="#m3-rc37a">m3-rc37a</a></span></h4> 500 <p>The emulator console listens for connections on ports 5554-5587. Future versions will only accept connections from localhost. It is recommend that you use a firewall to block external connections to those ports on your development machine.</p> 501 502 <h4>912849</h4> 503 <p>On Mac OS X 10.4, the emulator may hang if started in the background (i.e. <code>./emulator &</code>).</p> 504 505 <h4>914692</h4> 506 <p>On Mac OS X 10.5, the emulator will emit warnings about deprecated API use when started from the command line.</p> 507 508 <h4>917247 - <span style="font-weight: normal; font-size: 13px; font-style: italic">Resolved in <a href="#m5-rc14">m5</a></span></h4> 509 <p>The dmtracedump and traceview tools are not available in the SDK.</p> 510 511 <h4>917399 - <span style="font-weight: normal; font-size: 13px; font-style: italic">Resolved in <a href="#m3-rc37a">m3-rc37a</a></span></h4> 512 <p>On Windows, running multiple emulator consoles can result in unexpected behavior when simulating incoming telephone calls.</p> 513 514 <h4>917465 - <span style="font-weight: normal; font-size: 13px; font-style: italic">Resolved in <a href="#m5-rc14">m5</a></span></h4> 515 <p>Unanswered incoming calls placed from the emulator console, will result in an unfinished call UI if you press the call back button.</p> 516 517 <h4>917572 - <span style="font-weight: normal; font-size: 13px; font-style: italic">Resolved in <a href="#m5-rc14">m5</a></span></h4> 518 <p>Using activityCreator with the <code>--ide intellij</code> option creates IntelliJ scripts with incorrect documentation location specified. To correct, change value for the <code><JAVADOC></code> element in the generated .ipr file from <code>file://.../docs/framework</code> to <code>file://.../docs/reference</code>.</p> 519 520 <h4>917579</h4> 521 <p>On Ubuntu 7.10 (Gusty), the Eclipse package installed by the <code>apt-get install eclipse</code> command uses java-gcj by default. This configuration is not compatible with the Android Eclipse plugin (ADT) and will result in "Class not found" errors whenever you access an ADT feature.</p> 522 <p>The resolution for this issue is to install a Sun JDK</p> 523 <pre>sudo update-java-alternatives --jre java-1.5.0-sun</pre> 524 <p>and then configure Eclipse to use it by exporting the following environment variable:</p> 525 <pre>export JAVA_HOME=/usr/lib/jvm/java-1.5.0-sun</pre> 526 <p>or by adding following to your <code>.eclipse/eclipserc file</code>:</p> 527 <pre>JAVA_HOME=/usr/lib/jvm/java-1.5.0-sun</pre> 528 529
