am 3f9de8b6: AI 149211: Doc updates for Android 1.5 SDK, r2. BUG=1790234
Merge commit '3f9de8b6caa3fe9119b363c64e79d13bb72aec76' into donut * commit '3f9de8b6caa3fe9119b363c64e79d13bb72aec76': AI 149211: Doc updates for Android 1.5 SDK, r2.
This commit is contained in:
committed by
The Android Open Source Project
commit
5b6a5cee4c
@@ -342,7 +342,7 @@ web_docs_sample_code_flags := \
|
||||
# most current Android platform version included in the SDK package.
|
||||
framework_docs_SDK_VERSION := 1.5
|
||||
# release version for SDK (ie "Release x")
|
||||
framework_docs_SDK_REL_ID := 1
|
||||
framework_docs_SDK_REL_ID := 2
|
||||
framework_docs_SDK_CURRENT_DIR := $(framework_docs_SDK_VERSION)_r$(framework_docs_SDK_REL_ID)
|
||||
|
||||
framework_docs_LOCAL_DROIDDOC_OPTIONS += \
|
||||
|
||||
@@ -38,15 +38,15 @@ manifest and resource files.</li>
|
||||
|
||||
<p>To begin developing Android applications in the Eclipse IDE with ADT, you first need to
|
||||
download the Eclipse IDE and then download and install the ADT plugin. To do so, follow the
|
||||
steps given in <a href="{@docRoot}sdk/1.5_r1/installing.html#installingplugin">Installing
|
||||
steps given in <a href="{@docRoot}sdk/{@sdkCurrent}/installing.html#installingplugin">Installing
|
||||
the ADT Plugin</a>.</p>
|
||||
|
||||
<p>If you are already developing applications using a version of ADT earlier than 0.9, make
|
||||
sure to upgrade to the latest version before continuing. See the guide to
|
||||
<a href="{@docRoot}sdk/1.5_r1/upgrading.html#UpdateAdt">Update Your Eclipse ADT Plugin</a>.</p>
|
||||
<a href="{@docRoot}sdk/{@sdkCurrent}/upgrading.html#UpdateAdt">Updating Your Eclipse ADT Plugin</a>.</p>
|
||||
|
||||
<p class="note"><strong>Note:</strong> This guide assumes you are using the latest version of
|
||||
the ADT plugin (0.9). While most of the information covered also applies to previous
|
||||
the ADT plugin. While most of the information covered also applies to previous
|
||||
versions, if you are using an older version, you may want to consult this document from
|
||||
the set of documentation included in your SDK package (instead of the online version).</p>
|
||||
|
||||
@@ -138,9 +138,9 @@ folders and files in your new project:</p>
|
||||
<p><em>Wait!</em> Before you can run your application on the Android Emulator,
|
||||
you <strong>must</strong> create an Android Virtual Device (AVD).
|
||||
An AVD is a configuration that specifies the Android platform to be used on the emulator.
|
||||
You can read more about AVDs in the <a href="{@docRoot}guide/developing/index.html#avd">Developing
|
||||
Overview</a>, but if you just want to get started, follow the simple guide below to create
|
||||
an AVD.</p>
|
||||
You can read more in the <a href="{@docRoot}guide/developing/tools/avd.html">Android Virtual
|
||||
Devices</a> document, but if you just want to get started, follow the simple guide below to
|
||||
create an AVD.</p>
|
||||
|
||||
<p>If you will be running your applications only on actual device hardware, you do not
|
||||
need an AVD — see
|
||||
|
||||
@@ -116,10 +116,10 @@ home=true
|
||||
'sdk': {
|
||||
'layout':"imgLeft",
|
||||
'icon':"sdk-small.png",
|
||||
'name':"SDK 1.5 r1",
|
||||
'name':"SDK 1.5 r2",
|
||||
'img':"sdk-large.png",
|
||||
'title':"Android 1.5 SDK r1",
|
||||
'desc': "<p>The final version of the Android 1.5 SDK is now available. It includes new APIs for Android 1.5, updated developer tools, multiple platform versions, and a Google APIs add-on.</p><p><a href='{@docRoot}sdk/1.5_r1/index.html'>Download Android 1.5 SDK</a></p>"
|
||||
'title':"Android 1.5 SDK",
|
||||
'desc': "<p>Android 1.5 SDK is now available. It includes new APIs for Android 1.5, updated developer tools, multiple platform versions, and a Google APIs add-on.</p><p><a href='{@docRoot}sdk/1.5_r2/index.html'>Download Android 1.5 SDK</a></p>"
|
||||
},
|
||||
|
||||
'mapskey': {
|
||||
|
||||
87
docs/html/sdk/1.5_r2/index.jd
Normal file
87
docs/html/sdk/1.5_r2/index.jd
Normal file
@@ -0,0 +1,87 @@
|
||||
sdk.version=1.5
|
||||
sdk.rel.id=2
|
||||
sdk.date=May 2009
|
||||
|
||||
sdk.win_download=android-sdk-windows-1.5_r2.zip
|
||||
sdk.win_bytes=178346828
|
||||
sdk.win_checksum=ba54ac6bda45921d442b74b6de6ff6a9
|
||||
|
||||
sdk.mac_download=android-sdk-mac_x86-1.5_r2.zip
|
||||
sdk.mac_bytes=169945128
|
||||
sdk.mac_checksum=f4e06a5194410243f213d0177713d6c9
|
||||
|
||||
sdk.linux_download=android-sdk-linux_x86-1.5_r2.zip
|
||||
sdk.linux_bytes=165035130
|
||||
sdk.linux_checksum=1d3c3d099e95a31c43a7b3e6ae307ed3
|
||||
|
||||
page.title=Android 1.5 SDK, Release 2
|
||||
@jd:body
|
||||
|
||||
<p>For more information on this SDK release, read the
|
||||
<a href="{@docRoot}sdk/RELEASENOTES.html#1.5_r2">Release Notes</a>.</p>
|
||||
|
||||
<h2>SDK Contents</h2>
|
||||
|
||||
<h4>Development tools</h4>
|
||||
|
||||
<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><sdk>/tools/</code> directory.
|
||||
|
||||
<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_r2/upgrading.html">Upgrading the SDK</a>.
|
||||
|
||||
<p>For more information about the new tools features, see the <a href="{@docRoot}sdk/RELEASENOTES.html">SDK Release Notes</a>.
|
||||
|
||||
<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 — features, applications included, localizations, API changes, and so on — see its Version Notes. </p>
|
||||
|
||||
<table style="margin-right:1em;" width="80%">
|
||||
<tr>
|
||||
<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 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 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).</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%"> </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>
|
||||
|
||||
<h4>Sample Code and Applications</h4>
|
||||
|
||||
<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><sdk>/platforms/android-1.5/samples/</code> directory of the SDK package. Note the new location — 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><sdk>/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>
|
||||
|
||||
332
docs/html/sdk/1.5_r2/installing.jd
Normal file
332
docs/html/sdk/1.5_r2/installing.jd
Normal file
@@ -0,0 +1,332 @@
|
||||
sdk.version=1.5
|
||||
sdk.rel.id=2
|
||||
sdk.date=April 2009
|
||||
|
||||
page.title=Installing the Android SDK
|
||||
@jd:body
|
||||
|
||||
|
||||
<p>This page describes how to install the Android SDK and set up your
|
||||
development environment. If you haven't downloaded the SDK, you can
|
||||
do so from the
|
||||
<a href="{@docRoot}sdk/1.5_r2/index.html">Download</a> page. Once you've downloaded
|
||||
the SDK, return here.</p>
|
||||
|
||||
<p>If you encounter any problems during installation, see the
|
||||
<a href="#installnotes">Installation Notes</a> at the bottom of
|
||||
this page.</p>
|
||||
|
||||
<h4 style="margin-top">Upgrading?</h4>
|
||||
<p>If you have already developed applications using an earlier version
|
||||
of the SDK, please read
|
||||
<a href="{@docRoot}sdk/1.5_r2/upgrading.html"><strong>Upgrading the
|
||||
SDK</strong></a></b>, instead.
|
||||
</p>
|
||||
|
||||
|
||||
<h2 id="setup">Preparing for Installation</h2>
|
||||
|
||||
<p>Before you begin, take a moment to confirm that your development machine meets the
|
||||
<a href="{@docRoot}sdk/1.5_r2/requirements.html">System Requirements</a>.
|
||||
</p>
|
||||
|
||||
<p>If you will be developing on Eclipse with the Android Development
|
||||
Tools (ADT) Plugin — the recommended path if you are new to
|
||||
Android — make sure that you have a suitable version of Eclipse
|
||||
installed on your computer (3.3 or newer). If you need to install Eclipse, you can
|
||||
download it from this location: </p>
|
||||
|
||||
<p style="margin-left:2em;"><a href=
|
||||
"http://www.eclipse.org/downloads/">http://www.eclipse.org/downloads/</a
|
||||
></p>
|
||||
|
||||
<p>A Java or RCP version of Eclipse is recommended. </p>
|
||||
|
||||
<h2 id="installingsdk">Installing the SDK</h2>
|
||||
|
||||
<p>After downloading the SDK, unpack the .zip archive to a suitable location on your machine.
|
||||
By default, the SDK files are unpacked into a directory named
|
||||
<code>android_sdk_<em><platform</em>>_<em><release></em></code>.
|
||||
The directory contains a local copy of the documentation (accessible by opening
|
||||
<code>documentation.html</code> in your browser) and the subdirectories
|
||||
<code>tools/</code>, <code>add-ons/</code>, <code>platforms/</code>, and others. Inside
|
||||
each subdirectory of <code>platforms/</code> you'll find <code>samples/</code>, which includes
|
||||
code samples that are specific to each version of the platform.</p>
|
||||
|
||||
<p>Make a note of the name and location of the unpacked SDK directory on your system — you
|
||||
will need to refer to the SDK directory later, when setting up the Android plugin or when
|
||||
using the SDK tools.</p>
|
||||
|
||||
<p>Optionally, you may want to add the location of the SDK's primary <code>tools</code> directory
|
||||
to your system PATH. The primary <code>tools/</code> directory is located at the root of the
|
||||
SDK folder. Adding <code>tools</code> to your path lets you run Android Debug Bridge (adb) and
|
||||
the other command line <a href="{@docRoot}guide/developing/tools/index.html">tools</a> without
|
||||
needing to supply the full path to the tools directory. </p>
|
||||
<ul>
|
||||
<li>On Linux, edit your <code>~/.bash_profile</code> or <code>~/.bashrc</code> file. Look
|
||||
for a line that sets the PATH environment variable and add the
|
||||
full path to the <code>tools/</code> directory to it. If you don't
|
||||
see a line setting the path, you can add one:</li>
|
||||
|
||||
<ul><code>export PATH=${PATH}:<em><your_sdk_dir></em>/tools</code></ul>
|
||||
|
||||
<li>On a Mac, look in your home directory for <code>.bash_profile</code> and
|
||||
proceed as for Linux. You can create the <code>.bash_profile</code> if
|
||||
you haven't already set one up on your machine. </li>
|
||||
|
||||
<li>On Windows, right-click on My Computer, and select Properties.
|
||||
Under the Advanced tab, hit the Environment Variables button, and in the
|
||||
dialog that comes up, double-click on Path (under System Variables). Add the full path to the
|
||||
<code>tools/</code> directory to the path. </li>
|
||||
</ul>
|
||||
|
||||
<p>Note that, if you update your SDK in the future, you
|
||||
should remember to update your PATH settings to point to the new location, if different.</p>
|
||||
|
||||
<p>If you will be using the Eclipse IDE as your development environment,
|
||||
the next section describes how to install the Android Development Tools plugin and set up Eclipse.
|
||||
If you choose not to use Eclipse, you can
|
||||
develop Android applications in an IDE of your choice and then compile, debug and deploy using
|
||||
the tools included in the SDK (skip to <a href="#next">Next Steps</a>).</p>
|
||||
|
||||
|
||||
<h2 id="installingplugin">Installing the ADT Plugin for Eclipse</h2>
|
||||
|
||||
<p>Android offers a custom plugin for the Eclipse IDE, called Android
|
||||
Development Tools (ADT), that is designed to give you a powerful,
|
||||
integrated environment in which to build Android applications. It
|
||||
extends the capabilites of Eclipse to let you quickly set up new Android
|
||||
projects, create an application UI, add components based on the Android
|
||||
Framework API, debug your applications using the Android SDK tools, and even export
|
||||
signed (or unsigned) APKs in order to distribute your application.</p>
|
||||
|
||||
<p>In general, using Eclipse with ADT is a highly recommended
|
||||
approach to Android development and is the fastest way to get started.
|
||||
(If you prefer to work in an IDE other than Eclipse,
|
||||
you do not need to install Eclipse or ADT, instead, you can directly
|
||||
use the SDK tools to build and debug your application.)</p>
|
||||
|
||||
<p>Once you have Eclipse installed, as described in <a href="#setup">Preparing for
|
||||
Installation</a>, follow the steps below to
|
||||
download the ADT plugin and install it in your respective Eclipse
|
||||
environment. </p>
|
||||
|
||||
<table style="font-size:100%">
|
||||
<tr><th>Eclipse 3.3 (Europa)</th><th>Eclipse 3.4 (Ganymede)</th></tr>
|
||||
<tr>
|
||||
<td width="45%">
|
||||
<!-- 3.3 steps -->
|
||||
<ol>
|
||||
<li>Start Eclipse, then select <strong>Help</strong> > <strong>Software Updates</strong>
|
||||
> <strong>Find and Install...</strong>. </li>
|
||||
<li>In the dialog that appears, select <strong>Search for new features to install</strong>
|
||||
and click <strong>Next</strong>. </li>
|
||||
<li>Click <strong>New Remote Site</strong>. </li>
|
||||
<li>In the resulting dialog box, enter a name for the remote site (e.g. "Android Plugin") and
|
||||
enter the URL:
|
||||
<pre>https://dl-ssl.google.com/android/eclipse/</pre>
|
||||
<p>If you have trouble aqcuiring the plugin, try using "http" in the URL,
|
||||
instead of "https" (https is preferred for security reasons).</p>
|
||||
<p>Click <strong>OK</strong>.</p> </li>
|
||||
<li>You should now see the new site added to the search list (and checked).
|
||||
Click <strong>Finish</strong>. </li>
|
||||
<li>In the subsequent Search Results dialog box, select the checkbox for the
|
||||
"Android Plugin".
|
||||
This will select the nested tools: "Android DDMS" and "Android Development Tools".
|
||||
Click <strong>Next</strong>.</li>
|
||||
<li>Read and accept the license agreement, then click <strong>Next</strong>. </li>
|
||||
<li>On the following Installation window, click <strong>Finish</strong>. </li>
|
||||
<li>The ADT plugin is not digitally signed. Accept the installation anyway
|
||||
by clicking <strong>Install All</strong>. </li>
|
||||
<li>Restart Eclipse. </li>
|
||||
</ol>
|
||||
|
||||
</td>
|
||||
<td>
|
||||
|
||||
<!-- 3.4 steps -->
|
||||
<ol>
|
||||
<li>Start Eclipse, then select <strong>Help</strong> > <strong>Software Updates...</strong>.</li>
|
||||
<li>In the dialog that appears, click the <strong>Available Software</strong> tab. </li>
|
||||
<li>Click <strong>Add Site...</strong> </li>
|
||||
<li>Enter the Location:
|
||||
<pre>https://dl-ssl.google.com/android/eclipse/</pre>
|
||||
<p>If you have trouble aqcuiring the plugin, try using "http" in the Location URL,
|
||||
instead of "https" (https is preferred for security reasons).</p>
|
||||
<p>Click <strong>OK</strong>.</p></li>
|
||||
<li>Back in the Available Software view, you should see the plugin listed by the URL,
|
||||
with "Developer Tools" nested within it. Select the checkbox next to
|
||||
Developer Tools and click <strong>Install...</strong></li>
|
||||
<li>On the subsequent Install window, "Android DDMS" and "Android Development Tools"
|
||||
should both be checked. Click <strong>Next</strong>. </li>
|
||||
<li>Read and accept the license agreement, then click <strong>Finish</strong>.</li>
|
||||
<li>Restart Eclipse. </li>
|
||||
</ol>
|
||||
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<p>Now modify your Eclipse preferences to point to the Android SDK directory:</p>
|
||||
<ol>
|
||||
<li>Select <strong>Window</strong> > <strong>Preferences...</strong> to open the Preferences
|
||||
panel (Mac: <strong>Eclipse</strong> > <strong>Preferences</strong>).</li>
|
||||
<li>Select <strong>Android</strong> from the left panel. </li>
|
||||
<li>For the <em>SDK Location</em> in the main panel, click <strong>Browse...</strong> and
|
||||
locate your downloaded SDK directory. </li>
|
||||
<li>Click <strong>Apply</strong>, then <strong>OK</strong>.</li>
|
||||
</ol>
|
||||
|
||||
<p>Done! If you haven't encountered any problems, then you're ready to
|
||||
begin developing Android applications. See the
|
||||
<a href="#next">Next Steps</a> section for suggestions on how to start. </p>
|
||||
|
||||
|
||||
<h3 id="troubleshooting">Troubleshooting ADT Installation</h3>
|
||||
<p>
|
||||
If you are having trouble downloading the ADT plugin after following the steps above, here are
|
||||
some suggestions: </p>
|
||||
|
||||
<ul>
|
||||
<li>If Eclipse can not find the remote update site containing the ADT plugin, try changing
|
||||
the remote site URL to use http, rather than https. That is, set the Location for the remote site to:
|
||||
<pre>http://dl-ssl.google.com/android/eclipse/</pre></li>
|
||||
<li>If you are behind a firewall (such as a corporate firewall), make
|
||||
sure that you have properly configured your proxy settings in Eclipse.
|
||||
In Eclipse 3.3/3.4, you can configure proxy information from the main
|
||||
Eclipse menu in <strong>Window</strong> (on Mac, <strong>Eclipse</strong>) >
|
||||
<strong>Preferences</strong> > <strong>General</strong> >
|
||||
<strong>Network Connections</strong>.</li>
|
||||
</ul>
|
||||
<p>
|
||||
If you are still unable to use Eclipse to download the ADT plugin as a remote update site, you
|
||||
can download the ADT zip file to your local machine and manually install the it:
|
||||
</p>
|
||||
<ol>
|
||||
<li><a href="{@docRoot}sdk/adt_download.html">Download the ADT zip file</a> (do not unpack it).</li>
|
||||
<li>Follow steps 1 and 2 in the default install instructions (above).</li>
|
||||
<li>In Eclipse 3.3, click <strong>New Archive Site...</strong>. <br/>
|
||||
In Eclipse 3.4, click <strong>Add Site...</strong>, then <strong>Archive...</strong></li>
|
||||
<li>Browse and select the downloaded zip file.</li>
|
||||
<li>Follow the remaining procedures, above, starting from steps 5.</li>
|
||||
</ol>
|
||||
<p>To update your plugin once you've installed using the zip file, you will have to
|
||||
follow these steps again instead of the default update instructions.</p>
|
||||
|
||||
<h4>Other install errors</h4>
|
||||
|
||||
<p>Note that there are features of ADT that require some optional
|
||||
Eclipse components (for example, WST). If you encounter an error when
|
||||
installing ADT, your Eclipse installion might not include these components.
|
||||
For information about how to quickly add the necessary components to your
|
||||
Eclipse installation, see the troubleshooting topic
|
||||
<a href="{@docRoot}guide/appendix/faq/troubleshooting.html#installeclipsecomponents">ADT
|
||||
Installation Error: "requires plug-in org.eclipse.wst.sse.ui"</a>.</p>
|
||||
|
||||
<h4>For Linux users</h4>
|
||||
<p>If you encounter this error when installing the ADT Plugin for Eclipse:
|
||||
<pre>
|
||||
An error occurred during provisioning.
|
||||
Cannot connect to keystore.
|
||||
JKS</pre>
|
||||
<p>
|
||||
...then your development machine lacks a suitable Java VM. Installing Sun
|
||||
Java 6 will resolve this issue and you can then reinstall the ADT
|
||||
Plugin.</p>
|
||||
|
||||
|
||||
<h2 id="next">Next Steps</h2>
|
||||
<p>Once you have completed installation, you are ready to
|
||||
begin developing applications. Here are a few ways you can get started: </p>
|
||||
|
||||
<p><strong>Learn about Android</strong></p>
|
||||
<ul>
|
||||
<li>Take a look at the <a href="{@docRoot}guide/index.html">Dev
|
||||
Guide</a> and the types of information it provides</li>
|
||||
<li>Read an introduction to Android as a platform in <a
|
||||
href="{@docRoot}guide/basics/what-is-android.html">What is
|
||||
Android?</a></li>
|
||||
<li>Learn about the Android framework and how applications run on it in
|
||||
<a href="{@docRoot}guide/topics/fundamentals.html">Application
|
||||
Fundamentals</a></li>
|
||||
<li>Take a look at the Android framework API specification in the <a
|
||||
href="{@docRoot}reference/packages.html">Reference</a> tab</li>
|
||||
</ul>
|
||||
|
||||
<p><strong>Explore the SDK</strong></p>
|
||||
<ul>
|
||||
<li>Get an overview of the <a
|
||||
href="{@docRoot}guide/developing/tools/index.html">development
|
||||
tools</a> that are available to you</li>
|
||||
<li>Read how to develop <a
|
||||
href="{@docRoot}guide/developing/eclipse-adt.html">in Eclipse/ADT</a> or
|
||||
<a href="{@docRoot}guide/developing/other-ide.html">in other IDEs</a>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<p><strong>Explore some code</strong></p>
|
||||
<ul>
|
||||
<li>Set up a <a href="{@docRoot}guide/tutorials/hello-world.html">Hello
|
||||
World application</a> (highly recommended, especially for Eclipse users)</li>
|
||||
<li>Follow the <a href="{@docRoot}guide/tutorials/notepad/index.html">
|
||||
Notepad Tutorial</a> to build a full Android application </li>
|
||||
<li>Create a new project for one of the other sample applications
|
||||
included in <code><em><sdk></em>/platforms/<em><platfrom></em>/samples</code>,
|
||||
then compile and run it in your development environment</li>
|
||||
</ul>
|
||||
|
||||
<p><strong>Visit the Android developer groups</strong></p>
|
||||
<ul>
|
||||
<li>Take a look at the <a
|
||||
href="{@docRoot}community/index.html">Community</a> tab to see a list of
|
||||
Android developers groups. In particular, you might want to look at the
|
||||
<a href="http://groups.google.com/group/android-developers">Android
|
||||
Developers</a> group to get a sense for what the Android developer
|
||||
community is like.</li>
|
||||
</ul>
|
||||
|
||||
|
||||
<h2 id="installnotes">Installation Notes</h2>
|
||||
|
||||
<h3>Ubuntu Linux Notes</h3>
|
||||
|
||||
<ul>
|
||||
<li>If you need help installing and configuring Java on your
|
||||
development machine, you might find these resources helpful:
|
||||
<ul>
|
||||
<li><a href="https://help.ubuntu.com/community/Java">https://help.ubuntu.com/community/Java </a></li>
|
||||
<li><a href="https://help.ubuntu.com/community/Java">https://help.ubuntu.com/community/JavaInstallation</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>Here are the steps to install Java and Eclipse, prior to installing
|
||||
the Android SDK and ADT Plugin.
|
||||
<ol>
|
||||
<li>If you are running a 64-bit distribution on your development
|
||||
machine, you need to install the <code>ia32-libs</code> package using
|
||||
<code>apt-get:</code>:
|
||||
<pre>apt-get install ia32-libs</pre>
|
||||
</li>
|
||||
<li>Next, install Java: <pre>apt-get install sun-java6-bin</pre></li>
|
||||
<li>The Ubuntu package manager does not currently offer an Eclipse 3.3
|
||||
version for download, so we recommend that you download Eclipse from
|
||||
eclipse.org (<a
|
||||
href="http://www.eclipse.org/downloads/">http://www.eclipse.org/
|
||||
downloads/</a>). A Java or RCP version of Eclipse is recommended.</li>
|
||||
<li>Follow the steps given in previous sections to install the SDK
|
||||
and the ADT plugin. </li>
|
||||
</ol>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<h3>Other Linux Notes</h3>
|
||||
|
||||
<ul>
|
||||
<li>If JDK is already installed on your development computer, please
|
||||
take a moment to make sure that it meets the version requirements listed
|
||||
in the <a href="{@docRoot}sdk/1.1_r1/requirements.html">System Requirements</a>.
|
||||
In particular, note that some Linux distributions may include JDK 1.4 or Gnu
|
||||
Compiler for Java, both of which are not supported for Android development.</li>
|
||||
</ul>
|
||||
|
||||
|
||||
|
||||
39
docs/html/sdk/1.5_r2/requirements.jd
Normal file
39
docs/html/sdk/1.5_r2/requirements.jd
Normal file
@@ -0,0 +1,39 @@
|
||||
page.title=System Requirements
|
||||
@jd:body
|
||||
|
||||
<p>The sections below describe the system and software requirements for developing Android applications using the Android SDK tools included in Android <?cs var:sdk.version ?> SDK, Release <?cs var:sdk.rel.id ?>. </p>
|
||||
|
||||
<h3>Supported Operating Systems</h3>
|
||||
<ul>
|
||||
<li>Windows XP (32-bit) or Vista (32- or 64-bit)</li>
|
||||
<li>Mac OS X 10.4.8 or later (x86 only)</li>
|
||||
<li>Linux (tested on Linux Ubuntu Dapper Drake)</li>
|
||||
</ul>
|
||||
|
||||
<h3>Supported Development Environments</h3>
|
||||
<ul>
|
||||
<li>Eclipse IDE
|
||||
<ul>
|
||||
<li><a href="http://www.eclipse.org/downloads/">Eclipse</a> 3.3 (Europa), 3.4 (Ganymede)
|
||||
<ul>
|
||||
<li>Recommended Eclipse IDE packages: Eclipse IDE for Java EE Developers, Eclipse IDE for Java Developers, Eclipse for RCP/Plug-in Developers</li>
|
||||
<li>Eclipse <a href="http://www.eclipse.org/jdt">JDT</a> plugin (included in most Eclipse IDE packages) </li>
|
||||
<li>Eclipse Classic IDE package is not supported.</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="http://java.sun.com/javase/downloads/index.jsp">JDK 5 or JDK 6</a> (JRE alone is not sufficient)</li>
|
||||
<li><a href="installing.html#installingplugin">Android Development Tools plugin</a> (optional)</li>
|
||||
<li><strong>Not</strong> compatible with Gnu Compiler for Java (gcj)</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>Other development environments or IDEs
|
||||
<ul>
|
||||
<li><a href="http://java.sun.com/javase/downloads/index.jsp">JDK 5 or JDK 6</a> (JRE alone is not sufficient)</li>
|
||||
<li><a href="http://ant.apache.org/">Apache Ant</a> 1.6.5 or later for Linux and Mac, 1.7 or later for Windows</li>
|
||||
<li><strong>Not</strong> compatible with Gnu Compiler for Java (gcj)</li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<p class="note"><strong>Note:</strong> If JDK is already installed on your development computer, please take a moment to make sure that it meets the version requirements listed above. In
|
||||
particular, note that some Linux distributions may include JDK 1.4 or Gnu Compiler for Java, both of which are not supported for Android development. </p>
|
||||
395
docs/html/sdk/1.5_r2/upgrading.jd
Normal file
395
docs/html/sdk/1.5_r2/upgrading.jd
Normal file
@@ -0,0 +1,395 @@
|
||||
page.title=Upgrading the SDK
|
||||
sdk.version=1.5_r2
|
||||
@jd:body
|
||||
|
||||
|
||||
<div id="qv-wrapper">
|
||||
<div id="qv">
|
||||
|
||||
<h2>Upgrading the SDK</h2>
|
||||
<ul>
|
||||
<li>The Android 1.5 SDK uses a new project structure and a new ADT plugin (ADT 0.9). </li>
|
||||
<li>To move existing projects into the SDK, you must make some minor changes in your
|
||||
development environment.</li>
|
||||
<li>The new ADT plugin (ADT 0.9) <em>is not compatible</em> with projects created in previous SDKs.</li>
|
||||
<li>You need to uninstall your existing ADT plugin, before installing ADT 0.9.</li>
|
||||
</ul>
|
||||
|
||||
<h2>In this document</h2>
|
||||
<ol>
|
||||
<li><a href="#Install">Install the SDK</a></li>
|
||||
<li><a href="#UpdateAdt">Update Your Eclipse ADT Plugin</a></li>
|
||||
<li><a href="#UpdateYourProjects">Update Your Projects</a>
|
||||
<ol>
|
||||
<li><a href="#EclipseUsers">Eclipse Users</a></li>
|
||||
<li><a href="#AntUsers">Ant Users</a></li>
|
||||
</ol>
|
||||
</li>
|
||||
<li><a href="#MigrateYourApplications">Migrate Your Applications</a>
|
||||
<ol><li><a href="#FutureProofYourApps">Future-proof your apps</a></li></ol>
|
||||
</li>
|
||||
</ol>
|
||||
|
||||
<h2>Migrating references</h2>
|
||||
<ol>
|
||||
<li><a href="{@docRoot}sdk/api_diff/3/changes.html">Android 1.5 API Differences</a></li>
|
||||
<li><a
|
||||
href="http://android-developers.blogspot.com/2009/04/future-proofing-your-apps.html">Future-Proofing
|
||||
Your Apps »</a></li>
|
||||
<li><a
|
||||
href="http://android-developers.blogspot.com/2009/04/ui-framework-changes-in-android-15.html">UI
|
||||
framework changes in Android 1.5 »</a></li>
|
||||
</ol>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<p>This document describes how to move your development environment and existing
|
||||
Android applications from an Android 1.0 or 1.1 SDK to the Android 1.5 SDK.
|
||||
If you are migrating applications from an SDK older than 1.0, please also read the upgrading
|
||||
document available in the Android 1.0 SDK package.</p>
|
||||
|
||||
<p>There are several compelling reasons to upgrade, such as new SDK tools
|
||||
that make developing more efficient and new APIs that allow you to expand the feature-set
|
||||
of your applications. However, even if you or your applications don't require these enhancements,
|
||||
it's important that you upgrade to ensure that your applications run properly on the
|
||||
Android 1.5 platform.</p>
|
||||
|
||||
<p>The Android 1.5 platform will soon be deployable to devices around the world.
|
||||
If you have already released Android applications to the public, you should
|
||||
test the forward-compatibility of your applications on the latest version of the platform
|
||||
as soon as possible. It's unlikely that you'll encounter breakage in your applications, but
|
||||
in the interest of maintaining the best user experience, you should take no risks.
|
||||
So, please install the new Android SDK and test your applications on Android 1.5.</p>
|
||||
|
||||
<p>For more information on new SDK features and system changes,
|
||||
see the <a href="{@docRoot}sdk/android-1.5.html">Android 1.5 Version Notes</a>.</p>
|
||||
|
||||
|
||||
<h2 id="Install">Install the SDK</h2>
|
||||
|
||||
<p>If you haven't yet downloaded the SDK, <a href="{@docRoot}sdk/1.5_r2/index.html">download from here</a>
|
||||
and unpack it into a safe location.</p>
|
||||
|
||||
<p><strong>Before you begin:</strong>
|
||||
If you had previously setup your PATH variable to point to the SDK tools directory,
|
||||
then you need to update it to point to the new SDK. For example, for a
|
||||
<code>.bashrc</code> or <code>.bash_profile</code> file:</p>
|
||||
<pre>export PATH=$PATH:<em><your_sdk_dir></em>/tools</pre>
|
||||
|
||||
<p>If you don't use Eclipse for development,
|
||||
skip to <a href="#updateYourProjects">Update Your Projects</a>.</p>
|
||||
|
||||
|
||||
<h2 id="UpdateAdt">Update Your Eclipse ADT Plugin</h2>
|
||||
|
||||
<p><em>If you installed ADT-0.9_pre with the early look 1.5 SDK, there have been
|
||||
additional changes, so please continue with this guide and update to the final ADT 0.9.</em></p>
|
||||
|
||||
<p>A new ADT plugin (version 0.9) is required for the Android 1.5 SDK.
|
||||
Because the component structure has been changed since Android 1.1,
|
||||
the Android 1.5 SDK does not work with ADT 0.8 (or older) and previously installed SDKs will not
|
||||
work with ADT 0.9. However, the Android 1.5 SDK includes an Android 1.1 SDK image that you
|
||||
can build against while using ADT 0.9. </p>
|
||||
|
||||
<p class="note">For information about using different system images (such as Android 1.1)
|
||||
while running this SDK, see Developing <a href="{@docRoot}guide/developing/eclipse-adt.html">
|
||||
In Eclipse, with ADT</a> or <a href="{@docRoot}guide/developing/other-ide.html">In
|
||||
Other IDEs</a>, as appropriate for your development environment.</p>
|
||||
|
||||
<p>In order to upgrade your Eclipse IDE to use the new 0.9 ADT, follow the steps below
|
||||
for your respective version of Eclipse.</p>
|
||||
|
||||
<h3 id="uninstallAdt">Uninstall your previous ADT plugin</h3>
|
||||
|
||||
<p>You must uninstall your existing ADT plugin (0.8 or older). If you do not uninstall it,
|
||||
you will get a conflict with the Android Editors when installing the new ADT.
|
||||
(If you have already installed ADT-0.9_pre with the early look 1.5 SDK, you can skip this
|
||||
uninstall procedure and continue to <a href="#installAdt">Install the 0.9 ADT plugin</a>).</p>
|
||||
|
||||
<table style="font-size:100%">
|
||||
<tr><th>Eclipse 3.3 (Europa)</th><th>Eclipse 3.4 (Ganymede)</th></tr>
|
||||
<tr>
|
||||
<td width="50%">
|
||||
<!-- 3.3 steps -->
|
||||
<ol>
|
||||
<li>Select <strong>Help</strong> > <strong>Software Updates</strong> >
|
||||
<strong>Manage Configuration</strong>. </li>
|
||||
<li>Expand the list in the left panel to reveal the installed tools.</li>
|
||||
<li>Right-click "Android Editors" and click <strong>Uninstall</strong>. Click <strong>OK</strong>
|
||||
to confirm.</li>
|
||||
<li>Restart Eclipse.
|
||||
<p>(Do not uninstall "Android Development Tools".)</p></li>
|
||||
</ol>
|
||||
</td>
|
||||
<td>
|
||||
<!-- 3.4 steps -->
|
||||
<ol>
|
||||
<li>Select <strong>Help</strong> > <strong>Software Updates</strong>.</li>
|
||||
<li>Select the <strong>Installed Software</strong> tab.</li>
|
||||
<li>Select "Android Editors". Click <strong>Uninstall</strong>.</li>
|
||||
<li>In the next window, be sure "Android Editors" is checked, then click <strong>Finish</strong>
|
||||
to uninstall.</li>
|
||||
<li>Restart Eclipse.
|
||||
<p>(Do not uninstall "Android Development Tools".)</p></li>
|
||||
</ol>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
|
||||
<h3 id="installAdt">Install the 0.9 ADT plugin</h3>
|
||||
|
||||
<p>Only install the new plugin once you've completed the procedure to
|
||||
<a href="#uninstallAdt">Uninstall your previous ADT plugin</a>.</p>
|
||||
|
||||
<table style="font-size:100%">
|
||||
<tr><th>Eclipse 3.3 (Europa)</th><th>Eclipse 3.4 (Ganymede)</th></tr>
|
||||
<tr>
|
||||
<td width="50%">
|
||||
<!-- 3.3 steps -->
|
||||
<ol>
|
||||
<li>Select <strong>Help</strong> > <strong>Software Updates</strong> >
|
||||
<strong>Find and Install</strong>. </li>
|
||||
<li>Select <strong>Search for new features to install</strong>.</li>
|
||||
<li>Select the Android plugin entry by checking the box next to it,
|
||||
then click <strong>Finish</strong>.
|
||||
<p>(Your original entry for the plugin should still be here. If not, see the guide
|
||||
to <a href="{@docRoot}sdk/1.5_r2/installing.html#installingplugin">Installing the ADT Plugin</a>.)
|
||||
</p></li>
|
||||
<li>In the results, expand the entry for the Android plugin and
|
||||
be sure that "Developer Tools" is checked, then click <strong>Next</strong>.
|
||||
(This will install "Android DDMS" and "Android Development Tools".)</li>
|
||||
<li>Read and accept the license agreement, then click <strong>Next</strong>.
|
||||
<li>In the next window, click <strong>Finish</strong> to start installation.</li>
|
||||
<li>The ADT plugin is not digitally signed. Accept the installation anyway by clicking
|
||||
<strong>Install All</strong>.</li>
|
||||
<li>Restart Eclipse.</li>
|
||||
</ol>
|
||||
</td>
|
||||
<td>
|
||||
<!-- 3.4 steps -->
|
||||
<ol>
|
||||
<li>Select <strong>Help</strong> > <strong>Software Updates</strong>.</li>
|
||||
<li>Select the <strong>Available Software</strong> tab.</li>
|
||||
<li>Expand the entry for the Andriod plugin (may be listed as the location URL)
|
||||
and select "Developer Tools" by checking the box next to it, then click
|
||||
<strong>Install</strong>.</li>
|
||||
<li>On the next window, "Android DDMS" and "Android Development Tools"
|
||||
should both be checked. Click <strong>Finish</strong>.</li>
|
||||
<li>Restart Eclipse.</li>
|
||||
</ol>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<p>If you encounter problems, ensure your ADT is fully uninstalled and then
|
||||
follow the guide to
|
||||
<a href="{@docRoot}sdk/1.5_r2/installing.html#installingplugin">Installing the ADT Plugin
|
||||
for Eclipse</a>.</p>
|
||||
|
||||
<h3 id="updateEclipsePrefs">Update your Eclipse SDK Preferences</h3>
|
||||
|
||||
<p>The last step is to update your Eclipse preferences to point to the new SDK directory:</p>
|
||||
<ol>
|
||||
<li>Select <strong>Window</strong> > <strong>Preferences</strong> to open the Preferences
|
||||
panel (Mac: <strong>Eclipse</strong> > <strong>Preferences</strong>).</li>
|
||||
<li>Select <strong>Android</strong> from the left panel.</li>
|
||||
<li>For the <em>SDK Location</em> in the main panel, click <strong>Browse</strong>
|
||||
and locate your SDK directory.</li>
|
||||
<li>Click <strong>Apply</strong>, then <strong>OK</strong>.</li>
|
||||
</ol>
|
||||
|
||||
|
||||
<h2 id="UpdateYourProjects">Update Your Projects</h2>
|
||||
|
||||
<p>You will now need to update any and all Android projects that you have
|
||||
developed using a previous version of the Android SDK.</p>
|
||||
|
||||
|
||||
<h3 id="EclipseUsers">Eclipse users</h3>
|
||||
|
||||
<p>If you use Eclipse to develop applications, use the following procedure to
|
||||
update each project:</p>
|
||||
|
||||
<ol>
|
||||
<li>Right-click on the individual project (in the Package Explorer)
|
||||
and select <strong>Properties</strong>.</li>
|
||||
<li>In the properties, open the Android panel and select a "build target" to compile
|
||||
against. This SDK offers the Android 1.1 and Android 1.5 platforms to choose from. When
|
||||
you are initially updating your projects to the new SDK, we recommend that you select a build
|
||||
target with the Android 1.1 platform. Click <strong>Apply</strong>, then
|
||||
<strong>OK</strong>.</li>
|
||||
</ol>
|
||||
|
||||
<p>The new plugin creates a <code>gen/</code> folder in your project, in which it puts the
|
||||
<code>R.java</code> file
|
||||
and all automatically generated AIDL java files. If you get an error such as
|
||||
<code>The type R is already defined</code>,
|
||||
then you probably need to delete your old <code>R.java</code> or your old auto-generated
|
||||
AIDL Java files in the <code>src/</code> folder.
|
||||
(This <em>does not</em> apply to your own hand-crafted parcelable AIDL java files.)</p>
|
||||
|
||||
<p>Note that, with the Android 1.5 SDK, there is a new process for running
|
||||
applications in the Android Emulator.
|
||||
Specifically, you must create an Android Virtual Device (AVD) before you can launch an instance
|
||||
of the Emulator. Before attempting to run your applications with the new SDK,
|
||||
please continue with the section below to
|
||||
<a href="#MigrateYourApplications">Migrate Your Applications</a>.</p>
|
||||
|
||||
|
||||
<h3 id="AntUsers">Ant users</h3>
|
||||
|
||||
<p>If you build your projects using the Ant tool (rather than with Eclipse), note the
|
||||
following changes with the new SDK tools.</p>
|
||||
|
||||
<h4>build.xml has changed</h4>
|
||||
|
||||
<p>You must re-create your <code>build.xml</code> file.</p>
|
||||
|
||||
<p>If you had customized your <code>build.xml</code>, first make a copy of it:</p>
|
||||
|
||||
<pre>
|
||||
$ cd <em>my-project</em>
|
||||
$ cp build.xml build.xml.old
|
||||
</pre>
|
||||
|
||||
<p>Now use the new <code>android</code> tool (located in <code><em>your_sdk</em>/tools/</code>)
|
||||
to create a new <code>build.xml</code> that references
|
||||
a specific platform target:</p>
|
||||
|
||||
<pre>$ android update project --path /path/to/my-project --target 1</pre>
|
||||
|
||||
<p>The "target" corresponds to an Android platform library (including any add-ons, such as
|
||||
Google APIs) that you would like to build your project against. You can view a list of available
|
||||
targets (and their corresponding integer ID) with the command, <code>android list targets</code>.
|
||||
When you are initially updating your projects to the new SDK, we recommend that you select the
|
||||
first target ("1"), which uses the Android 1.1 platform library.</p>
|
||||
|
||||
<p>A <code>gen/</code> folder will be created the first time you build and your <code>R.java</code> and
|
||||
your AIDL Java files will be generated in here. You <strong>must</strong> remove
|
||||
the old <code>R.java</code> and old auto-generated AIDL java files from the
|
||||
<code>src/</code> folder. (This
|
||||
does not apply to your own hand-crafted parcelabe AIDL java files.)</p>
|
||||
|
||||
<p class="note"><strong>Note:</strong> The "activitycreator" tool has been replaced
|
||||
by the new "android" tool. For information on creating new projects with the android tool,
|
||||
see the documentation about <a href="{@docRoot}guide/developing/other-ide.html">Developing
|
||||
In Other IDEs</a>.</p>
|
||||
|
||||
<p>Note that, with the Android 1.5 SDK, there is a new process for running
|
||||
applications in the Android Emulator.
|
||||
Specifically, you must create an Android Virtual Device (AVD) before you can launch an instance
|
||||
of the Emulator. Before attempting to run your applications with the new SDK,
|
||||
please continue with the section below to
|
||||
<a href="#MigrateYourApplications">Migrate Your Applications</a>.</p>
|
||||
|
||||
|
||||
<h2 id="MigrateYourApplications">Migrate Your Applications</h2>
|
||||
|
||||
<p>After you have completed the process above to <a href="#UpdateYourProjects">Update Your
|
||||
Projects</a>, you are strongly encouraged to run each of your applications in an instance
|
||||
of the emulator running the Android 1.5 system image. It's possible (however, unlikely)
|
||||
that you'll encounter some breakage in your application when you run your applications on
|
||||
the Android 1.5 system image. Whether you believe your application will be affected by
|
||||
platform changes or not, it's very important that you test the application's
|
||||
forward-compatibility on Android 1.5.</p>
|
||||
|
||||
<p>To test forward-compatibility, simply run your existing application (as-is) on an Android
|
||||
Emulator that's running the Android 1.5 system image. The following procedure will guide
|
||||
you through the process to running your existing applications on an emulator. <em>Please read
|
||||
the following guide completely before you begin</em>.</p>
|
||||
|
||||
<p>To test your application on an emulator running Android 1.5:</p>
|
||||
<ol>
|
||||
<li><a href="#UpdateYourProjects">Update Your Project</a> (you should have done this
|
||||
already, in the section above).</li>
|
||||
<li>Run your existing project, as-is, on an emulator running the Android 1.5 system image.
|
||||
<p>As mentioned in the guide to <a href="#UpdateYourProjects">Update Your Projects</a>,
|
||||
you should have selected a "build
|
||||
target" of "1", which compiles your application against the Android 1.1 system image, so there
|
||||
should be no new errors in your code.</p>
|
||||
<p>Eclipse users: follow the
|
||||
<a href="{@docRoot}guide/developing/eclipse-adt.html#Running">Eclipse guide to
|
||||
Running Your Application</a>.</p>
|
||||
<p>Ant users: follow the
|
||||
<a href="{@docRoot}guide/developing/other-ide.html#Running">Ant guide to
|
||||
Running Your Application</a>
|
||||
<p>During the procedure to Running Your Application, select a "deployment target"
|
||||
for the AVD that includes the Android 1.5 platform.
|
||||
If your application utilizes the Google Maps APIs (i.e.,
|
||||
MapView), be certain to select a target that includes the Google APIs.</p>
|
||||
<p>Once you complete the procedures to run your application in your respective environment,
|
||||
linked above, return here.</p>
|
||||
</li>
|
||||
<li>With your application running in the emulator, perform all regular testing on the application
|
||||
to ensure that it functions normally (in both landscape and portrait orientations).</li>
|
||||
</ol>
|
||||
|
||||
<p>Chances are, your application runs just fine on the Android 1.5 platform —
|
||||
new devices will be able to safely install and run your application and
|
||||
current users who update their devices will be able to continue using your application as usual.
|
||||
However, if something doesn't work the way you expect, then you might need to revisit
|
||||
your project and make any necessary changes to your code.</p>
|
||||
|
||||
<p>You can check for code breakages caused by API changes by opening your project
|
||||
in Eclipse, changing the "build target" to one using the Android 1.5 platform,
|
||||
and see where the ADT identifies errors in your code.</p>
|
||||
|
||||
|
||||
<h3 id="FutureProofYourApps">Future-proof your apps</h3>
|
||||
|
||||
<p>There have been several API additions made for this release, but there have been
|
||||
very few actual API <em>changes</em>. Only a couple (relatively unused) elements
|
||||
have been removed and a few have been deprecated, so your applications written with the
|
||||
Android 1.1 system library should work just fine. However,
|
||||
your application is more likely to encounter problems on Android 1.5
|
||||
if it performs any of the following:</p>
|
||||
|
||||
<ul>
|
||||
<li>Uses internal APIs. That is, APIs that are not officially supported
|
||||
and not available in the reference documentation. Any un-official APIs are always subject
|
||||
to change (which is why they're un-official) and some have indeed changed.
|
||||
</li>
|
||||
<li>Directly manipulates system settings. There are some settings (such as
|
||||
GPS, data roaming, bluetooth and others) that used to be writable by
|
||||
applications but have been changed so that they can only be explicitly modified by the user
|
||||
through the system settings. Refer to {@link android.provider.Settings.Secure}
|
||||
to see which settings are now secured and cannot be directly changed by your application.
|
||||
</li>
|
||||
<li>Uses View hierarchies that are unreasonably deep (more than 10 or so levels) or
|
||||
broad (more than 30 total). View hierarchies this big have always been troublesome, but
|
||||
Android 1.5 is much more efficient at exposing this and your application may crash.
|
||||
</li>
|
||||
<li>Makes assumptions about the available hardware. With new support for soft keyboards,
|
||||
not all devices will have full QWERTY keyboards on the hardware. So if your application
|
||||
listens for special keypress events that only occur on a keypad, then your application
|
||||
should degrade gracefully when there is no keyboard available.
|
||||
</li>
|
||||
<li>Performs its own layout orientation changes based on the acceletometer (or via other
|
||||
sensors). Some devices running Android 1.5 will automatically rotate the orientation
|
||||
(and all devices have the option to turn on auto-rotation), so if your application also
|
||||
attempts to rotate the orientation, it can result in strange behavior. In addition, if your
|
||||
application uses the accelerometer to detect shaking and you do not want to rotate the
|
||||
orientation, then you should lock the current orientation with
|
||||
<a href="{@docRoot}guide/topics/manifest/activity-element.html#screen">android:screenOrientation</a>.
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<p>Please read our blog post on <a
|
||||
href="http://android-developers.blogspot.com/2009/04/future-proofing-your-apps.html">Future-Proofing
|
||||
Your Apps</a> for more information on the issues mentioned above.</p>
|
||||
|
||||
<p>For information
|
||||
about other changes made to Android 1.5, refer to the following documents:</p>
|
||||
<ul>
|
||||
<li><a href="{@docRoot}sdk/api_diff/3/changes.html">Android 1.5 API Differences</a></li>
|
||||
<li><a href="{@docRoot}sdk/android-1.5.html#api-changes">Android 1.5 Version Notes</a></li>
|
||||
<li><a
|
||||
href="http://android-developers.blogspot.com/2009/04/ui-framework-changes-in-android-15.html">UI
|
||||
framework changes in Android 1.5 »</a></li>
|
||||
</ul>
|
||||
|
||||
<p>If you have additional trouble updating your code, visit the
|
||||
<a href="http://groups.google.com/group/android-developers">Android Developers Group</a>
|
||||
to seek help from other Android developers.</p>
|
||||
@@ -3,8 +3,16 @@ page.title=SDK Release Notes
|
||||
|
||||
<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>
|
||||
page at <a href="http://developer.android.com/sdk/RELEASENOTES.html">http://developer.android.com/sdk/RELEASENOTES.html</a>.</p>
|
||||
|
||||
|
||||
<h2 id="1.5_r2">Android 1.5 SDK, Release 2</h2>
|
||||
|
||||
<p>This SDK release provides the same developer tools as the Android 1.5 SDK,
|
||||
Release 1, but provides an updated Android 1.5 system image that includes a
|
||||
security patch for the issue described in the oCert advisory below:</p>
|
||||
|
||||
<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>
|
||||
|
||||
<h2 id="1.5_r1">Android 1.5 SDK, Release 1</h2>
|
||||
|
||||
|
||||
@@ -1,5 +1,4 @@
|
||||
page.title=Android 1.5 Platform Highlights
|
||||
sdk.version=1.5_r1
|
||||
@jd:body
|
||||
|
||||
<p>
|
||||
|
||||
@@ -1,37 +1,67 @@
|
||||
page.title=Older Releases
|
||||
page.title=Other SDK Releases
|
||||
@jd:body
|
||||
|
||||
<div class="special">
|
||||
<strong>NOTICE:</strong>
|
||||
<p>The SDKs listed on this page are "early-look" versions that were released in
|
||||
<p>This page provides a full list of older, obsolete SDK releases, including
|
||||
non-current versions of active releases and "early look" versions that were
|
||||
released before Android 1.0. The list is provided for informational purposes
|
||||
only.</p>
|
||||
|
||||
<p>If you are just getting started developing on Android, make sure that you
|
||||
are using the <a href="{@docRoot}sdk/{@sdkCurrent}/index.html">most current SDK available</a>,
|
||||
to ensure that your applications will be compatible with the latest
|
||||
Android-powered devices.</p>
|
||||
|
||||
<h2>Obsolete Releases</h2>
|
||||
|
||||
<p>The table below lists Android SDK releases that have been superceded by an
|
||||
active release and that are now obsolete. If you are using one of these
|
||||
releases, please upgrade to the <a href="{@docRoot}sdk/index.html">current SDK
|
||||
release</a>.</p>
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<th>Release</td>
|
||||
<th>Platform(s)</th>
|
||||
<th>Date</td>
|
||||
<th>Description</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="{@docRoot}sdk/1.5_r1/index.html">Android 1.5 SDK, Release 1</a></td>
|
||||
<td style="text-align:center;">Android 1.5<br>Android 1.1</td>
|
||||
<td><em>April 2009</em></td>
|
||||
<td>Replaced by Android 1.5 SDK, Release 2. <em><a href="RELEASENOTES.html#1.5_r1">Release notes</a></em></td>
|
||||
</tr>
|
||||
<tr class="alt">
|
||||
<td><a href="{@docRoot}sdk/1.0_r1/index.html">Android 1.0 SDK, Release 1</a></td>
|
||||
<td style="text-align:center;">Android 1.0</td>
|
||||
<td><em>September 2008</em></td>
|
||||
<td>Replaced by Android 1.0 SDK, Release 2. <em><a href="RELEASENOTES.html#1.0_r1">Release notes</a></em></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<h2>Non-Compatible Releases</h2>
|
||||
|
||||
<!-- <div class="special"> -->
|
||||
<p>The SDKs listed below are "early-look" versions that were released in
|
||||
the year preceding the full release of Android 1.0 in September 2008. Because
|
||||
these early-look SDKs were released before the Android 1.0 API specification was
|
||||
finalized, they do not provide a compliant Android execution environment.
|
||||
Consequently, applications that you develop in these SDKs will not be able to
|
||||
run on any Android-powered devices.</p>
|
||||
|
||||
<p>If you have an older application that you built in one of the early-look SDKs,
|
||||
you must migrate it to the Android
|
||||
1.0 SDK (or later release) before you will be able to deploy it to
|
||||
an Android-powered device. To help with this migration, each SDK package below
|
||||
provides information about API changes from the previous version. You can find
|
||||
the migration information in the documentation included in each SDK package.</p>
|
||||
<p>If you have an older application that you built in one of the early-look
|
||||
SDKs, you must migrate it to the Android 1.0 SDK (or later release) before you
|
||||
will be able to deploy it to an Android-powered device. To help with this
|
||||
migration, each SDK package below provides information about API changes from
|
||||
the previous version. You can find the migration information in the
|
||||
documentation included in each SDK package.</p>
|
||||
<!-- </div> -->
|
||||
|
||||
<p>If you are just getting started developing on Android, do not use one of these early-look
|
||||
SDKs. Instead, develop using the most <a href="{@docRoot}sdk/index.html">current
|
||||
SDK release</a> available, to ensure that your applications will be compatible
|
||||
with Android-powered devices.</p>
|
||||
</div>
|
||||
|
||||
|
||||
|
||||
|
||||
<h2>Android 0.9 SDK beta</h2>
|
||||
<p><em>August 18, 2008 - <a href="OLD_RELEASENOTES.html#0.9_beta">Release Notes</a></em></p>
|
||||
<h4>Android SDK m5-rc15</h4>
|
||||
<p><em>August 18, 2008 - <a href="OLD_RELEASENOTES.html#0.9_beta">Release Notes</a></em></p>
|
||||
<table>
|
||||
<tr>
|
||||
<th>Platform</th>
|
||||
<th>Package</th>
|
||||
<th colspan="2">Package</th>
|
||||
<th>Size</th>
|
||||
<th>MD5 Checksum</th>
|
||||
</tr>
|
||||
@@ -58,15 +88,11 @@ page.title=Older Releases
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
|
||||
|
||||
|
||||
<h2>Version m5-rc15</h2>
|
||||
<h4>Version m5-rc15</h4>
|
||||
<p><em>March 3, 2008 - <a href="OLD_RELEASENOTES.html#m5-rc15">Release Notes</a></em></p>
|
||||
<table>
|
||||
<tr>
|
||||
<th>Platform</th>
|
||||
<th>Package</th>
|
||||
<th colspan="2">Package</th>
|
||||
<th>Size</th>
|
||||
<th>MD5 Checksum</th>
|
||||
</tr>
|
||||
@@ -93,15 +119,11 @@ page.title=Older Releases
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
|
||||
|
||||
|
||||
<h2>Version m5-rc14</h2>
|
||||
<h4>Version m5-rc14</h4>
|
||||
<p><em>February 12, 2008 - <a href="OLD_RELEASENOTES.html#m5-rc14">Release Notes</a></em></p>
|
||||
<table>
|
||||
<tr>
|
||||
<th>Platform</th>
|
||||
<th>Package</th>
|
||||
<th colspan="2">Package</th>
|
||||
<th>Size</th>
|
||||
<th>MD5 Checksum</th>
|
||||
</tr>
|
||||
@@ -131,12 +153,11 @@ page.title=Older Releases
|
||||
|
||||
|
||||
|
||||
<h2>Version m3-rc37a</h2>
|
||||
<h4>Version m3-rc37a</h4>
|
||||
<p><em>December 14, 2007 - <a href="OLD_RELEASENOTES.html#m3-rc37a">Release Notes</a></em></p>
|
||||
<table>
|
||||
<tr>
|
||||
<th>Platform</th>
|
||||
<th>Package</th>
|
||||
<th colspan="2">Package</th>
|
||||
<th>Size</th>
|
||||
<th>MD5 Checksum</th>
|
||||
</tr>
|
||||
@@ -166,12 +187,11 @@ page.title=Older Releases
|
||||
|
||||
|
||||
|
||||
<h2>Version m3-rc22a</h2>
|
||||
<h4>Version m3-rc22a</h4>
|
||||
<p><em>November 16, 2007 - <a href="OLD_RELEASENOTES.html#m3-rc22a">Release Notes</a></em></p>
|
||||
<table>
|
||||
<tr>
|
||||
<th>Platform</th>
|
||||
<th>Package</th>
|
||||
<th colspan="2">Package</th>
|
||||
<th>Size</th>
|
||||
<th>MD5 Checksum</th>
|
||||
</tr>
|
||||
@@ -201,12 +221,11 @@ page.title=Older Releases
|
||||
|
||||
|
||||
|
||||
<h2>Version m3-rc20a</h2>
|
||||
<h4>Version m3-rc20a</h4>
|
||||
<p><em>November 12, 2007 - <a href="OLD_RELEASENOTES.html#m3-rc20a">Release Notes</a></em></p>
|
||||
<table>
|
||||
<tr>
|
||||
<th>Platform</th>
|
||||
<th>Package</th>
|
||||
<th colspan="2">Package</th>
|
||||
<th>Size</th>
|
||||
<th>MD5 Checksum</th>
|
||||
</tr>
|
||||
|
||||
@@ -133,10 +133,10 @@
|
||||
<li>
|
||||
<h2>Current SDK Release</h2>
|
||||
<ul>
|
||||
<li><a href="/sdk/1.5_r1/index.html">Download</a></li>
|
||||
<li><a href="/sdk/1.5_r1/installing.html">Installing</a></li>
|
||||
<li><a href="/sdk/1.5_r1/upgrading.html">Upgrading</a></li>
|
||||
<li><a href="/sdk/1.5_r1/requirements.html">System Requirements</a></li>
|
||||
<li><a href="/sdk/1.5_r2/index.html">Download</a></li>
|
||||
<li><a href="/sdk/1.5_r2/installing.html">Installing</a></li>
|
||||
<li><a href="/sdk/1.5_r2/upgrading.html">Upgrading</a></li>
|
||||
<li><a href="/sdk/1.5_r2/requirements.html">System Requirements</a></li>
|
||||
</ul>
|
||||
<ul>
|
||||
<li><a href="/sdk/terms.html">SDK Terms and Conditions</a></li>
|
||||
@@ -154,8 +154,7 @@
|
||||
<ul>
|
||||
<li><a href="/sdk/1.1_r1/index.html">Android 1.1 SDK, r1</a></li>
|
||||
<li><a href="/sdk/1.0_r2/index.html">Android 1.0 SDK, r2</a></li>
|
||||
<li><a href="/sdk/1.0_r1/index.html">Android 1.0 SDK, r1</a></li>
|
||||
<li><a href="/sdk/older_releases.html">Older Releases</a></li>
|
||||
<li><a href="/sdk/older_releases.html">Other Releases</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
@@ -185,16 +184,6 @@
|
||||
|
||||
</div> <!-- end body-content -->
|
||||
|
||||
<script type="text/javascript">
|
||||
init(); /* initialize android-developer-docs.js */
|
||||
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
|
||||
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
|
||||
</script>
|
||||
<script type="text/javascript">
|
||||
var pageTracker = _gat._getTracker("UA-5831155-1");
|
||||
pageTracker._trackPageview();
|
||||
</script>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
||||
|
||||
@@ -26,19 +26,12 @@
|
||||
<li><a href="<?cs var:toroot ?>sdk/android-1.1.html">Android 1.1 Version Notes</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>
|
||||
<h2>Native Development Tools</h2>
|
||||
<ul>
|
||||
<li><a href="<?cs var:toroot ?>sdk/ndk/1.5-r1/index.html">Android 1.5 NDK, r1</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>
|
||||
<h2>Previous SDK Releases</h2>
|
||||
<ul>
|
||||
<li><a href="<?cs var:toroot ?>sdk/1.1_r1/index.html">Android 1.1 SDK, r1</a></li>
|
||||
<li><a href="<?cs var:toroot ?>sdk/1.0_r2/index.html">Android 1.0 SDK, r2</a></li>
|
||||
<li><a href="<?cs var:toroot ?>sdk/1.0_r1/index.html">Android 1.0 SDK, r1</a></li>
|
||||
<li><a href="<?cs var:toroot ?>sdk/older_releases.html">Older Releases</a></li>
|
||||
<li><a href="<?cs var:toroot ?>sdk/older_releases.html">Other Releases</a></li>
|
||||
</ul>
|
||||
</li><?cs
|
||||
/if ?>
|
||||
|
||||
Reference in New Issue
Block a user