blob: 0fa2d2b58d31b10a072ed3882c70617a1ad6d582 [file] [log] [blame]
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001page.title=SDK Release Notes
2@jd:body
3
Dirk Doughertyfe1f7892009-04-21 18:52:41 -07004<p>This document provides version-specific information about Android SDK
5releases. For the latest known issues, please ensure that you're viewing this
Dirk Dougherty3f9de8b2009-05-22 16:04:18 -07006page at <a href="http://developer.android.com/sdk/RELEASENOTES.html">http://developer.android.com/sdk/RELEASENOTES.html</a>.</p>
7
Dirk Dougherty4b508752009-07-16 08:51:33 -07008<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
11fixes, as described below, and a new application &mdash; an IME for Japanese
12text input. Also provides the same set of developer tools included in the
13previous 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
18Android-powered devices, includes fixes to the permissions-checking
19in certain areas of the framework. Specifically, the Android system
20now properly checks and enforces several existing permissions where it
21did not do so in the previous release. Because of these changes in
22enforcement, you are strongly encouraged to test your application
23against the new Android 1.5 system image included in this SDK, to ensure
24that it functions normally. </p>
25
26<p>In particular, if your application uses any of the system areas listed below,
27you should add the required permissions to the application's manifest and then
28test the areas of your code that depend on the permission-protected services.
29Even if you believe your application does not use the permissions-protected
30services, you should compile and test your application under the latest platform
31version to ensure that users will not encounter problems when using your
32application. </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
38android.hardware.camera), the <code>CAMERA</code> permission check is now
39properly enforced. </li>
40<li>When an application requests access to device audio capture (through
41android.media.MediaRecorder), the <code>RECORD_AUDIO</code> permission check is
42now properly enforced.</li>
43</ul>
44
45<p>For more information, see the issue described in the oCert advisory
46below:</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
54provides an updated com.google.android.maps external library that fixes compile
55errors related to certain classes such as GeoPoint. For information about the
56Google APIs add-on and the library it provides, see:
57
58<p style="margin-left:2em;"><a
59href="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
62Vendor ID in their add-ons.
63<li>The <code>android</code> tool provides a new command that scans SDK add-ons
64for their USB Vendor IDs and makes them available to adb (OS X and Linux
65versions of the SDK only). The command is <code>android update adb</code>. On
66Windows 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
68Magic devices. For other devices, contact the device manufacturer
69to obtain a USB driver, especially if you have an SDK add-on that defines
70a new USB Vendor ID.</li>
71<li>The telephony, sensor, and geo fix issues in the emulator are now
72fixed.</li>
73<li>When you use adb to uninstall an upgraded application, the Android system
74now properly restores any permissions that had already been granted to the
75previous (downgrade) version of the application</li>
76</ul>
77
Dirk Dougherty3f9de8b2009-05-22 16:04:18 -070078<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,
81Release 1, but provides an updated Android 1.5 system image that includes a
82security 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 Doughertyfe1f7892009-04-21 18:52:41 -070085
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
89you 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
94changes include: </p>
95
96 <ul>
97 <li>Multiple versions of the Android platform are included (Android 1.1,
98Android 1.5). The tools are updated to let you deploy your application
Elliott Hughes7f877062009-07-30 17:00:34 -070099on any platform in the SDK, which helps you ensure forward-compatibility and,
Dirk Doughertyfe1f7892009-04-21 18:52:41 -0700100if applicable, backward-compatibility.</li>
101 <li>Introduces <a href="{@docRoot}guide/developing/tools/avd.html">Android
102Virtual Devices</a> &mdash; (AVD) configurations of options that you
103run in the emulator to better model actual devices. Each AVD gets its
104own dedicated storage area, making it much easier to work with multiple emulators
105that are running concurrently.</li>
106 <li>Support for SDK add-ons, which extend the
107Android SDK to give you access to one or more external Android libraries and/or
108a customized (but compliant) system image that can run in the emulator. </li>
Dirk Dougherty1f8059f2009-05-07 11:15:03 -0700109 <li>The new Eclipse ADT plugin (version 0.9.x) offers new Wizards to let you
Elliott Hughes7f877062009-07-30 17:00:34 -0700110create projects targeted for specific Android configurations, generate XML
Dirk Doughertyfe1f7892009-04-21 18:52:41 -0700111resources (such as layouts, animations, and menus), generate alternate layouts,
112and 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
116exclude locale resources when building your APK from a single
117Android 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 &mdash; including
122bug fixes, features, and API changes &mdash; please read the Version Notes
123documents available at left. For a list of Android platforms included in this
124release, see the <a href="{@docRoot}sdk/1.5_r1/index.html">Download
125page</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
130to make a few changes to your development environment to migrate to the new SDK.
131Tools and documentation are provided to assist you. No changes to the source
132code of an existing application should be needed, provided that your application
133is not using Android internal structures or APIs.</p>
134
135<p>To ensure that your existing application will work properly on a device
136running the latest version of the Android platform, you are strongly encouraged
137to migrate the application to the new SDK, compile it using the platform
138matching the application's original API Level, and run it against the most
139current platform. </p>
140
141<p>If you're installing the Android SDK for the first time, please see
142the instructions in <a
143href="{@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
148Android SDK to give you access to one or more external Android libraries and/or
149a customized (but compliant) system image that can run in the emulator. The
150purpose of an SDK add-on is to give you a way to develop applications for a
151specific actual device (or family of devices) that extends the APIs available to
152Android applications through external libraries or system customizations. </p>
153
154<p>From the perspective of your Android development environment, an SDK add-on
155is similar to any of the Android platform targets included in the SDK &mdash; it
156includes an external library, a system image, as well as custom emulator skins
157and system properties. The add-on differs in that the Android platform it
158provides may include customized UI, resources, or behaviors, a different set of
159preinstalled applications, or other similar modifications.
160
161<p>The SDK includes a single SDK add-on &mdash; the Google APIs add-on. The
162Google APIs add-on gives your application access to the com.google.android.maps
163external library that is included on many (if not most) Android-powered devices.
164The Google APIs add-on also includes a {@link android.location.Geocoder Geocoder}
165backend service implementation. For more information, see the "Maps External
166Library" 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
171one of several system targets, then run it in the emulator on top of any
172compatible 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
176one or more external libraries and/or a customized (but compliant) system image
177that can run in the emulator.
178</ul>
179
180<p>A new tool called "android" lets you discover what targets and AVDs are
181available to use.</p>
182
183<p>For more information about AVDs, see <a
184href="{@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
191included in the standard Android library and system image. In the Android 1.5
192SDK, that is not the case. The Android 1.5 library and system image do not
193include the Maps external library (com.google.android.maps). However, the Maps
194external library is available as part of the Google APIs add-on for the Android
195SDK, downloadable from this location: </p>
196
197<p style="margin-left:2em;"><a
198href="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">
205Obtaining 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
210Android-powered device (such as the T-Mobile G1), you need an appropriate USB
211driver. For your convenience, the Windows version of the Android SDK includes
212these 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>&lt;SDK&gt;/usb_driver</code> directory. For details and
221installation instructions, see <a
222href="{@docRoot}guide/developing/device.html#setting-up">Setting Up a
223Device 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
231android.media.SoundPool}</li>
232<li>{@link android.webkit.WebView} objects no longer automatically save
233thumbnails. The {@link android.webkit.WebView#capturePicture() capturePicture()}
234method 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
243emulator on the Android 1.5 system image, you may experience problems. Your
244application may generate ANR messages or crash when using the sensors. The
245problem 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
252the Zilog Z80 processor architecture.</li>
253</ul>
254
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800255
256<h2 id="1.1_r1">Android 1.1 SDK, Release 1</h2>
257
Dirk Doughertyfe1f7892009-04-21 18:52:41 -0700258<p>This SDK provides the development tools and Android system image you need to
259create applications for Android-powered devices. Applications developed on this
260SDK will be compatible with mobile devices running the Android 1.1 platform.
261</p>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800262
Dirk Doughertyfe1f7892009-04-21 18:52:41 -0700263<p>This release provides an updated system image (Android 1.1), updated
264documentation, and the same set of development tools provided in the Android 1.0
265r2 SDK. The updated system image includes bug fixes and some smaller features,
266as well as a few minor API changes from the 1.0 version. </p>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800267
Dirk Doughertyfe1f7892009-04-21 18:52:41 -0700268<p>For details about the Android 1.1 system image included in the SDK &mdash;
269including bug fixes, features, and API changes &mdash; please read the <a
270href="{@docRoot}sdk/android-1.1.html">Android 1.1 Version Notes</a>.</p>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800271
272<h3>App Versioning for Android 1.1</h3>
273
Dirk Doughertyfe1f7892009-04-21 18:52:41 -0700274<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,
276please note that you <strong>must</strong> set the the
277<code>android:minSdkVersion</code> attribute in the application's manifest to
278the API Level of Android 1.1 &mdash; "2".</p>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800279
Dirk Doughertyfe1f7892009-04-21 18:52:41 -0700280<p>Specifically, you specify the <code>android:minSdkVersion</code> attribute in
281a <code>&lt;uses-sdk&gt;</code> element as a child of
282<code>&lt;manifest&gt;</code> in the manifest file. When set, the attribute
283looks like this: </p>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800284
285<pre><code>&lt;manifest&gt;
286 ...
Dirk Dougherty1432cd82009-05-01 10:02:17 -0700287 &lt;uses-sdk android:minSdkVersion="2" /&gt;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800288 ...
289&lt;/manifest&gt;</code>
290</pre>
291
Dirk Doughertyfe1f7892009-04-21 18:52:41 -0700292<p>By setting <code>android:minSdkVersion</code> in this way, you ensure that
293users will only be able to install your application if their devices are running
294the Android 1.1 platform. In turn, this ensures that your application will
295function properly on their devices, especially if it uses APIs introduced in
296Android 1.1. </p>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800297
Dirk Doughertyfe1f7892009-04-21 18:52:41 -0700298<p>If your application uses APIs introduced in Android 1.1 but does not declare
Dirk Dougherty1432cd82009-05-01 10:02:17 -0700299<code>&lt;uses-sdk android:minSdkVersion="2" /&gt;</code>, then it will run properly on
Dirk Doughertyfe1f7892009-04-21 18:52:41 -0700300Android 1.1 devices but <em>not</em> on Android 1.0 devices. </p>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800301
Dirk Doughertyfe1f7892009-04-21 18:52:41 -0700302<p>If your application does not use any new APIs introduced in Android 1.1, you
Dirk Dougherty1432cd82009-05-01 10:02:17 -0700303can indicate Android 1.0 compatibility by removing <code>android:minSdkVersion</code> or
Dirk Doughertyfe1f7892009-04-21 18:52:41 -0700304setting the attribute to "1". However, before publishing your application, you
305must 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
307properly for Android 1.0 devices. You should test the application against system
308images corresponding to the API Levels that the application is designed to be
309compatible with.</p>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800310
Dirk Doughertyfe1f7892009-04-21 18:52:41 -0700311<p>If you are sure your application is not using Android 1.1 APIs and has no
312need to use them, you might find it easier to keep working in the Android 1.0
313SDK, rather than migrating to the Android 1.1 SDK and having to do additional
314testing.</p>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800315
316
317<h3>ADT Plugin Compatibility</h3>
318
319<p>For this version of the SDK &mdash; Android 1.1 SDK, Release 1
320&mdash; the compatible version of the Android Development Tools (ADT)
321Plugin for Eclipse is <strong>0.8.0</strong>. If you are using a
322previous version of ADT, you should update to the latest version for use
323with 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
325the 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
330changes to your application are needed. You may want to wipe application
331user data (emulator option <code>-wipe-data</code>) when running your
332application 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
335the instructions in <a
Dirk Doughertyfe1f7892009-04-21 18:52:41 -0700336href="{@docRoot}sdk/1.5_r1/installing.html">Installing the SDK</a>.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800337
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
343easily integrate Google Maps into your application. Before you can
344access the maps data, you will need to register with the Google Maps
345service and receive a Maps API Key, which you then add to your MapView
346for authentication to the server.</p>
347
348<p>Developers should note that the registration service for MapView is now
349active and Google Maps is actively enforcing the Maps API Key requirement.
350For information about how to register for a Maps API Key, see
Dirk Dougherty1432cd82009-05-01 10:02:17 -0700351<a href="http://code.google.com/android/add-ons/google-apis/mapkey.html">
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800352Obtaining 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
357Android-powered device (such as the T-Mobile G1), you need an appropriate USB
358driver. For your convenience, the Windows version of the Android SDK includes
359these 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>&lt;SDK&gt;/usb_driver</code> directory. For details and
368installation instructions, see <a
369href="{@docRoot}guide/developing/device.html#setting-up">Setting Up a
370Device 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 &lt;android&gt;/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
385classes, you can do so. However, you need to set up a custom JUnit configuration
386before your tests will run properly. For detailed information about how to set
387up the JUnit configuration, see the troubleshooting topic <a
388href="{@docRoot}guide/appendix/faq/troubleshooting.html#addjunit">Running a Junit test class
389in 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
397emulator started with the command-line option <code>-http-proxy</code>. </li>
398<li>On the OSX platform, if you manually remove the ~/.android directory
399using <code>rm -rf ~/.android</code>, then try to run
400the emulator, it crashes. This happens because the emulator fails to create
401a new .android directory before attempting to create the child SDK1.0 directory.
402To work around this issue, manually create a new .android directory using
403<code>mkdir ~/.android</code>, then run the emulator. The emulator
404creates the SDK1.0 directory and starts normally. </li>
405<li>We regret to inform developers that Android 1.1 will not include support
406for ARCNet network interfaces.</li>
407<li>The final set of Intent patterns honored by Android 1.0 has not yet been
408fully 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,
410in a given res/values/*.xml, using the form in the Android Resources pane.
411If you add more than ten, the Android Resources pane will not display the
412attributes fields for the additional resource entries. To work around this
413problem, you can close the file in the editor and open it again, or you
414can edit the resource entries in the XML text mode. </li>
415<li>The emulator's battery-control commands (<code>power &lt;option&gt</code>)
416are not working in this release.</li>
417</ul>
418
419
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800420<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.
423Applications developed on this SDK will be compatible with mobile devices
424running the Android 1.0 platform.</p>
425
426<p>This release includes mainly bug fixes, although some smaller features were
427added.</p>
428
429<h3>ADT Plugin Compatibility</h3>
430
431<p>For this release of the SDK, the compatible version of the Android
432Development Tools (ADT) Plugin for Eclipse is <strong>0.8.0</strong>. If you are
433using a previous version of ADT, you should update to the latest version for use
434with this SDK. For information about how to update your ADT plugin, see <a
Scott Main8a4c53a2009-04-24 13:41:44 -0700435href="{@docRoot}sdk/1.0_r2/upgrading.html">Upgrading the SDK</a>.</p>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800436
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 Main8a4c53a2009-04-24 13:41:44 -0700440instructions in <a href="{@docRoot}sdk/1.0_r2/installing.html">Installing the
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800441SDK</a>.
442
443<h3>Other Notes</h3>
444
Elliott Hughes7f877062009-07-30 17:00:34 -0700445<p><strong>T-Mobile G1 Compatibility</strong></p>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800446
Elliott Hughes7f877062009-07-30 17:00:34 -0700447<p>This version of the SDK has been tested for compatibility with the first
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800448Android-powered mobile device, the <a href="http://www.t-mobileg1.com">T-Mobile
449G1</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
454application. Before you can access the maps data, you will need to register with
455the Google Maps service and receive a Maps API Key, which you then add to your
456MapView for authentication to the server.</p>
457
458<p>Developers should note that the registration service for MapView is now
459active and Google Maps is actively enforcing the Maps API Key requirement. For
460information about how to register for a Maps API Key, see <a
Scott Main8a4c53a2009-04-24 13:41:44 -0700461href="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 Project9066cfe2009-03-03 19:31:44 -0800463
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
466Android-powered device (such as the T-Mobile G1), you need an appropriate USB
467driver. For your convenience, the Windows version of the Android SDK includes a
468USB driver that you can install, to let you develop on the device. The USB
469driver files are located in the <code>&lt;SDK&gt;/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
476missing from the previous SDK. </li>
477<li>The android.R.styleable class and its fields were removed from the public
478API, to better ensure forward-compatibility for applications. The constants
479declared in android.R.styleable were platform-specific and subject to arbitrary
480change across versions, so were not suitable for use by applications. You can
481still access the platform's styleable attributes from your resources or code. To
482do so, declare a custom resource element using a
483<code>&lt;declare-styleable&gt;</code> in your project's res/values/R.attrs
484file, then declare the attribute inside. For examples, see
485&lt;sdk&gt;/samples/ApiDemos/res/values/attrs.xml. For more information about
486custom resources, see <a
Scott Main8a4c53a2009-04-24 13:41:44 -0700487href="{@docRoot}guide/topics/resources/available-resources.html#customresources">Custom
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800488Layout Resources</a>. Note that the android.R.styleable documentation is still
489provided in the SDK, but only as a reference of the platform's styleable
490attributes for the various elements.</li>
491<li>The VM now properly ensures that private classes are not
492available to applications through reflection. If you were using reflection
493to access private classes in a previous release, you will now get a run-time
494error. </li>
495
496<li>The Settings and Email applications are now included in the SDK and
497available in the emulator.</li>
498<li>We regret to inform developers that SDK 1.0_r2 does not support MFM, RLL,
499or Winchester hard disk drives.</li>
500<li>In the emulator, the control key for enabling/disabling trackball mode
501is changed from Control-T to F6. You can also enter trackball mode temporarily
502using 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
506to 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 Main8a4c53a2009-04-24 13:41:44 -0700517<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 Project9066cfe2009-03-03 19:31:44 -0800518
519<h3>ADT Plugin Compatibility</h3>
520
Scott Main8a4c53a2009-04-24 13:41:44 -0700521<p>For this version of the SDK &mdash; Android 1.0 SDK, Release 1 &mdash; 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 Project9066cfe2009-03-03 19:31:44 -0800522
523<h3>Installation and Upgrade Notes</h3>
524
Scott Main8a4c53a2009-04-24 13:41:44 -0700525<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 Project9066cfe2009-03-03 19:31:44 -0800526
Scott Main8a4c53a2009-04-24 13:41:44 -0700527<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 Project9066cfe2009-03-03 19:31:44 -0800528
529<h3>Other Notes</h3>
530
531<p><strong>MapView API Key</strong></p>
532
Scott Main8a4c53a2009-04-24 13:41:44 -0700533<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 Project9066cfe2009-03-03 19:31:44 -0800534
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 Main8a4c53a2009-04-24 13:41:44 -0700537<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 Project9066cfe2009-03-03 19:31:44 -0800538
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 &lt;android&gt;/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 Project9066cfe2009-03-03 19:31:44 -0800565<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
570emulator 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
573dot-matrix printers.</li>
574<li>On the OSX platform, if you manually remove the ~/.android directory
575using <code>rm -rf ~/.android</code>, then try to run
576the emulator, it crashes. This happens because the emulator fails to create
577a new .android directory before attempting to create the child SDK1.0 directory.
578To work around this issue, manually create a new .android directory using
579<code>mkdir ~/.android</code>, then run the emulator. The emulator
580creates 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
582fully 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,
584in a given res/values/*.xml, using the form in the Android Resources pane.
585If you add more than ten, the Android Resources pane will not display the
586attributes fields for the additional resource entries. To work around this
587problem, you can close the file in the editor and open it again, or you
588can edit the resource entries in the XML text mode. </li>
589<li>The emulator's battery-control commands (<code>power &lt;option&gt</code>)
590are not working in this release.</li>
591
592</ul>
593