blob: f467492068c1979749447691a91c8186f1940708 [file] [log] [blame]
Dirk Doughertyee58d1b2009-10-16 15:25:15 -07001page.title=Android SDK
Scott Mainefd83af2009-10-14 09:11:41 -07002sdk.redirect=0
3sdk.version=2.0
Scott Mainefd83af2009-10-14 09:11:41 -07004sdk.date=October 2009
5
Dirk Doughertybf15ce62009-10-23 19:17:12 -07006sdk.win_download=android-sdk_r3-windows.zip
7sdk.win_bytes=23070805
8sdk.win_checksum=bd7b57d5df37bd55ea101e76b24260a8
Scott Mainefd83af2009-10-14 09:11:41 -07009
Dirk Doughertybf15ce62009-10-23 19:17:12 -070010sdk.mac_download=android-sdk_r3-mac.zip
11sdk.mac_bytes=19653431
12sdk.mac_checksum=f6674bf45e5e36811eea7e584f0c1d67
Scott Mainefd83af2009-10-14 09:11:41 -070013
Dirk Doughertybf15ce62009-10-23 19:17:12 -070014sdk.linux_download=android-sdk_r3-linux.tgz
15sdk.linux_bytes=15986291
16sdk.linux_checksum=3e1534e7fc15d154ff81616f0dc1545c
Scott Mainefd83af2009-10-14 09:11:41 -070017
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080018@jd:body
19
Scott Mainefd83af2009-10-14 09:11:41 -070020
Dirk Doughertybf15ce62009-10-23 19:17:12 -070021<h2 id="quickstart">Quick Start</h2>
Scott Mainefd83af2009-10-14 09:11:41 -070022
Dirk Doughertybf15ce62009-10-23 19:17:12 -070023<p>The steps below provide an overview of how to get started with the Android
24SDK. For detailed instructions, start with the <a
25href="{@docRoot}sdk/installing.html">Installing</a> guide. </p>
Scott Mainefd83af2009-10-14 09:11:41 -070026
Dirk Doughertyee58d1b2009-10-16 15:25:15 -070027<p><strong>0. Prepare your development computer</strong></p>
Scott Mainefd83af2009-10-14 09:11:41 -070028
Dirk Doughertybf15ce62009-10-23 19:17:12 -070029<p>Read the <a href="{@docRoot}sdk/requirements.html">System Requirements</a>
30document and make sure that your development computer meets the hardware and
31software requirements for the Android SDK. Install any additional software
32needed before downloading the Android SDK. In particular, if you plan to develop
33Android applications in the Eclipse IDE using the ADT Plugin (see below), make
34sure that you have the correct version of Eclipse installed.
Dirk Doughertyee58d1b2009-10-16 15:25:15 -070035
36<p><strong>1. Download and install the SDK starter package</strong></p>
37
Dirk Doughertybf15ce62009-10-23 19:17:12 -070038<p>Select a starter package from the table at the top of this page and download
39it to your development computer. To install the SDK, simply unpack the starter
40package to a safe location and then add the location to your PATH. </p>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -070041
42<p><strong>2. Install the ADT Plugin for Eclipse</strong></p>
43
Dirk Doughertybf15ce62009-10-23 19:17:12 -070044<p>If you are developing in Eclipse, set up a remote update site and install the
45Android Development Tools (ADT) plugin. For detailed instructions, see <a
46href="{@docRoot}sdk/eclipse-adt.html">Installing and Updating ADT</a>.</p>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -070047
Dirk Doughertyeeb0b252009-10-22 16:08:32 -070048<p><strong>3. Add Android platforms to your SDK</strong></p>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -070049
Dirk Doughertybf15ce62009-10-23 19:17:12 -070050<p>Use the Android SDK and AVD Manager, included in the SDK starter package, to
51add one or more Android platforms (for example, Android 1.6 or Android 2.0) to
52your SDK. In most cases, you will want to download multiple platforms, so that
53you can build your application on the lowest version you want to support, but
54test against higher versions that you intend the application to run on.
55Information about each platform is available at left, under "Downloadable SDK
56Components."</p>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -070057
Dirk Doughertybf15ce62009-10-23 19:17:12 -070058<p>To launch the Android SDK and AVD Manager on Windows, execute <code>SDK
59Setup.exe</code>, at the root of the SDK directory. On Mac OS X or Linux,
60execute the <code>android</code> tool in the <code>&lt;sdk&gt;/tools/</code>
61folder. For more information about how to add platforms and other components,
62see <a href="{@docRoot}sdk/adding-components.html">Adding SDK Components</a>.
63</p>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -070064
Dirk Doughertyeeb0b252009-10-22 16:08:32 -070065<p><strong>4. Get the latest documentation</strong></p>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -070066
Dirk Doughertybf15ce62009-10-23 19:17:12 -070067<p>If you develop while offline, use the Android SDK and AVD Manager to download
68the latest documentation package. The documentation covers all versions of the
69API and lets you filter out those versions that your application won't support.
70Once installed, the documentation is also available to you directly from the
71Eclipse IDE. </p>
Scott Mainefd83af2009-10-14 09:11:41 -070072
Dirk Doughertyeeb0b252009-10-22 16:08:32 -070073<p><strong>5. Download other SDK components</strong></p>
Scott Mainefd83af2009-10-14 09:11:41 -070074
Dirk Doughertybf15ce62009-10-23 19:17:12 -070075<p>You can use the Android SDK and AVD Manager to download other SDK components,
76such as the SDK add-ons. An SDK add-on provides a development environment for an
77Android external library or a customized Android system image. For example, the
78Google APIs Add-On lets you develop an application that takes advantage of the
79Google Maps external library. </p>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -070080
Dirk Doughertyeeb0b252009-10-22 16:08:32 -070081<p><strong>6. Get started with an application project</strong></p>
Scott Mainefd83af2009-10-14 09:11:41 -070082
Dirk Doughertybf15ce62009-10-23 19:17:12 -070083<p>Once you've set up your SDK, the next step is to start a new application
84project or move existing applications into the new SDK.</p>
Scott Mainefd83af2009-10-14 09:11:41 -070085
Dirk Doughertybf15ce62009-10-23 19:17:12 -070086<p>If you are new to Android, you can use the <a
87href="{@docRoot}guide/tutorials/hello-world.html">Hello World</a> tutorial to
88get started quickly. <a href="{@docRoot}sdk/installing.html#NextSteps">Next
89Steps</a> offers other suggestions of how to begin. Welcome!</p>