From a6602f1fe4590e48c760f21ce29a92629240c463 Mon Sep 17 00:00:00 2001 From: Dirk Dougherty Date: Thu, 27 Aug 2009 16:26:43 -0700 Subject: Add docs for SDK update. Add redirects for preview files. Manually integrate a few doc changes from cupcake. Change-Id:I524d7dbf929371ee501599229894640660f352ce --- docs/html/sdk/1.6_r1/index.jd | 140 +++++++++++ docs/html/sdk/1.6_r1/installing.jd | 441 ++++++++++++++++++++++++++++++++++ docs/html/sdk/1.6_r1/requirements.jd | 51 ++++ docs/html/sdk/1.6_r1/upgrading.jd | 386 +++++++++++++++++++++++++++++ docs/html/sdk/RELEASENOTES.jd | 192 +++++++++++++++ docs/html/sdk/adt_download.jd | 19 +- docs/html/sdk/android-1.6.jd | 235 ++++++++++++++++++ docs/html/sdk/preview/features.jd | 4 + docs/html/sdk/preview/index.jd | 192 +-------------- docs/html/sdk/preview/installing.jd | 343 +------------------------- docs/html/sdk/preview/requirements.jd | 44 +--- docs/html/sdk/preview/upgrading.jd | 257 +------------------- docs/html/sdk/sdk_toc.cs | 2 + 13 files changed, 1466 insertions(+), 840 deletions(-) create mode 100644 docs/html/sdk/1.6_r1/index.jd create mode 100644 docs/html/sdk/1.6_r1/installing.jd create mode 100644 docs/html/sdk/1.6_r1/requirements.jd create mode 100644 docs/html/sdk/1.6_r1/upgrading.jd create mode 100644 docs/html/sdk/android-1.6.jd create mode 100644 docs/html/sdk/preview/features.jd (limited to 'docs/html/sdk') diff --git a/docs/html/sdk/1.6_r1/index.jd b/docs/html/sdk/1.6_r1/index.jd new file mode 100644 index 0000000..11d369b --- /dev/null +++ b/docs/html/sdk/1.6_r1/index.jd @@ -0,0 +1,140 @@ +page.title=Android 1.6 SDK, Release 1 +sdk.redirect=0 +sdk.version=1.6 + +sdk.date=September 2009 + +sdk.win_download=android-sdk-windows-1.6_r1.zip +sdk.win_bytes= +sdk.win_checksum= + +sdk.mac_download=android-sdk-mac_x86-1.6_r1.zip +sdk.mac_bytes= +sdk.mac_checksum= + +sdk.linux_download=android-sdk-linux_x86-1.6_r1.tgz +sdk.linux_bytes= +sdk.linux_checksum= + +adt.zip_download=ADT-0.9.3.zip +adt.zip_version=0.9.3 +adt.zip_bytes= +adt.zip_checksum= + +@jd:body + +

For more information on this SDK release, read the +Release Notes.

+ +

SDK Contents

+ +

Development tools

+ +

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 Dev Guide and access them +in the <sdk>/tools/ directory. + +

The tools package in this SDK includes updates from those provided in the +previous SDK. The tools use the same project structure as in the previous SDK +(Android 1.5). If you have application projects developed in the Android 1.5 +SDK, you can migrate them to the latest SDK without modification. For more +information about how to migrate, see Upgrading the +SDK. + +

Android Platforms

+ +

This SDK includes multiple Android platform versions that you can 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.

+ + + + + + + + + + + + + + + + + +
PlatformAPI +LevelNotesDescription
Android 1.64Version +NotesIncludes a standard Android 1.6 library and system image with a set of +development applications. Does not include any external libraries (such as the +Maps external library).
Android 1.53Version +NotesIncludes 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).
+ +

Note that you can use the Android SDK and AVD Manager to download other +platform versions into your development environment.. + +

SDK Add-Ons

+ +

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-ons listed below. The Android system API Level required by +the add-ons are noted.

+ + + + + + + + + + + + + + + + + + +
Add-OnAPI LevelNotesDescription
Google APIs4 Includes the com.google.android.maps external library, a compliant +Android 1.6 system image, a {@link android.location.Geocoder Geocoder} +backend service implementation, documentation, and sample code.
Google APIs3 Includes the com.google.android.maps external library, a compliant +Android 1.5 system image, a {@link android.location.Geocoder Geocoder} +backend service implementation, documentation, and sample code.
+ +

Sample Code and Applications

+ +

You can look at a variety of tutorials and samples in the Dev Guide and access the sample +code itself in the <sdk>/platforms/<platform>/samples/ +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.

+ +

For example, to view or build the samples available for the Android +1.6 platform (AVD target "Android 1.6"), you will find the samples in the +<sdk>/platforms/android-1.6/samples/ directory of the SDK +package.

+ +

Documentation

+ +

The SDK package includes a full set of local documentation. To view it, open +the <sdk>/documentation.html 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.

+ +

The most current documentation is always available on the Android Developers +site:

+ +

http://developer.android.com/ +

+ + diff --git a/docs/html/sdk/1.6_r1/installing.jd b/docs/html/sdk/1.6_r1/installing.jd new file mode 100644 index 0000000..954bfa3 --- /dev/null +++ b/docs/html/sdk/1.6_r1/installing.jd @@ -0,0 +1,441 @@ +page.title=Installing the Android 1.6 SDK +sdk.version=1.6 +sdk.preview=0 + +@jd:body + +
+ +
+ +

This page describes how to install the Android SDK and set up your +development environment.

+ +

If you encounter any problems during installation, see the +Installation Notes at the bottom of +this page.

+ +

Upgrading?

+

If you have already developed applications using an earlier version +of the Android SDK, please read Upgrading the SDK, instead. +

+ + +

Prepare for Installation

+ +

Before you begin, take a moment to confirm that your development machine +meets the System Requirements.

+ +

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.4 or newer is recommended). If you need +to install Eclipse, you can download it from this location:

+ +

http://www.eclipse.org/downloads/

+ +

A Java or RCP version of Eclipse is recommended.

+ +

Install the SDK

+ +

After downloading the Android SDK, unpack the Android SDK .zip archive +to a suitable location on your machine. By default, the SDK files are unpacked +into a directory named android_sdk_<platform>_<release>.

+ +

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.

+ +

Optionally, you may want to add the location of the SDK's primary tools directory +to your system PATH. The primary tools/ directory is located at the root of the +SDK folder. Adding tools to your path lets you run Android Debug Bridge (adb) and +the other command line tools without +needing to supply the full path to the tools directory.

+ + +

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.

+ +

If you will be using the Eclipse IDE as your development environment, +the next section describes how to install the Android Development Tools (ADT) 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 Next Steps).

+ + +

Install the ADT Plugin for Eclipse

+ +

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.

+ +

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—skip to Next Steps.)

+ +

Once you have the Eclipse IDE installed, as described in Preparing for Installation, follow the steps below to +download the ADT plugin and install it in your respective Eclipse environment. +

