Merge branch 'readonly-p4-master'

sdk.rel.id=1

sdk.date=April 2009

sdk.win_download=

sdk.win_download=android-sdk-windows-1.5_r1.zip

sdk.win_bytes=

sdk.win_checksum=

sdk.mac_download=

sdk.mac_download=android-sdk-mac_x86-1.5_r1.zip

sdk.mac_bytes=

sdk.mac_checksum=

sdk.linux_download=

sdk.linux_download=android-sdk-linux_x86-1.5_r1.zip

sdk.linux_bytes=

sdk.linux_checksum=

page.title=Download Android SDK

page.title=Android 1.5 SDK, Release 1

@jd:body

<h2>SDK Contents</h2>

<h4>Development tools</h4>

<p>The SDK includes a variety of tools for developing and debugging application code and designing an application UI. You can read about the tools in the  

<p>The SDK includes a full set of tools for developing and debugging application code and designing an application UI. You can read about the tools in the  

<a href="{@docRoot}guide/developing/tools/index.html">Dev Guide</a> and access them in the <code>&lt;sdk&gt;/tools/</code> directory. 

<p>The tools package included in this SDK includes many updates from that provided in the previous SDK and requires you to migrate your applications to the new development environment. For details, see the <a href="upgrading">Upgrading the SDK</a> document.</p>

<p>The tools package in this SDK includes updates from those provided in the previous SDK. The tools also require a different project structure. To use the new tools, you need to migrate your applications to the new development environment. For more information about how to migrate, see <a href="{@docRoot}sdk/1.5_r1/upgrading.html">Upgrading the SDK</a>.

<h4 id="system_images">System Images</h4>

<p>For more information about the new tools features, see the <a href="{@docRoot}sdk/RELEASENOTES.html">SDK Release Notes</a>. 

<p>The Android system images listed below are included in this SDK. For more information about a system image &mdash; features, applications included, localizations, API changes, and so on &mdash; see its Version Notes. </p>

<h4 id="system_images">Android Platforms</h4>

<p>This SDK includes multiple Android platform versions that you use to develop applications. For each version, both a fully compliant Android library and system image are provided. The table below lists the platform versions included in this SDK. For more information about a platform version &mdash; features, applications included, localizations, API changes, and so on &mdash; see its Version Notes. </p>

<table style="margin-right:1em;" width="80%">

<tr>

<th><nobr>System Image</nobr></th><th><nobr>API Level</nobr></th><th>Notes</th><th>Description</th>

<th><nobr>Platform</nobr></th><th><nobr>API Level</nobr></th><th>Notes</th><th>Description</th>

</tr>

<tr>

<td width="5%"><nobr>Android 1.5</nobr></td>

<td  width="5%">3</td>

<td  width="5%"><nobr><a href="{@docRoot}sdk/android-1.5.html">Version Notes</a></nobr></td>

<td>Includes a set of standard development applications. </td>

<td>Includes a standard Android 1.5 library and system image with a set of development applications. Does not include any external libraries (such as the Maps external library).</td>

</tr>

<tr>

<td width="5%"><nobr>Android 1.1</nobr></td>

<td  width="5%">2</td>

<td  width="5%"><nobr><a href="{@docRoot}sdk/android-1.1.html">Version Notes</a></nobr></td>

<td>Includes a set of standard development applications. </td>

<td>Includes a compliant Android 1.1 library and system image with a set of development applications. Also includes the Maps external library (due to legacy build system issues).</a>

external library. </td>

</tr>

</table>

<h4 id="system_images">SDK Add-Ons</h4>

<p>An SDK add-on provides a development environment for an Android external library or a customized (but fully compliant) Android system image. This SDK includes the SDK add-on listed below. The Android system API Level required by the add-on is noted.</p>

<table style="margin-right:1em;" width="80%">

<tr>

<th><nobr>Add-On</nobr></th><th><nobr>API Level</nobr></th><th>Notes</th><th>Description</th>

