From 38dea272bdea54901dbc269b0666c97acf0a9fa8 Mon Sep 17 00:00:00 2001
From: Scott Main Adding and updating components in your Android SDK is fast and easy. To
-perform an update, use the Android SDK and AVD Manager to
-install or update the individual SDK components that you need. The Android SDK
-and AVD Manager tool is included in the Android SDK
-download. Adding and updating components in your Android SDK is fast and easy. To add or
+update the individual SDK components that you need, use the Android SDK and AVD
+Manager (included in the SDK Tools). It only takes a couple of clicks to install individual versions of the
Android platform, new development tools, new documentation, and SDK add-ons. The
@@ -34,32 +32,17 @@ new SDK components are automatically installed into your existing SDK directory,
so you don't need to update your development environment to specify a new SDK
location. Because each version of the Android platform can be installed as an
-individual component of your SDK, you can customize your development environment
-to the Android platforms you are targetting. Testing your app on multiple
-versions of the platform is very important in order to successfully operate on
-as many devices as possible. Be sure to install each version of the Android
-platform with which your app is compatible, then test your apps on AVDs that run each
-platform. If you are just getting started and you are not sure what components to install,
-see Adding Platforms and Other
-Components for information. If you develop applications using Eclipse, you may also need to update your
-ADT plugin when you update your development tools, in order to compile against
-a new version of the platform. See the revisions listed in the SDK Tools document for ADT
-Plugin compatibility. Figure 1. The Android SDK and AVD Manager's
-Available Packages
-panel, which shows the SDK components that are
+ If you're setting up your Android SDK for the first time,
+see Installing the SDK for information about
+what components to install. Note: If you develop in Eclipse, you might also need
+to update your ADT plugin when you update your development tools. See the revisions listed in the
+ADT Plugin for Eclipse document. Figure 1. The Android SDK and AVD Manager's
+Available Packages panel, which shows the SDK components that are
available for you to download into your environment.
-
+
The Android SDK and AVD Manager is the tool that you use to install and upgrade SDK components in your development environment.
-You can access the tool in any of three ways:
-You can launch the Android SDK and AVD Manager in one of the following ways.
If you encounter problems when installing or updating ADT, you +
If you encounter problems when installing or updating ADT, you can try removing the existing ADT plugin and then performing a fresh installation. To remove ADT, follow these steps:
diff --git a/docs/html/sdk/index.jd b/docs/html/sdk/index.jd index 2e59801..2812ae8 100644 --- a/docs/html/sdk/index.jd +++ b/docs/html/sdk/index.jd @@ -57,7 +57,7 @@ for Eclipse. installer, this is launched for you when the Wizard is complete). Add some Android platforms (such as Android 1.6 and Android 2.3) and other components (such as documentation) to your SDK. If you aren't sure what to add, see Which components do I need? +href="installing.html#which">Recommended ComponentsDone!
diff --git a/docs/html/sdk/installing.jd b/docs/html/sdk/installing.jd index c3b103f..5b5c4f4 100644 --- a/docs/html/sdk/installing.jd +++ b/docs/html/sdk/installing.jd @@ -3,6 +3,49 @@ sdk.preview=0 @jd:body + + + +The first step in setting up your environment for developing Android applications -is downloading the Android SDK starter package.
- -The starter package is not a full +
The SDK starter package is not a full development environment—it includes only the core SDK Tools, which you can -use to download the rest of the SDK components (such as the platform system images).
- -Note: If you're using Windows, we recommend that you download -the SDK installer (the {@code .exe} file from the download table). It will guide you through the -installation process and check your computer for the required software.
+use to download the rest of the SDK components (such as the latest Android platform).You can get the latest version of the SDK starter package from the SDK download page.
@@ -90,7 +126,17 @@ the SDK tools from command line.Optionally, you might want to add the location of the SDK's
tools/
directory and {@code platform-tools/} directory to your system
-PATH
. Both tool directories are located at the root of the SDK folder. Adding
+PATH
. Both tool directories are located at the root of the SDK folder.
+
+
+
Adding
tools/
and {@code platform-tools/} to your path lets you run Android Debug Bridge (adb)
and the other command line tools without needing to
@@ -100,9 +146,10 @@ supply the full path to the tool directories.
~/.bash_profile
or ~/.bashrc
file. Look
for a line that sets the PATH environment variable and add the
full path to the tools/
and {@code platform-tools/} directories to it. If you don't
- see a line setting the path, you can add one:export PATH=${PATH}:<your_sdk_dir>/tools:<your_sdk_dir>/platform-tools
export PATH=${PATH}:<your_sdk_dir>/tools:<your_sdk_dir>/platform-tools+
.bash_profile
and
proceed as for Linux. You can create the .bash_profile
if
@@ -114,12 +161,9 @@ supply the full path to the tool directories.
tools/
and {@code platform-tools/} directories to the path. If you will be using the Eclipse IDE, 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 Adding Platforms -and Other Components).
+If you prefer to work in an IDE other than Eclipse, you do not need to +
If you prefer to work in a different IDE, you do not need to install Eclipse or ADT, instead, you can directly use the SDK tools to build and -debug your application.
- - -The Android SDK and AVD Manager is a tool that you will use often -to add components to your SDK environment and manage Android Virtual Devices. -
-See Adding SDK Components for details on how to -launch and use the tool.
-The last step in setting up your SDK is using the Android SDK and AVD Manager (a tool included in the SDK starter package) to download @@ -167,20 +199,48 @@ essential SDK components into your development environment.
The SDK uses a modular structure that separates the major parts of the SDK—Android platform versions, add-ons, tools, samples, and documentation—into a set of separately installable components. The SDK starter package, which you've already downloaded, includes only a single -component: the latest version of the SDK Tools. To develop any Android -application, you also need to download at least one Android platform into your -environment, although downloading additional components is highly recommended. -See Which components do I need? for information about -which components are required and which are optional.
+component: the latest version of the SDK Tools. To develop an Android +application, you also need to download at least one Android platform and the SDK Platform-tools +(tools that the latest platform depend upon). However, downloading +additional components is highly recommended. + +You can launch the Android SDK and AVD Manager in one of the following ways:
+SDK Manager.ext
file at the root of the Android
+SDK directory.tools/
directory in the
+Android SDK, then execute: android update sdk
This will automatically select +the required and recommended components for you to install.
To download components, use the graphical UI of the Android SDK and AVD +Manager, shown in Figure 1, to browse the SDK repository and select new or updated +components. The Android SDK and AVD Manager will install the selected components in +your SDK environment. For information about which components you should download, see the following +section about Recommended Components
+ +Figure 1. The Android SDK and AVD Manager's +Available Packages panel, which shows the SDK components that are +available for you to download into your environment.
The SDK repository offers these types of components:
<sdk>/tools/
directory. <sdk>/tools/
directory of your SDK and read more about them in the Tools section of the developer guide.
+
+<sdk>/platform-tools/
directory. Read more about them in
+the Tools section of the developer guide.
+To download components, use the graphical UI of the Android SDK and AVD -Manager, shown in Figure 1, to browse the SDK repository, select new or updated -components for download, and then install the selected components in your SDK -environment.
- -Figure 1. The Android SDK and AVD Manager's -Available Packages -panel, which shows the SDK components that are -available for you to download into your environment.
-The SDK repository contains a range of components that you can download. Use the table below to determine which components you need, based on whether you -want to set up a basic (but functionnal) development environment or a -recommended or full development environment:
+want to set up a basic, recommended, or full development environment: +Basic | -SDK Tools | -If you've installed -the SDK starter package, then you already have this component preinstalled. The -SDK Tools and the SDK Platform-tools components are required — you can't develop or build an -application without these. Make sure you keep these up to date. | +Basic | +SDK Tools | +If you've just installed +the SDK starter package, then you already have the latest version of this component. The +SDK Tools component is required to develop an Android application. Make sure you keep this up to +date. | +
SDK Platform-tools | +This includes more tools that are required +for application development. These tools are platform-dependent and typically update only when +a new SDK platform is made available, in order to support new features in the platform. These +tools are always backward compatible with older platforms, but you must be sure that you have +the latest version of these tools when you install a new SDK platform. | ||||
+ | ++ | ||||
Recommended | +Recommended (plus Basic) |
Documentation | The Documentation component is useful because it lets you work offline and also look up API reference information from inside Eclipse. | @@ -292,10 +347,12 @@ debugging and testing. For Mac OS X and Linux platforms, no special driver is needed.||
+ | ++ | ||||
Full | +Full (plus Recommended) |
Google APIs | The Google APIs add-on gives your application access to the Maps external library, which makes it easy to display and manipulate Maps data in your @@ -314,13 +371,12 @@ applications on different platforms by running in an Android Virtual Device |
For step-by-step instructions on how to use the Android SDK and AVD Manager -to add components, see the Adding -SDK Components document.
+Once you've installed at least the basic configuration of SDK components, you're ready to start +developing Android apps. The next section describes the contents of the Android SDK to familiarize +you with the components you've just installed.
-For revision notes and other detailed information about individual SDK -components, see the documents listed under "Downloadable SDK Components" in -the navigation at left.
+For more information about using the Android SDK and AVD Manager, see the Adding SDK Components document.
docs/
Following the Hello World tutorial is an essential +
Following the Hello World tutorial is an essential first step in getting started with Android development.
Learn about Android
@@ -494,7 +550,7 @@ Android-powered device to run and test your application. and architectural concepts in a moderately complex application. -Following the Notepad tutorial is an excellent +
Following the Notepad tutorial is an excellent second step in getting started with Android development.
Explore some code
-- cgit v1.1