+ + + + + + + +
Eclipse 3.4 (Ganymede)Eclipse 3.5 (Galileo)
+ +
    +
  1. Start Eclipse, then select Help > Software Updates.... + In the dialog that appears, click the Available Software tab.
    2. +
  2. Click Add Site...
    3. +
  3. In the Add Site dialog that appears, enter this URL in the "Location" field: + 
    https://dl-ssl.google.com/android/eclipse/
    +

    Note: If you have trouble aqcuiring the plugin, try using "http" in the Location URL, + instead of "https" (https is preferred for security reasons).

    +

    Click OK.

    4. +
  4. 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 Install...
    5. +
  5. On the subsequent Install window, "Android DDMS" and "Android Development Tools" + should both be checked. Click Next.
    6. +
  6. Read and accept the license agreement, then click Finish.
    7. +
  7. Restart Eclipse.
    8. +
+ +		 + +
    +
  1. Start Eclipse, then select Help > Install + New Softare.
    2. +
  2. In the Available Software dialog, click Add....
    3. +
  3. In the Add Site dialog that appears, enter a name for the remote site + (e.g., "Android Plugin") in the "Name" field. +

    In the "Location" field, enter this URL:

    + 
    https://dl-ssl.google.com/android/eclipse/
    +

    Note: If you have trouble aqcuiring the plugin, you can try + using "http" in the URL, instead of "https" (https is preferred for + security reasons).

    +

    Click OK.

    +
    4. +
  4. Back in the Available Software view, you should now see "Developer + Tools" added to the list. Select the checkbox next to Developer Tools, + which will automatically select the nested tools Android DDMS and Android + Development Tools. + Click Next.
    5. +
  5. In the resulting Install Details dialog, the Android DDMS and Android + Development Tools features are listed. Click Next to + read and accept the license agreement and install any dependencies, + then click Finish.
    6. +
  6. Restart Eclipse.
    7. + +
+
+ +

Now modify your Eclipse preferences to point to the Android SDK directory:

+
    +
  1. Select Window > Preferences... to open the Preferences + panel (Mac: Eclipse > Preferences).
    2. +
  2. Select Android from the left panel.
    3. +
  3. For the SDK Location in the main panel, click Browse... and + locate your downloaded SDK directory.
    4. +
  4. Click Apply, then OK.
    5. +
+ +

Done! If you haven't encountered any problems, then you're ready to +begin developing Android applications. See the +Next Steps section for suggestions on how to start.

+ + +

Contents of the SDK

+ +

Once you've downloaded and unpacked the SDK, open the SDK directory +and take a look at what's inside. + +

The table below describes the SDK directory contents.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameDescription
add-ons/Contains add-ons to the Android SDK development +environment, which let you develop against external libraries that are available on some +devices.
docs/A full set of documentation in HTML format, including the Developer's Guide, +API Reference, and other information.
platforms/Contains a set of Android platform versions that you can develop +applications against, each in a separate directory.
<platform>/Platform version directory, for example "Android 1.6". All platform version +directories contain a similar set of files and subdirectory structure.
 data/Storage area for default fonts and resource definitions.
images/Storage area for default disk images, including the Android system image, +the default userdata image, the default ramdisk image, and more. The images +are used in emulator sessions.
samples/Contains a wide variety of sample applications that you can load as projects +into your development environment, compile, and run on the emulator.
skins/A set of emulator skins available for the platform version. Each skin is +designed for a specific screen resolution.
templates/Storage area for file templates used by the SDK development tools.
tools/Any development tools that are specific to the platform version.
android.jarThe Android library used when compiling applications against this platform +version.
tools/Contains the set of development and profiling tools available to you, such +as the emulator, the android tool, adb, ddms, and more.
RELEASE_NOTES.htmlA file that loads the local version of the SDK release notes, if +available.
documentation.htmlA file that loads the entry page for the local Android SDK +documentation.
+ +

Next Steps

+

Once you have completed installation, you are ready to +begin developing applications. Here are a few ways you can get started:

+ +

Learn about Android

+ + +

Explore the SDK

+ + +

Explore some code

+ + +

Visit the Android developer groups

+ + + +

Installation Notes

+ +

Ubuntu Linux Notes

+ + + +

Other Linux Notes

+ + + + +

Troubleshooting ADT Installation

+ +

If you are having trouble downloading the ADT plugin after following the +steps above, here are some suggestions:

+ + + +

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 it:

+ +
    +
  1. Download the + ADT Plugin zip file (do not unpack it).
    2. +
  2. Follow steps 1 and 2 in the default install + instructions (above).
    3. +
  3. In the Add Site dialog, click Archive.
    4. +
  4. Browse and select the downloaded zip file.
    5. +
  5. In Eclipse 3.5 only, enter a name for the local update site (e.g., + "Android Plugin") in the "Name" field.
    6. +
  6. Click OK. +
  7. Follow the remaining procedures as listed for + default installation above, + starting from step 4.
    8. +
+ +

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.

+ +

Other install errors

+ +

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 +ADT +Installation Error: "requires plug-in org.eclipse.wst.sse.ui".

+ +

For Linux users

+

If you encounter this error when installing the ADT Plugin for Eclipse: +

+An error occurred during provisioning.
+Cannot connect to keystore.
+JKS
+

+...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.

+ + diff --git a/docs/html/sdk/1.6_r1/requirements.jd b/docs/html/sdk/1.6_r1/requirements.jd new file mode 100644 index 0000000..781ee32 --- /dev/null +++ b/docs/html/sdk/1.6_r1/requirements.jd @@ -0,0 +1,51 @@ +page.title=System Requirements +sdk.version=1.6 +sdk.preview=0 +@jd:body + +

The sections below describe the system and software requirements for developing +Android applications using the Android SDK tools included in Android + SDK, Release .

+ +

Supported Operating Systems

+ + +

Supported Development Environments

+ + +

Note: 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.

+ +

Hardware requirements

+ + diff --git a/docs/html/sdk/1.6_r1/upgrading.jd b/docs/html/sdk/1.6_r1/upgrading.jd new file mode 100644 index 0000000..2f9cc73 --- /dev/null +++ b/docs/html/sdk/1.6_r1/upgrading.jd @@ -0,0 +1,386 @@ +page.title=Upgrading the SDK +sdk.version=1.6 +sdk.preview=0 +@jd:body + + +
+
+ +

Upgrading the SDK

+
    +
  • If you are developing on the Android 1.5 SDK, migrating your +applications is straightforward and typically requires no modifications.
    • +
  • For Eclipse users, a new version of ADT is available. To use the Android +1.6 SDK, please upgrade to ADT 0.9.3 (or later).
    • +
  • For Windows users, the SDK includes a new USB driver that you can +install, if you are developing on a device.
    • +
  • A new Android SDK and AVD Manager tool is available. To access +it, run the android tool without options.
    • +
+ +

In this document

+
    +
  1. Install the SDK
    2. +
  2. Update Your Eclipse ADT Plugin
    3. +
  3. Run Your Applications
    4. +
  4. Migrate Your Applications
    5. +
+ +

Migrating information

+
    +
  1. Android 1.6 API +Differences
    2. +
+ +
+
+ +

This document describes how to move your development environment and existing +Android applications from an Android 1.5 SDK to the Android 1.6 SDK. If you are +migrating applications from an SDK older than 1.5, please also read the +upgrading document available in the Android 1.5 SDK package.

+ +

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 upcoming Android platform.

+ +

The Android 1.6 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 problems 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 the new platform.