</tr>

<tr>

<td width="5%"><nobr>Google APIs</nobr></td>

<td  width="5%">3</td>

<td  width="5%">&nbsp;</td>

<td>Includes the com.google.android.maps external library, a compliant 

system image, a {@link android.location.Geocoder Geocoder}

backend service implementation, documentation, and sample code. </td>

</tr>

</table>

<p>You can look at a variety of tutorials and samples in the <a href="{@docRoot}guide/samples/index.html">Dev Guide</a> and access the sample code itself

in the <code>&lt;sdk&gt;/platforms/android-1.5/samples/</code> directory of the SDK package. Note the new location &mdash; the SDK now includes multiple platform versions that you can develop against and each has its own sample code directory. </p>

<!-- 

<h4>Documentation</h4>

<p>The SDK package includes a full set of local documentation. To view it, open the <code>&lt;sdk&gt;/documentation.html</code> file in a web browser. If you are developing in an IDE such as Eclipse, you can also view the reference documentation directly in the IDE. </p>

<p>The most current documentation is always available on the Android Developers site:</p>

<p style="margin-left:2em;"><a href="http://developer.android.com/index.html">http://developer.android.com/</a></p>

-->

page.title=SDK Release Notes

@jd:body

<p>This document provides version-specific information about Android SDK releases. For the latest known issues, please ensure that you're viewing this page at: <a href="http://developer.android.com/sdk/RELEASENOTES.html">http://developer.android.com/sdk/RELEASENOTES.html</a>.</p>

<p>This document provides version-specific information about Android SDK

releases. For the latest known issues, please ensure that you're viewing this

page at: 

<a href="http://developer.android.com/sdk/RELEASENOTES.html">http://developer.android.com/sdk/RELEASENOTES.html</a>.</p>

<h2 id="1.5_r1">Android 1.5 SDK, Release 1</h2>

<p>This SDK provides updates to the development tools and Android system that

you use to create applications for compliant Android-powered devices. </p>

<h3>Release Overview</h3>

<p>This SDK release includes many new features for developers. Highlights of the

changes include: </p>

  <ul>

    <li>Multiple versions of the Android platform are included (Android 1.1,

Android 1.5). The tools are updated to let you deploy your application

on any platform in the SDK, which helps you ensure forward-compitility and, 

if applicable, backward-compatibility.</li>

    <li>Introduces <a href="{@docRoot}guide/developing/tools/avd.html">Android

Virtual Devices</a> &mdash; (AVD) configurations of options that you

run in the emulator to better model actual devices. Each AVD gets its

own dedicated storage area, making it much easier to work with multiple emulators 

that are running concurrently.</li>

    <li>Support for SDK add-ons, which extend the

Android SDK to give you access to one or more external Android libraries and/or

a customized (but compliant) system image that can run in the emulator. </li>

    <li>The new Eclipse ADT plugin (version 0.9.0) offers new Wizards to let you

create projects targetted for specific Android configurations, generate XML

resources (such as layouts, animations, and menus), generate alternate layouts,

and export and sign your application for publishing.</li>

    <li>Improved JUnit support in ADT</li>

    <li>Easier profiling of performance</li>

    <li>Easier management of localized applications. You can now include or

exclude locale resources when building your APK from a single

Android project.</li>

    <li>A new tool called "android" replaces the activitycreator script.</li>

  </ul>

<p>For details about the Android platforms included in the SDK &mdash; including

bug fixes, features, and API changes — please read the Version Notes

documents available at left. For a list of Android platforms included in this

release, see the <a href="{@docRoot}sdk/1.5_r1/index.html">Download

page</a>.</p>

<h3>Installation and Upgrade Notes</h3>

<p>If you've been developing an application using an Android 1.1 SDK, you need

to make a few changes to your development environment to migrate to the new SDK.

Tools and documentation are provided to assist you. No changes to the source

code of an existing application should be needed, provided that your application

is not using Android internal structures or APIs.</p>

