Android 1.0 SDK, Release 2 - Release Notes

Android 1.0 SDK, Release 2

This SDK release includes 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.

This release includes mainly bug fixes, although some smaller features were added.

ADT Plugin Compatibility

For this release of the SDK, the compatible version of the Android Development Tools (ADT) Plugin for Eclipse is 0.8.0. 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 Upgrading the SDK.

Installation and Upgrade Notes

If you're installing the Android SDK for the first time, please see the instructions in Installing the SDK.

Other Notes

T-Mobile G1 Compatability

This version of the SDK has been tested for compatability with the first Android-powered mobile device, the T-Mobile G1.

MapView API Key

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.

Developers should note that the registration service for MapView is now active and Google Maps is actively enforcing the Maps API Key requirement. For information about how to register for a Maps API Key, see http://code. google.com/android/toolbox/apis/mapkey.html.

USB Driver for Windows

If you using Windows and want to develop or test your application on an Android-powered device (such as the T-Mobile G1), you need an appropriate USB driver. For your convenience, the Windows version of the Android SDK includes a USB driver that you can install, to let you develop on the device. The USB driver files are located in the /usb_driver directory.

Resolved Issues, Changes

• The android.jar in this SDK release now includes several classes that were missing from the previous SDK.
• The android.R.styleable class and its fields were removed from the public API, to better ensure forward-compatibility for applications. The constants declared in android.R.styleable were platform-specific and subject to arbitrary change across versions, so were not suitable for use by applications. You can still access the platform's styleable attributes from your resources or code. To do so, declare a custom resource element using a in your project's res/values/R.attrs file, then declare the attribute inside. For examples, see /samples/ApiDemos/res/values/attrs.xml. For more information about custom resources, see Custom Layout Resources. Note that the android.R.styleable documentation is still provided in the SDK, but only as a reference of the platform's styleable attributes for the various elements.
• The VM now properly ensures that private classes are not available to applications through reflection. If you were using reflection to access private classes in a previous release, you will now get a run-time error.
• The Settings and Email applications are now included in the SDK and available in the emulator.
• We regret to inform developers that SDK 1.0_r2 does not support MFM, RLL, or Winchester hard disk drives.
• In the emulator, the control key for enabling/disabling trackball mode is changed from Control-T to F6. You can also enter trackball mode temporarily using the Delete key. While the key is pressed, you can send trackball events.

Unless otherwise noted, Known Issues from the previous SDK release also apply to this release.