+ + +

For more information on new SDK features and system changes, +see the Android 1.6 Version Notes.

+ + +

Install the SDK

+ +

If you haven't yet downloaded the SDK, download it from +here and unpack it into a safe location.

+ +

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 .bashrc or .bash_profile file:

+
export PATH=$PATH:<your_sdk_dir>/tools
+ + +

Update Your Eclipse ADT Plugin

+ +

If you don't use the Eclipse IDE for development, +skip to Run Your Applications.

+ +

A new version of the ADT Plugin, ADT 0.9.3, is available in conjunction with +this SDK release. To use the SDK, you must upgrade your ADT Plugin to version +0.9.3. With ADT 0.9.3, you can still compile your existing applications against +multiple platform versions, such as Android 1.5, Android 1.1, and so on. However, +ADT 0.9.3 is not compatible with previous versions of the SDK and its tools, so +make sure that you upgrade both your SDK and the ADT Plugin.

+ +The upgrade steps for ADT are described below. For information about new features in ADT, see the Release Notes document.

+ +

If you're currently using a version of ADT older than version 0.9, +then you must uninstall ADT before you proceed (read how to Uninstall your previous +ADT plugin). If you currently have version 0.9 or 0.9.1, then you don't need +to uninstall and can continue with the procedure below.

+ + + + + + + +
Eclipse 3.4 (Ganymede)Eclipse 3.5 (Galileo)
+ +
    +
  1. Select Help > Software Updates.
    2. +
  2. Select the Available Software tab.
    3. +
  3. Select the checkboxes next to Android DDMS and Android Developer Tools, + then click Update.
    4. +
  4. In the resulting Available Updates dialog, ensure that both Android DDMS + and Android Development Tools are selected, then click + Next.
    5. +
  5. Read and accept the license agreement and then click Finish. + This will download and install the latest version of Android DDMS and + Android Development Tools.
    6. +
  6. Restart Eclipse.
    7. +
+		 + +
    +
  1. Select Help > Check for Updates.
    2. +
  2. In the resulting Available Updates dialog, locate the Android DDMS and + Android Development Tools features in the list and ensure that the checkboxes + next to them are selected. Click Next. +

    If the Available Updates dialog does not list Android DDMS and Android + Development tools, make sure that you have set up a remote update site + for them, as described in + Installing the ADT Plugin. +

    3. +
  3. In the Update Details dialog, click Next.
    4. +
  4. Read and accept the license agreement and then click Finish. + This will download and install the latest version of Android DDMS and + Android Development Tools.
    5. +
  5. Restart Eclipse.
    6. +
+
+ +

If you encounter problems with this update procedure, try performing a fresh +installation. Fully remove your existing ADT Plugin as described in Uninstall your previous +ADT plugin and then follow the guide to Installing the ADT Plugin for +Eclipse.

+ +

Update your Eclipse SDK Preferences

+ +

The last step is to update your Eclipse preferences to point to the new +SDK directory:

+
    +
  1. Select Window > Preferences to open + the Preferences panel (Mac: Eclipse > Preferences + ).
    2. +
  2. Select Android from the left panel.
    3. +
  3. For the SDK Location, click Browse + and locate your SDK directory.
    4. +
  4. Click Apply, then OK.
    5. +
+ + +

Run Your Applications to Test Forward Compatibility

+ +

Now that you have installed the Android 1.6 SDK, we encourage you run each of +your existing applications on the Android 1.6 system image that is included in +the SDK, to ensure that it functions properly on the new platform. +Testing forward-compatibility in this way is especially important for +applications that you may have already published and that may be installed on +devices that will upgrade to the new platform.

+ +

In most cases, your applications will function properly when run on the new +version of the platform. However, it is possible that you will encounter +unexpected behavior, because of changes in the API or underlying platform. If +you do find problems, you can use the SDK tools to compile and publish an update +to the applications, which users can then download. + +

To test forward-compatibility, simply run your application, as-is, on an +instance of the Android Emulator that uses an AVD targeted to the "Android 1.6" +system image. Here are the steps:

+ +
    +
  1. Make no changes to your application code.
    2. +
  2. Create a new AVD that runs the new "Android 1.6" platform.
    3. +
  3. Launch your application in an emulator running the new AVD.
    4. +
  4. Perform normal testing on your application to ensure everything works as + expected.
    5. +
+ +

Note that, for the purposes of forward-compatibility testing, you should not +change how your application is compiled. That is, you should continue to compile +the application against the same version of the Android library as before. The +only change needed is to the AVD, which controls the version of the Android +system image (run-time environment) on which the application is run. + +

For more information on creating an AVD and launching your application, see +Running Your +Applications (Eclipse) or Running +Your Applications (other IDEs), depending on your development +environment.

+ +

Android 1.6 Forward-Compatibility Tips

+ +

The new version of the Android platform includes several new APIs, but +very few actual changes to existing APIs. This means that, in most +cases, your applications written with earlier versions of the Android library +should run properly on the Android 1.6 platform.

+ +

However, here are some areas to pay attention to as you test forward-compatibility:

+ + + +

Migrate Your Applications

+ +

If you want to use any of the new Android 1.6 APIs in your existing +applications, you must first migrate the applications to the new Android +platform version. Generally, migrating an application includes:

+ + + +

Additionally, to run your application in the emulator, you need to +create an AVD that uses the Android 1.6 system image.

+ +

Note: You only need migrate your application as +described in this section if the application will actually use APIs +introduced in the Android 1.6 platform (which are not available on +devices running older versions of the Android platform). If your application +does not use any new APIs, you can compile and run it without modification and +not migration is necessary.

+ +

Reference the Proper API Level

+ +

If your application is using APIs introduced in Android 1.6, you must +reference that dependency in the application's manifest file so that it can be +deployed to devices running the Android 1.6 platform.

+ +

Open the manifest file and locate the minSdkVersion attribute +in the <uses-sdk> manifest element. Set the value of +minSdkVersion to "4" (the API Level +identifier corresponding to Android 1.6). Here's an example:

+ +
+<manifest>
+  ...
+  <uses-sdk android:minSdkVersion="4" />
+  ...
+</manifest>
+
+ +

Compile Against the Proper Build Target

+ +

Once you've changed the minSdkVersion value in your +application's manifest, you need to set the application's project properties so +that the application will be compiled against the Android 1.6 library. To do so, +follow the steps below for your respective development environment.

+ +

Eclipse Users

+ +
    +
  1. Right-click on the individual project (in the Package Explorer) + and select Properties.
    2. +
  2. In the properties, open the Android panel and select a new Project Build Target. + Select "Android 1.6" to target the new platform (or "Google APIs" with the "4" + API Level, if your application uses the Google Maps APIs).
    3. +
  3. Click Apply, then OK.
    4. +
+ +

Ant Users

+ +

Use the android tool (located in +your_sdk/tools/) to create a new build.xml +that references the new platform target. To see a list of available targets, +execute:

+ +
android list targets
+ +

Select the target id that corresponds to the "Android 1.6" platform +and pass it with the --target parameter when updating your project. +For example:

+ +
android update project --path /path/to/my-project --target 2
+ +

If your application uses the Google Maps APIs (i.e., MapView), be certain to +select a Google APIs target.

+ +