<p>To ensure that your existing application will work properly on a device

running the latest version of the Android platform, you are strongly encouraged

to migrate the application to the new SDK, compile it using the platform

matching the application's original API Level, and run it against the most

current platform. </p>

<p>If you're installing the Android SDK for the first time, please see

the instructions in <a

href="{@docRoot}sdk/1.5_r1/installing.html">Installing the SDK</a>.

<h3>SDK Add-Ons</h3>

<p>This version of the SDK introduces support for SDK add-ons, which extend the

Android SDK to give you access to one or more external Android libraries and/or

a customized (but compliant) system image that can run in the emulator. The

purpose of an SDK add-on is to give you a way to develop applications for a

specific actual device (or family of devices) that extends the APIs available to

Android applications through external libraries or system customizations. </p>

<p>From the perspective of your Android development environment, an SDK add-on

is similar to any of the Android platform targets included in the SDK — it

includes an external library, a system image, as well as custom emulator skins

and system properties. The add-on differs in that the Android platform it

provides may include customized UI, resources, or behaviors, a different set of

preinstalled applications, or other similar modifications. 

<p>The SDK includes a single SDK add-on &mdash; the Google APIs add-on. The

Google APIs add-on gives your application access to the com.google.android.maps

external library that is included on many (if not most) Android-powered devices. 

The Google APIs add-on also includes a {@link android.location.Geocoder Geocoder}

backend service implementation. For more information, see the "Maps External 

Library" section below. </p>

<h3>Android Virtual Devices (AVDs)</h3>

<p>The SDK now gives you the capability to compile an application against any

one of several system targets, then run it in the emulator on top of any

compatible system image. There are two types of targets:</p>

<ul>

<li>Targets that represent core Android platform versions. </li>

<li>Targets that are SDK add-ons, which typically provide application access to

one or more external libraries and/or a customized (but compliant) system image

that can run in the emulator. 

</ul>

<p>A new tool called "android" lets you discover what targets and AVDs are

available to use.</p>

<p>For more information about AVDs, see <a

href="{@docRoot}guide/developing/tools/avd.html">Android Virtual Devices</a>

<h3>Other Notes</h3>

<p><strong>Maps External Library</strong></p>

<p>In previous versions of the SDK, the com.google.android.maps package was

included in the standard Android library and system image. In the Android 1.5

SDK, that is not the case. The Android 1.5 library and system image do not

include the Maps external library (com.google.android.maps). However, the Maps

external library is available as part of the Google APIs add-on for the Android

SDK, downloadable from this location: </p>

<p style="margin-left:2em;"><a

href="http://code.google.com/android/add-ons/google-apis">http://code.google.com

/android/add-ons/google-apis</a> </p>

<p>For your convenience, the Google APIs add-on is included in the SDK. </p>

<p>For information about how to register for a Maps API Key, see 

<a href="http://code.google.com/android/add-ons/google-apis/mapkey.html">

Obtaining a Maps API Key</a>.</p>

<p><strong>USB Drivers for Windows</strong></p>

<p>If you are 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

these USB drivers that you can install, to let you develop on the device:</p>

<ul>

<li>USB driver for 32-bit XP and Vista</li>

<li>USB driver for 64-bit Vista only</li>

</ul>

<p>The USB driver files are located in the

<code>&lt;SDK&gt;/usb_driver</code> directory. For details and

installation instructions, see <a

href="{@docRoot}guide/developing/device.html#setting-up">Setting Up a

Device for Development</a>.</p>

</p>

<h3>Resolved Issues, Changes</h3>

<p><strong>Media</strong></p>

<ul>

<li>Updated documentation for {@link android.media.SoundPool

android.media.SoundPool}</li>

<li>{@link android.webkit.WebView} objects no longer automatically save

