From 8ef5a6b6aeb27fd5113dbf1d881aab4dc5ccb6bb Mon Sep 17 00:00:00 2001 From: Scott Main Date: Fri, 6 Nov 2009 18:38:33 -0800 Subject: docs: remove all content from the older sdk download, install, and requirements pages and redirect to the new sdk pages. Also update the "older sdks" doc to include all version-specific sdks. also update the robots file to disallow indexing of the old sdk docs. --- docs/html/sdk/1.5_r2/index.jd | 88 +-------- docs/html/sdk/1.5_r2/installing.jd | 334 +---------------------------------- docs/html/sdk/1.5_r2/requirements.jd | 47 +---- 3 files changed, 13 insertions(+), 456 deletions(-) (limited to 'docs/html/sdk/1.5_r2') diff --git a/docs/html/sdk/1.5_r2/index.jd b/docs/html/sdk/1.5_r2/index.jd index 15342a4..4fb99b6 100644 --- a/docs/html/sdk/1.5_r2/index.jd +++ b/docs/html/sdk/1.5_r2/index.jd @@ -1,87 +1,5 @@ -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 - -

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 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 Upgrading the SDK. - -

For more information about the new tools features, see the SDK Release Notes. - -

Android Platforms

- -

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.

- - - - - - - - - - - - - - - - - - -
PlatformAPI LevelNotesDescription
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).
Android 1.12Version NotesIncludes 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).
- -

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 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/android-1.5/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.

- -

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/

+sdk.redirect=true +sdk.redirect.path=index.html +@jd:body diff --git a/docs/html/sdk/1.5_r2/installing.jd b/docs/html/sdk/1.5_r2/installing.jd index 1e4e0f2..2ea04e4 100644 --- a/docs/html/sdk/1.5_r2/installing.jd +++ b/docs/html/sdk/1.5_r2/installing.jd @@ -1,332 +1,8 @@ -sdk.version=1.5 -sdk.rel.id=2 -sdk.date=April 2009 - -page.title=Installing the Android SDK @jd:body + -

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 -Download page. Once you've downloaded -the SDK, return here.

- -

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 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.3 or newer). 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

- -

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

- -

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

- - - - - +

You should have already been redirected by your browser. Please go to +Installing the Android SDK.

\ No newline at end of file diff --git a/docs/html/sdk/1.5_r2/requirements.jd b/docs/html/sdk/1.5_r2/requirements.jd index c10ccac..96fdcb2 100644 --- a/docs/html/sdk/1.5_r2/requirements.jd +++ b/docs/html/sdk/1.5_r2/requirements.jd @@ -1,45 +1,8 @@ -page.title=System Requirements @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.

\ No newline at end of file +

You should have already been redirected by your browser. Please go to +System Requirements.

\ No newline at end of file -- cgit v1.1