Create an AVD that Uses the Android 1.6 Platform

+ +

Finally, you need to set up a new AVD that uses the Android 1.6 platform, so that +you can run your application in the emulator. + +

To set up the new AVD, use the android tool, available in the +tools/ directory of the SDK. You can run the AVD manager by simply +changing to the tools/ directory and entering android +at the command line. Click "New" to create the AVD and set its properties.

+ +

When creating the AVD, make sure to select a target of "Android 1.6 - API +Level 4". If your application uses the Google Maps APIs (MapView), select the +target "Google APIs (Google Inc.) - API Level 4".

+ +

For more information about running your application in an AVD, see Running Your +Application (Eclipse) or Running Your +Application (other IDEs).

+ +

For general information about AVDs, see the Android Virtual +Devices document.

+ + + +
+

If you have trouble migrating to the new version of the SDK, visit the +Android Developers Group +to seek help from other Android developers.

+
+ diff --git a/docs/html/sdk/RELEASENOTES.jd b/docs/html/sdk/RELEASENOTES.jd index 03eeb4b..130a92c 100644 --- a/docs/html/sdk/RELEASENOTES.jd +++ b/docs/html/sdk/RELEASENOTES.jd @@ -5,6 +5,198 @@ page.title=SDK Release Notes releases. For the latest known issues, please ensure that you're viewing this page at http://developer.android.com/sdk/RELEASENOTES.html.

+

Android 1.6 SDK, Release 1

+ +

This SDK provides updates to the development tools and Android system that +you use to create applications for compliant Android-powered devices.

+ +

Release Overview

+ +

This SDK release includes several new features for developers. Highlights of the +changes include:

+ + + +

For details about the Android platforms included in the SDK — 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 Download +page. Note that you can use the Android SDK and AVD Manager to download +additional platforms.

+ +

Installation and Upgrade Notes

+ +

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.

+ +

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.

+ +

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

ADT Plugin for Eclipse

+ +

An updated version of the ADT Plugin for Eclipse is available with the +Android 1.6 SDK. The new version, ADT 0.9.3, provides several new +features, including integrated support for the Android SDK and AVD Manager +and zipalign tool. In addition, the New Project Wizard now +lets you create a test package containing tests for your application. These +features are described in the sections below.

+ +

If you are developing in Eclipse with ADT and want to get started with the +Android 1.6 SDK, you should download and install a compatible version of the ADT +Plugin (0.9.3 or higher).

+ +

The new version of ADT is downloadable from the usual remote update site or +is separately downloadable as a .zip archive. For instructions on how to +download the plugin, please see Upgrading +Your Eclipse Plugin.

+ +

Android SDK and AVD Manager

+ +

The SDK offers a new tool called Android AVD Manager that lets you manage +your SDK and AVD environments more efficiently.

+ +

Using the tool, you can quickly check what Android platforms, add-ons, +extras, and documentation packages are available in your SDK environment, what +their versions are, and whether updated versions are available. You can then +download one or more items from remote repositories and install them directly in +your SDK environment. For example, the tool lets you obtain updates to SDK tools +incrementally, as they are made available, without having to wait for the next +SDK release. You can also download Android platform versions into your +environment that were not included in the SDK package.

+ +

The tool also lets you quickly create new AVDs, manage +their properties, and run a target AVD from a single window.

+ +

If you are developing in Eclipse with ADT, you can access the Android SDK +and AVD Manager from the Window menu.

+ +

If you are developing in another IDE, you can access the Android SDK and +AVD Manager through the android command-line tool, located in the +<sdk>/tools directory. You can launch the tool with a graphical UI by +using the android command without specifying any options. You can +also simply double-click the android.bat (Windows) or android (OS X/Linux) file. +You can still use android commands to create and manage AVDs, +including AVDs with custom hardware configurations.

+ +

Integration with zipalign

+ +

The Android system offers a performance optimization for installed +application packages whose contained uncompressed files are all aligned on +4-byte boundaries. For these .apks, the system can read the files by mmap'ing +the zip file, rather than by copying all the data out of them. This reduces +the amount of memory used by the application at run time. The SDK includes +a tool called zipalign that you can run against your .apks, to +align them properly and enable them to benefit from this optimization.

+ +

The ADT Plugin and the Ant build tools both provide integrated support for +aligning your application packages. After you build an .apk, the SDK tools can +sign and then run zipalign against it. The SDK includes the +standalone version of the zipalign tool, so you can run also run it +manually from the command line if you choose.

+ + + +

In general, note that you must zipalign an application only +after it has been signed, as signing will disrupt the package +alignment.

+ +

Support for Test Packages in New Project Wizard

+ +

The New Project Wizard available in the ADT 0.9.3 now lets you add a test +package containing Instrumentation or other classes of tests while you are +creating or importing a new Android application project.

+ +

New USB Driver for Windows

+ +

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. + +

The Windows version of the Android 1.6 SDK includes a new, WinUSB-based +driver that you can install. The driver is compatible with both 32- and 64-bit +versions of Windows XP and Vista. The driver represents an upgrade from the USB +driver included in previous Android SDKs, although installing the new driver is +not required.

+ +

If you installed the USB driver from a previous SDK release and it is working +properly, you do not need to upgrade to the new driver. However, we recommend +upgrading if you have had any problems with the older driver or simply want +to upgrade to the latest version.

+ +

The USB driver files are located in the +<SDK>/usb_driver directory. For driver installation or +upgrade instructions, see Installing the WinUSB +Driver.

+

+ +

Emulator Skins, Android 1.6 Platform

+ +

The Android 1.6 platform included in the SDK provides a new set of emulator +skins, including:

+ + + +

Besides these defaults, You can also create an AVD that overrides the default +density for each skin, to create any combination of resolution/density (WVGA +with medium density, for instance). To do so, use the android tool +command line to create a new AVD that uses a custom hardare configuration. See +Creating an +AVD for more information.

+ +

Other Notes and Resolved Issues

+ + + +

Android 1.5 SDK, Release 3

Provides an updated Android 1.5 system image that includes permissions diff --git a/docs/html/sdk/adt_download.jd b/docs/html/sdk/adt_download.jd index d7b9ac3..3eb6831 100644 --- a/docs/html/sdk/adt_download.jd +++ b/docs/html/sdk/adt_download.jd @@ -26,24 +26,24 @@ page. - 0.9.2 - ADT-0.9.2.zip + 0.9.3 + ADT-0.9.3.zip bytes - Required for users of Android 1.6 SDK (and later releases). Updated from 0.9.1. August 2009 + Required for users of Android 1.6 SDK (and later releases). Updated from 0.9.1. September 2009 0.9.1 ADT-0.9.1.zip 2916093 bytes e7b2ab40414ac98 - Required for users of Android 1.5 SDK (and later releases). Updated from 0.9.0. 6 May 2009 + Required for users of Android 1.5 SDK. Updated from 0.9.0. 6 May 2009 0.8.0 ADT-0.8.0.zip   - Required for users of Android 1.1 SDK and Android 1.0 SDK. 23 Sep 2008 + Required for users of Android 1.0/1.1 SDKs. 23 Sep 2008 @@ -63,20 +63,19 @@ Feature ID column and look at its version number.