thumbnails. The {@link android.webkit.WebView#capturePicture() capturePicture()}

method will need to be called manually.</li>

</ul>

<h3>Known Issues</h3>

<p><strong>Sensor problems in Emulator</strong></p>

<ul>

<li>If your application uses the Sensor API and you are running it in the

emulator on the Android 1.5 system image, you may experience problems. Your

application may generate ANR messages or crash when using the sensors. The

problem is being investigated.</li>

</ul>

<p><strong>Other</strong></p>

<ul>

<li>We regret to inform developers that Android 1.5 will not include support for

the Zilog Z80 processor architecture.</li>

</ul>

<h2 id="1.1_r1">Android 1.1 SDK, Release 1</h2>

<p>This SDK provides the development tools and Android system image you need to create applications for Android-powered devices. Applications developed on this SDK will be compatible with mobile devices running the Android 1.1 platform. </p>

<p>This SDK provides the development tools and Android system image you need to

create applications for Android-powered devices. Applications developed on this

SDK will be compatible with mobile devices running the Android 1.1 platform.

</p>

<p>This release provides an updated system image (Android 1.1), updated documentation, and the same set of development tools provided in the Android 1.0 r2 SDK. The updated system image includes bug fixes and some smaller features, as well as a few minor API changes from the 1.0 version. </p>

<p>This release provides an updated system image (Android 1.1), updated

documentation, and the same set of development tools provided in the Android 1.0

r2 SDK. The updated system image includes bug fixes and some smaller features,

as well as a few minor API changes from the 1.0 version. </p>

<p>For details about the Android 1.1 system image included in the SDK &mdash; including bug fixes, features, and API changes &mdash; please read the <a href="{@docRoot}sdk/android-1.1.html">Android 1.1 Version Notes</a>.</p>

<p>For details about the Android 1.1 system image included in the SDK &mdash;

including bug fixes, features, and API changes &mdash; please read the <a

href="{@docRoot}sdk/android-1.1.html">Android 1.1 Version Notes</a>.</p>

<h3>App Versioning for Android 1.1</h3>

<p>If you are using this SDK to build an application that is compatible <em>only</em> with Android-powered devices running the Android 1.1 platform, please note that you <strong>must</strong> set the the <code>android:minSdkVersion</code> attribute in the application's manifest to the API Level of Android 1.1 &mdash; "2".</p>

<p>If you are using this SDK to build an application that is compatible

<em>only</em> with Android-powered devices running the Android 1.1 platform,

please note that you <strong>must</strong> set the the

<code>android:minSdkVersion</code> attribute in the application's manifest to

the API Level of Android 1.1 &mdash; "2".</p>

<p>Specifically, you specify the <code>android:minSdkVersion</code> attribute in a <code>&lt;uses-sdk&gt;</code> element as a child of <code>&lt;manifest&gt;</code> in the manifest file. When set, the attribute looks like this: </p>

<p>Specifically, you specify the <code>android:minSdkVersion</code> attribute in

a <code>&lt;uses-sdk&gt;</code> element as a child of

<code>&lt;manifest&gt;</code> in the manifest file. When set, the attribute

looks like this: </p>

<pre><code>&lt;manifest&gt;

  ...

&lt;/manifest&gt;</code>

</pre>

<p>By setting <code>android:minSdkVersion</code> in this way, you ensure that users will only be able to install your application if their devices are running the Android 1.1 platform. In turn, this ensures that your application will function properly on their devices, especially if it uses APIs introduced in Android 1.1. </p>

<p>By setting <code>android:minSdkVersion</code> in this way, you ensure that

users will only be able to install your application if their devices are running

the Android 1.1 platform. In turn, this ensures that your application will

function properly on their devices, especially if it uses APIs introduced in

Android 1.1. </p>

<p>If your application uses APIs introduced in Android 1.1 but does not declare <code>&lt;uses-sdk minSdkVersion="2" /&gt;</code>, then it will run properly on Android 1.1 devices but <em>not</em> on Android 1.0 devices. </p>

<p>If your application uses APIs introduced in Android 1.1 but does not declare

<code>&lt;uses-sdk minSdkVersion="2" /&gt;</code>, then it will run properly on

Android 1.1 devices but <em>not</em> on Android 1.0 devices. </p>

<p>If your application does not use any new APIs introduced in Android 1.1, you can indicate Android 1.0 compatibility by removing <code>minSdkVersion</code> or setting the attribute to "1". However, before publishing your application, you must make sure to compile your application against the Android 1.0 system image (available in the Android 1.0 SDK), to ensure that it builds and functions properly for Android 1.0 devices. You should test the application against system images corresponding to the API Levels that the application is designed to be compatible with.</p>

<p>If your application does not use any new APIs introduced in Android 1.1, you

can indicate Android 1.0 compatibility by removing <code>minSdkVersion</code> or

setting the attribute to "1". However, before publishing your application, you

must make sure to compile your application against the Android 1.0 system image

(available in the Android 1.0 SDK), to ensure that it builds and functions

properly for Android 1.0 devices. You should test the application against system

images corresponding to the API Levels that the application is designed to be

compatible with.</p>

<p>If you are sure your application is not using Android 1.1 APIs and has no need to use them, you might find it easier to keep working in the Android 1.0 SDK, rather than migrating to the Android 1.1 SDK and having to do additional testing.</p>

<p>If you are sure your application is not using Android 1.1 APIs and has no

need to use them, you might find it easier to keep working in the Android 1.0

SDK, rather than migrating to the Android 1.1 SDK and having to do additional

testing.</p>

<h3>ADT Plugin Compatibility</h3>

<p>If you're installing the Android SDK for the first time, please see

the instructions in <a

href="{@docRoot}sdk/1.1_r1/installing.html">Installing the SDK</a>.

href="{@docRoot}sdk/1.5_r1/installing.html">Installing the SDK</a>.

<h3>Other Notes</h3>

</ul>

<h2 id="1.0_r2">Android 1.0 SDK, Release 2</h2>

<p>This SDK release includes the Android 1.0 platform and application API.

  </tr>

  <tr>

     <td style="background-color:#ffcccc;">0.8.0</td>

     <td style="background-color:#ffcccc;"><a href="http://dl-ssl.google.com/android/ADT-0.8.0.zip">ADT-0.8.0.zip</a></td>

     <td style="background-color:#ffcccc;">23&nbsp;September&nbsp;2008</td>

     <td style="background-color:#ffcccc;">Android&nbsp;1.1&nbsp;SDK,&nbsp;Release&nbsp;1<br />Android&nbsp;1.0&nbsp;SDK,&nbsp;Release&nbsp;1<br /></td>

     <td style="background-color:#ffcccc;">Required for users of Android 1.1 SDK, Release&nbsp;1 and Android&nbsp;1.0&nbsp;SDK,&nbsp;Release&nbsp;1<br /> </td>

     <td style="background-color:#ffcccc;">0.9.0</td>

     <td style="background-color:#ffcccc;"><a href="http://dl-ssl.google.com/android/ADT-0.9.0.zip">ADT-0.9.0.zip</a></td>

     <td style="background-color:#ffcccc;"><nobr>27 April 2009</nobr></td>

     <td style="background-color:#ffcccc;"><nobr>Android 1.5 SDK</td>

     <td style="background-color:#ffcccc;"><nobr>Required for users of Android 1.5 SDK (and later releases)<br /> </td>

  </tr>

  <tr>

     <td>0.8.0</td>

     <td><a href="http://dl-ssl.google.com/android/ADT-0.8.0.zip">ADT-0.8.0.zip</a></td>

     <td style="background-color:#ffcccc;"><nobr>23 September 2008</nobr></td>

     <td style="background-color:#ffcccc;"><nobr>Android 1.1 SDK<br/>Android 1.0 SDK<br/></td>

     <td style="background-color:#ffcccc;"><nobr>Required for users of Android 1.1 SDK and Android 1.0 SDK<br /> </td>

  </tr>

  <tr>

     <td>0.7.1</td>