0.7.1 - Required for users of Android 0.9 SDK beta. As of this version, Eclipse 3.2 is no longer supported. - Please upgrade to Eclipse Ganymede (3.4) or Europa (3.3) if you are still using 3.2. 18 Aug 2008 + Required for users of the Android 0.9 SDK beta. 18 Aug 2008 0.4.0 - Required if you are using the M5 SDK. See the SDK Release Notes for details on changes and enhancements in this version. 12 Feb 2008 + Required for users of the Android M5 Early Look SDK. 12 Feb 2008 0.3.3 - Some significant enhancements (see m3-rc37 SDK Release Notes). 14 Dec 2007 + Required for users of the Android M3-RC37 Early Look SDK. 14 Dec 2007 0.3.1 - Initial Release. Required for Android m3-rc20 SDK and Android m3-rc22 SDK.21 Nov 2007 + Initial Release. Required for users of the Android M3-RC20/22 SDKs.21 Nov 2007

diff --git a/docs/html/sdk/android-1.6.jd b/docs/html/sdk/android-1.6.jd new file mode 100644 index 0000000..29dceec --- /dev/null +++ b/docs/html/sdk/android-1.6.jd @@ -0,0 +1,235 @@ +page.title=Android 1.6 Version Notes + +@jd:body + +

+Date: September 2009
+API Level: 4

+ + +

This document provides version notes for the Android 1.6 system image included in the SDK.

+ + + +

Overview

+ +

The Android 1.6 system delivered in the SDK (as library and system image) is +the development counterpart to the Android 1.6 production system image, +deployable to Android-powered handsets starting September 2009. The system is fully +compliant and includes no external libraries.

+ +

The Android 1.6 system delivers an updated version of the framework +API. As with previous versions, the Android 1.6 API +is assigned an integer identifier — 4 — that is +stored in the system itself. This identifier, called the "API Level", allows the +system to correctly determine whether an application is compatible with +the system, prior to installing the application.

+ +

For more information about how to use API Level, see the API Levels document.

+ +

New Features

+ +

For a list of new system features, see the Android 1.6 Platform +Highlights document.

+ +

Built-in Applications

+ +

The system image includes these built-in applications:

+ + +

Locales

+ +

The system image provides a variety of built-in locales. In some cases, +region-specific strings are available for the locales. In other cases, +a default version of the language is used. The languages that will be +available in the Android 1.6 system image are listed below (with +language_country/region locale descriptor).

+ + + + + + +
+
    +
  • Arabic, Egypt (ar_EG)
    • +
  • Arabic, Israel (ar_IL)
    • +
  • Bulgarian, Bulgaria (bg_BG)
    • +
  • Chinese, PRC (zh_CN)
    • +
  • Chinese, Taiwan (zh_TW)
    • +
  • Croatian, Croatia (hr_HR)
    • +
  • Czech, Czech Republic (cs_CZ)
    • +
  • Danish, Denmark (da_DK)
    • +
  • Dutch, Netherlands (nl_NL)
    • +
  • Dutch, Belgium (nl_BE)
    • +
  • English, US (en_US)
    • +
  • English, Britain (en_GB)
    • +
  • English, Canada (en_CA)
    • +
  • English, Australia (en_AU)
    • +
  • English, India (en_IN)
    • +
  • English, Ireland (en_IE)
    • +
  • English, New Zealand (en_NZ)
    • +
  • English, Singapore (en_SG)
    • +
  • English, South Africa (en_ZA)
    • +
  • Finnish, Finland (fi_FI)
    • +
  • French, France (fr_FR)
    • +
  • French, Belgium (fr_BE)
    • +
  • French, Canada (fr_CA)
    • +
  • French, Switzerland (fr_CH)
    • +
  • German, Germany (de_DE)
    • +
  • German, Austria (de_AT)
    • +
  • German, Switzerland (de_CH)
    • +
  • German, Liechtenstein (de_LI)
    • +
+		 +
    +
  • Greek, Greece (el_GR)
    • +
  • Hindi, India (hi_IN)
    • +
  • Hungarian, Hungary (hu_HU)
    • +
  • Indonesian, Indonesia (id_ID)
    • +
  • Italian, Italy (it_IT)
    • +
  • Italian, Switzerland (it_CH)
    • +
  • Japanese, Japan (ja_JP)
    • +
  • Korean, Korea (ko_KR)
    • +
  • Latvian, Latvia (lv_LV)
    • +
  • Lithuanian, Lithuania (lt_LT)
    • +
  • Norwegian Bokmål, Norway (nb_NO)
    • +
  • Polish, Poland (pl_PL)
    • +
  • Portuguese, Brazil (pt_BR)
    • +
  • Portuguese, Portugal (pt_PT)
    • +
  • Romanian, Romania (ro_RO)
    • +
  • Russian, Russia (ru_RU)
    • +
  • Serbian, Serbia (sr_RS)
    • +
  • Slovak, Slovakia (sk_SK)
    • +
  • Slovenian, Slovenia (sl_SI)
    • +
  • Spanish, Spain (es_ES)
    • +
  • Spanish, US (es_US)
    • +
  • Swedish, Sweden (sv_SE)
    • +
  • Thai, Thailand (th_TH)
    • +
  • Tagalog, Philippines (tl_PH)
    • +
  • Turkish, Turkey (tr_TR)
    • +
  • Ukranian, Ukrania (uk_UA)
    • +
  • Vietnamese, Vietnam (vi_VN)
    • +
+
+ +

Localized UI strings match the locales that are displayable in +the emulator, accessible through the device Settings application.

+ +

API Changes

+ +

Overview

+ + + +

API Change Details

+ +

For a detailed view of API changes in this platform (API Level 4), see the API Differences Report.

+ + + + + + diff --git a/docs/html/sdk/preview/features.jd b/docs/html/sdk/preview/features.jd new file mode 100644 index 0000000..81b4ff6 --- /dev/null +++ b/docs/html/sdk/preview/features.jd @@ -0,0 +1,4 @@ +sdk.redirect=true + +@jd:body + diff --git a/docs/html/sdk/preview/index.jd b/docs/html/sdk/preview/index.jd index a6a6ca2..81b4ff6 100644 --- a/docs/html/sdk/preview/index.jd +++ b/docs/html/sdk/preview/index.jd @@ -1,194 +1,4 @@ -page.title=Android 1.6 Early Look SDK -sdk.redirect=0 -sdk.version=1.6 -sdk.preview=true - -sdk.date=August 2009 - -sdk.win_download=android-sdk-windows-1.5_r3.zip -sdk.win_bytes=191477853 -sdk.win_checksum=1725fd6963ce69102ba7192568dfc711 - -sdk.mac_download=android-sdk-mac_x86-1.5_r3.zip -sdk.mac_bytes=183024673 -sdk.mac_checksum=b1bafdaefdcec89a14b604b504e7daec - -sdk.linux_download=android-sdk-linux_x86-1.5_r3.zip -sdk.linux_bytes=178117561 -sdk.linux_checksum=350d0211678ced38da926b8c9ffa4fac - -adt.zip_download=ADT-0.9.2.zip -adt.zip_version=0.9.2 -adt.zip_bytes=178117561 -adt.zip_checksum=350d0211678ced38da926b8c9ffa4fac +sdk.redirect=true @jd:body -

SDK Overview

- -

This Early Look SDK provides the tools, libraries, and system images that you need to start developing and testing applications on the next version of the Android platform — Android 1.6.

- -

The sections below provide information about the contents of the SDK, as well as any applicable release notes.

- -

This Early Look SDK is provided for development and testing purposes only. You can use it to get familiar with the new Android 1.6 framework APIs and the UI and features of the Android 1.6 system, and you can use it to begin testing your existing applications with the new API and system. However, this SDK is not suitable for compiling applications for deployment to Android-powered devices running the Android 1.6 platform, when such devices are available. For more information, see Framework API and Provisional API Level.

- -

The sections below provide information about the contents of the SDK, as well as any applicable release notes.

- -

Note: This is an early look SDK only. -The tools and documentation are not complete. The API reference documentation for the early look -SDK is provided only in the downloadable SDK package — documentation for this early -look release is not available at http://developer.android.com. -To access the API reference for the early -look SDK, see the documentation in your SDK's docs/reference/ directory. -

-Additionally, note that the APIs provided in this SDK are subject to change until the final -Android 1.6 SDK is released. You should not compile any applications for distribution using -this version of the SDK. If you do so, your applications will not function properly when deployed -to Android-powered devices running the final Android 1.6 platform. Please wait for the final -Android 1.6 SDK before distributing applications built on the Android 1.6 system image. -

- -

Framework API and Provisional API Level

- -

This SDK gives you early access to the framework API that will be offered in Android 1.6. However, at the time of this release, The API specification for Android 1.6 was not yet final, meaning that it is possible that the API could change before the final release of the Android 1.6 platform.

- -

To help distinguish the API offered in the Early Look SDK from that of the final Android 1.6 platform, this SDK assigns a provisional API Level identifier — Donut — to its Early Look framework API. When the Android 1.6 framework API specification is final, the API Level identifier will change to 4 and the "Donut" identifier will no longer be supported.

- -

The "Donut" framework API is for development only and is not supported as a platform for compiling applications for deployment or publishing. The API Level of "Donut" will not be supported by any Android-powered devices in the field, including those running the Android 1.6 platform. This means that when the final Android 1.6 platform is released, you will need to change your application's android:minSdkVersion manifest attribute to reference the API Level of "4", rather than "Donut", if your application is using Android 1.6 APIs. You would then need to recompile your application before publishing it.

- -

The use of a provisional API Level in this SDK is designed to protect developers and device users from inadvertently publishing or installing applications based on the Early Look framework API, which may not run properly on actual devices running Android 1.6.

- -

To develop using the Early Look framework API, you must reference an API Level of "Donut" in your application's manifest.

- -

Specifically, you must define a android:minSdkVersion -attribute in a <uses-sdk> element as a child of -<manifest> in the manifest file. When set, the -attribute looks like this:

- -
<manifest>
-  ...
-  <uses-sdk android:minSdkVersion="Donut" />
-  ...
-</manifest>
- -

If you are developing in Eclipse with ADT, please read the next section for information about the ADT upgrade that supports the Early Look SDK's provisional API Level.

- - -

ADT Plugin for Eclipse

- -

An updated version of the ADT Plugin for Eclipse is available in connection with the Android 1.6 Early Look SDK. The new version, ADT 0.9.2, provides support for the provisional API Level "Donut" that is offered in the Early Look SDK and includes several new features and improvements. These changes mean that this Early Look SDK does not work with older Eclipse plugins (ADT 0.9.1). - -

If you are developing in Eclipse with ADT and want to get started with Android 1.6 Early Look SDK, you must download and install the correct version of the ADT Plugin (0.9.2 or higher).

- -

The new version of ADT is downloadable from the usual remote update site or is separately downloadable as a .zip archive. For instructions on how to download the plugin, please see Upgrading Your Eclipse Plugin.

- -

Android AVD Manager

- -

The SDK offers a new tool called Android AVD Manager that lets you manage your AVDs more efficiently. For example, you can quickly create new AVDs, manage their properties, and run a target AVD from a single window. - -If you are developing in Eclipse with ADT, you can access the Android AVD Manager from the Window menu.

- -If you are developing in another IDE, you can access the AVD manager capabilities through the android command-line tool, located in the <sdk>/tools directory. You can launch the tool with a graphical UI by using the android command without specifying any options. The command-line version of the tool is also still available.

- -

SDK Component Updater

- -

This SDK includes a new SDK Component Updater tool that lets you download updated versions of SDK components individually into your environment, as soon as they become available.

- -

The Updater provides a graphical UI that lets you quickly check what Android platforms, add-ons, extras, and documentation packages are available in your SDK environment, what their versions are, and whether updated versions are available. Using the Updater, you can download one or more items from the remote repository and install them directly in your SDK environment. For example, the updater lets you receive updates to SDK tools incrementally, as they are made available, without having to wait for the next SDK release.

- -

To access the Updater, use the android command-line tool, located in the <sdk>/tools directory. You can launch the Updater by using the android command without specifying any options.

- -

In ADT, it you can also access the Updater through the Android AVD Manager tool.

- -

Support for Test Packages in New Project Wizard

- -

The New Project Wizard available in the ADT 0.9.2 now lets you add a test package containing JUnit or other classes of tests while you are creating or importing a new Android application project.

- - -

Other Notes and Resolved Issues

- - - -

SDK Contents

- -

Development tools

- -

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 -Dev Guide and access them in the <sdk>/tools/ directory. - -

The tools package in this SDK includes updates from those provided in the previous SDK. The tools use the same project structure as in the previous SDK (Android 1.5), but have been updated to support the the provisional API Level identifier "donut". If you have application projects developed in the Android 1.5 SDK, you can migrate them to the latest SDK without modification. For more information about how to migrate, see Upgrading the SDK. - -

For more information about the new tools features, see the SDK Overview section above. - -

Android Platforms

- -

This SDK includes multiple Android platform versions that you can 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.

- - - - - - - - - - - - - - - - - -
PlatformAPI LevelNotesDescription
Android 1.6 Early Look (Android Donut)DonutIncludes an Early Look Android 1.6 library and system image with a set of development applications. Does not include any external libraries (such as the Maps external library).
Android 1.53Version NotesIncludes 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).
- -

SDK Add-Ons

- -

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.

- - - - - - - - - - - - - - - - - -
Add-OnAPI LevelNotesDescription
Google APIsDonut Includes the com.google.android.maps external library, an Early Look -Android 1.6 system image, a {@link android.location.Geocoder Geocoder} -backend service implementation, documentation, and sample code.
Google APIs3 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.
- -

Sample Code and Applications

- -

You can look at a variety of tutorials and samples in the Dev Guide and access the sample code itself -in the <sdk>/platforms/<platform>/samples/ 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.

- -

For example, to view or build the samples available for the Android -1.6 Early Look platform (AVD target "Android Donut"), you will find the samples in the <sdk>/platforms/android-Donut/samples/ directory of the SDK package.

- -

Documentation

- -

The SDK package includes a full set of local documentation. To view it, open the <sdk>/documentation.html 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.

- - -
- -
-

Feedback on this preview SDK is welcome on the public Android Open Source forums:

-

http://source.android.com/discuss

-
- - diff --git a/docs/html/sdk/preview/installing.jd b/docs/html/sdk/preview/installing.jd index 05e7ab5..1e6b26b 100644 --- a/docs/html/sdk/preview/installing.jd +++ b/docs/html/sdk/preview/installing.jd @@ -1,346 +1,5 @@ -page.title=Installing the Android SDK -sdk.version=1.6 -sdk.preview=true -sdk.date=August 2009 +sdk.redirect=true @jd:body -
- -
- -

This page describes how to install the Android Early Look SDK and set up your -development environment.

- -

If you encounter any problems during installation, see the -Installation Notes at the bottom of -this page.

- -

Upgrading?

-

If you have already developed applications using an earlier version -of the Android SDK, please read Upgrading the SDK, instead. -

- - -

Preparing for Installation

- -

Before you begin, take a moment to confirm that your development machine meets the -System Requirements. -

- -

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.4 or newer is recommended). If you need to install Eclipse, you can -download it from this location:

- -

http://www.eclipse.org/downloads/

- -

A Java or RCP version of Eclipse is recommended.

- -

Installing the SDK

- -

Unpack the Android SDK .zip archive to a suitable location on your machine. -By default, the SDK files are unpacked into a directory named -android_sdk_<platform>_<release>. -The directory contains a local copy of the documentation (accessible by opening -documentation.html in your browser) and the subdirectories -tools/, add-ons/, platforms/, and others. Inside -each subdirectory of platforms/ you'll find samples/, which includes -code samples that are specific to each version of the platform.

- -

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.

- -

Optionally, you may want to add the location of the SDK's primary tools directory -to your system PATH. The primary tools/ directory is located at the root of the -SDK folder. Adding tools to your path lets you run Android Debug Bridge (adb) and -the other command line tools without -needing to supply the full path to the tools directory.

- - -

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.

- -

If you will be using the Eclipse IDE as your development environment, -the next section describes how to install the Android Development Tools (ADT) 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 Next Steps).

- - -

Installing the ADT Plugin for Eclipse

- -

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.

- -

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—skip to Next Steps.)

- -

Once you have Eclipse installed, as described in Preparing for -Installation, follow the steps below to -download the ADT plugin and install it in your respective Eclipse -environment.

- - - - - - - -
Eclipse 3.3 (Europa)Eclipse 3.4 (Ganymede)
- -
    -
  1. Start Eclipse, then select Help > Software Updates -> Find and Install....
    2. -
  2. In the dialog that appears, select Search for new features to install -and click Next.
    3. -
  3. Click New Remote Site.
    4. -
  4. In the resulting dialog box, enter a name for the remote site (e.g. "Android Plugin") and - enter the URL: - 
    https://dl-ssl.google.com/android/eclipse/
    -

    If you have trouble aqcuiring the plugin, try using "http" in the URL, - instead of "https" (https is preferred for security reasons).

    -

    Click OK.

    5. -
  5. You should now see the new site added to the search list (and checked). - Click Finish.
    6. -
  6. 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 Next.
    7. -
  7. Read and accept the license agreement, then click Next.
    8. -
  8. On the following Installation window, click Finish.
    9. -
  9. The ADT plugin is not digitally signed. Accept the installation anyway - by clicking Install All.
    10. -
  10. Restart Eclipse.
    11. -
- -		 - - -
    -
  1. Start Eclipse, then select Help > Software Updates....
    2. -
  2. In the dialog that appears, click the Available Software tab.
    3. -
  3. Click Add Site...
    4. -
  4. Enter the Location: - 
    https://dl-ssl.google.com/android/eclipse/
    -

    If you have trouble aqcuiring the plugin, try using "http" in the Location URL, - instead of "https" (https is preferred for security reasons).

    -

    Click OK.

    5. -
  5. 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 Install...
    6. -
  6. On the subsequent Install window, "Android DDMS" and "Android Development Tools" - should both be checked. Click Next.
    7. -
  7. Read and accept the license agreement, then click Finish.
    8. -
  8. Restart Eclipse.
    9. -
- -
- -

Now modify your Eclipse preferences to point to the Android SDK directory:

-
    -
  1. Select Window > Preferences... to open the Preferences - panel (Mac: Eclipse > Preferences).
    2. -
  2. Select Android from the left panel.
    3. -
  3. For the SDK Location in the main panel, click Browse... and -locate your downloaded SDK directory.
    4. -
  4. Click Apply, then OK.
    5. -
- -

Done! If you haven't encountered any problems, then you're ready to -begin developing Android applications. See the -Next Steps section for suggestions on how to start.

- - -

Troubleshooting ADT Installation

-

-If you are having trouble downloading the ADT plugin after following the steps above, here are -some suggestions:

- - -

-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: -

-
    -
  1. Download the ADT Plugin zip file (do not unpack it).
    2. -
  2. Follow steps 1 and 2 in the default install instructions (above).
    3. -
  3. In Eclipse 3.3, click New Archive Site....
    - In Eclipse 3.4, click Add Site..., then Archive...
    4. -
  4. Browse and select the downloaded zip file.
    5. -
  5. Follow the remaining procedures, above, starting from steps 5.
    6. -
-

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.

- -

Other install errors

- -

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 -ADT -Installation Error: "requires plug-in org.eclipse.wst.sse.ui".

- -

For Linux users

-

If you encounter this error when installing the ADT Plugin for Eclipse: -

-An error occurred during provisioning.
-Cannot connect to keystore.
-JKS
-

-...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.

- - -

Next Steps

-

Once you have completed installation, you are ready to -begin developing applications. Here are a few ways you can get started:

- -

Learn about Android

- - -

Explore the SDK

- - -

Explore some code

- - -

Visit the Android developer groups

- - - -

Installation Notes

- -

Ubuntu Linux Notes

- - - -

Other Linux Notes

- - - - - diff --git a/docs/html/sdk/preview/requirements.jd b/docs/html/sdk/preview/requirements.jd index 15731e0..1e6b26b 100644 --- a/docs/html/sdk/preview/requirements.jd +++ b/docs/html/sdk/preview/requirements.jd @@ -1,45 +1,5 @@ -page.title=System Requirements -sdk.version=1.6 -sdk.preview=true -@jd:body - -

The sections below describe the system and software requirements for developing -Android applications using the Android SDK tools included in Android - SDK, Release .

+sdk.redirect=true -

Supported Operating Systems

- +@jd:body -

Supported Development Environments

- -

Note: 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.

\ No newline at end of file diff --git a/docs/html/sdk/preview/upgrading.jd b/docs/html/sdk/preview/upgrading.jd index da2eb25..1e6b26b 100644 --- a/docs/html/sdk/preview/upgrading.jd +++ b/docs/html/sdk/preview/upgrading.jd @@ -1,258 +1,5 @@ -page.title=Upgrading the SDK -sdk.version=1.6 -sdk.preview=true -@jd:body - - -
-
- -

Upgrading the SDK

-
    -
  • ADT 0.9 / 0.9.1 is not compatible with the Android 1.6 Early Look SDK. You must upgrade - ADT to 0.9.2.
    • -
  • The Early Look SDK uses a special provisional API Level, "Donut", which is required - to compile against the new Donut platform.
    • -
- -

In this document

-
    -
  1. Install the SDK
    2. -
  2. Update Your Eclipse ADT Plugin
    3. -
  3. Run Your Applications
    4. -
  4. Convert Your Applications
    5. -
- -

Migrating references

-
    -
  1. Android 1.6 Early Look API Differences
    2. -
- -
-
- -

This document describes how to move your development environment and existing -Android applications from an Android 1.5 SDK to the Android 1.6 Early Look SDK. -If you are migrating applications from an SDK older than 1.5, please also read the upgrading -document available in the Android 1.5 SDK package.

- -

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 upcoming -Android platform.

- -

The Android 1.6 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 the new platform.

- - - -

Install the SDK

- - -

Now that you have the Android 1.6 Early Look SDK, -you need to perform some of the regular installation steps.

- - -

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 -.bashrc or .bash_profile file:

-
export PATH=$PATH:<your_sdk_dir>/tools
- - -

Update Your Eclipse ADT Plugin

- -

If you don't use Eclipse for development, -skip to Run Your Applications.

- - - -

A new ADT plugin (version 0.9.2) is required for the Android 1.6 Early Look SDK. -With ADT 0.9.2, you can still compile your applications against -multiple platform versions, such as Android 1.5. However, previous versions -of ADT will not work with the Android 1.6 Early Look SDK, so you must upgrade -to ADT 0.9.2.

- -

If you're currently using a version of ADT older than version 0.9, then you must -uninstall ADT before you proceed (read how to -Uninstall -your previous ADT plugin). If you currently have version 0.9 or 0.9.1, then you don't -need to uninstall and can continue with the procedure below.

- -

Install the 0.9.2 ADT plugin

- -

To install the new ADT plugin, follow the steps below for your respective version of Eclipse.

- - - - - - - -
Eclipse 3.3 (Europa)Eclipse 3.4 (Ganymede)
- -
    -
  1. Select Help > Software Updates > - Find and Install.
    2. -
  2. Select Search for new features to install.
    3. -
  3. Select the Android plugin entry by checking the box next to it, - then click Finish. -

    (Your original entry for the plugin should still be here. If not, see the guide - to Installing the ADT Plugin.) -

    4. -
  4. In the results, expand the entry for the Android plugin and - be sure that "Developer Tools" is checked, then click Next. - (This will install "Android DDMS" and "Android Development Tools".)
    5. -
  5. Read and accept the license agreement, then click Next. -
  6. In the next window, click Finish to start installation.
    7. -
  7. The ADT plugin is not digitally signed. Accept the installation anyway by clicking - Install All.
    8. -
  8. Restart Eclipse.
    9. -
-		 - -
    -
  1. Select Help > Software Updates.
    2. -
  2. Select the Available Software tab.
    3. -
  3. 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 - Install.
    4. -
  4. On the next window, "Android DDMS" and "Android Development Tools" - should both be checked. Click Finish.
    5. -
  5. Restart Eclipse.
    6. -
-
- -

If you encounter problems with this update procedure, try performing a fresh installation. -Ensure your current ADT is fully uninstalled and then -follow the guide to Installing the ADT Plugin -for Eclipse.

- -

Update your Eclipse SDK Preferences

- -

The last step is to update your Eclipse preferences to point to the new SDK directory:

-
    -
  1. Select Window > Preferences to open the Preferences - panel (Mac: Eclipse > Preferences).
    2. -
  2. Select Android from the left panel.
    3. -
  3. For the SDK Location, click Browse - and locate your SDK directory.
    4. -
  4. Click Apply, then OK.
    5. -
- - -

Run Your Applications

- -

Now that you have installed the Android 1.6 Early Look SDK, we encourage you -to run each of your applications in an instance -of the emulator that's running the new Android 1.6 system image. It's possible (however, unlikely) -that you'll encounter unexpected behavior in your application when you run your applications on -the new 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.

- -

To test forward-compatibility, simply run your application, as-is, on an instance of the Android -Emulator that uses an AVD targeted to "Android Donut (Preview)":

- -
    -
  1. Make no changes to your application code.
    2. -
  2. Create a new AVD that's targeted to the "Donut" platform.
    3. -
  3. Launch your application in an emulator running the new AVD.
    4. -
  4. Perform normal testing on your application to ensure everything works as expected.
    5. -
- -

For more information on creating an AVD and launching your application refer to the -Eclipse guide to -Running Your Application or the -Ant guide to -Running Your Application, depending on your development environment.

- - -

Convert Your Applications

- -

If you want to fully utilize new APIs introduced with the Android 1.6 Early Look SDK, -then you'll need to convert your application to compile against the new "Donut" platform.

- -

First, you need to change the value of the minSdkVersion attribute in -the <uses-sdk> manifest element. While -running your application against the Donut platform included with the Early Look SDK, you -must set the minSdkVersion value to "Donut". For example:

- -
-<manifest>
-  ...
-  <uses-sdk android:minSdkVersion="Donut" />
-  ...
-</manifest>
-
- -

This value is required only while compiling against the Donut platform included with -the Android 1.6 Early Look SDK. Once the final SDK is made -available for Android 1.6, you will need to change this value. -For more information, read about the Framework API and -Provisional API Level.

- -

Once you've changed the minSdkVersion value in your application's manifest, -continue with the procedures below to convert your applications.

- -

Eclipse users

- -
    -
  1. Right-click on the individual project (in the Package Explorer) - and select Properties.
    2. -
  2. In the properties, open the Android panel and select a new Project Build Target. - Select "Android Donut (Preview)" to target the new - platform (or "Google APIs" with the "Donut" platform if your application uses the Maps APIs).
    3. -
  3. Click Apply, then OK.
    4. -
- -

Remember that you must create an AVD that targets the same platform in order to run the emulator. - Continue with the - Eclipse guide to - Running Your Application. During the procedure to Running Your Application, select a "deployment - target" or the AVD that includes the "Donut" platform. If your application utilizes the Google Maps APIs (i.e., - MapView), be certain to select a target that includes the Google APIs.

- - -

Ant users

- -

Use the android tool (located in your_sdk/tools/) - to create a new build.xml that references - the new platform target. To see a list of available targets, execute:

- - 
android list targets
- -

Select the target id that corresponds to the "Donut" platform and pass it with the - --target parameter when updating your project. For example:

- - 
android update project --path /path/to/my-project --target 2
- -

Remember that you must create an Android Virtual Device (AVD) that's targeted to the - same platform before you can run the updated application an instance - of the emulator. Please continue with the - Ant guide to - Running Your Application. During the procedure to Running Your Application, select a "deployment - target" for the AVD that includes the "Donut" platform. - If your application utilizes the Google Maps APIs (i.e., - MapView), be certain to select a target that includes the Google APIs.

+sdk.redirect=true +@jd:body -
-

If you have additional trouble updating your code, visit the -Android Developers Group -to seek help from other Android developers.

-
diff --git a/docs/html/sdk/sdk_toc.cs b/docs/html/sdk/sdk_toc.cs index c08d75e..64af012 100644 --- a/docs/html/sdk/sdk_toc.cs +++ b/docs/html/sdk/sdk_toc.cs @@ -74,6 +74,7 @@ 系統影像版本資訊 @@ -96,6 +97,7 @@ 較舊的 SDK 發行版本