Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 1 | page.title=Android SDK |
Scott Main | efd83af | 2009-10-14 09:11:41 -0700 | [diff] [blame] | 2 | sdk.redirect=0 |
| 3 | sdk.version=2.0 |
Scott Main | efd83af | 2009-10-14 09:11:41 -0700 | [diff] [blame] | 4 | sdk.date=October 2009 |
| 5 | |
Dirk Dougherty | bf15ce6 | 2009-10-23 19:17:12 -0700 | [diff] [blame^] | 6 | sdk.win_download=android-sdk_r3-windows.zip |
| 7 | sdk.win_bytes=23070805 |
| 8 | sdk.win_checksum=bd7b57d5df37bd55ea101e76b24260a8 |
Scott Main | efd83af | 2009-10-14 09:11:41 -0700 | [diff] [blame] | 9 | |
Dirk Dougherty | bf15ce6 | 2009-10-23 19:17:12 -0700 | [diff] [blame^] | 10 | sdk.mac_download=android-sdk_r3-mac.zip |
| 11 | sdk.mac_bytes=19653431 |
| 12 | sdk.mac_checksum=f6674bf45e5e36811eea7e584f0c1d67 |
Scott Main | efd83af | 2009-10-14 09:11:41 -0700 | [diff] [blame] | 13 | |
Dirk Dougherty | bf15ce6 | 2009-10-23 19:17:12 -0700 | [diff] [blame^] | 14 | sdk.linux_download=android-sdk_r3-linux.tgz |
| 15 | sdk.linux_bytes=15986291 |
| 16 | sdk.linux_checksum=3e1534e7fc15d154ff81616f0dc1545c |
Scott Main | efd83af | 2009-10-14 09:11:41 -0700 | [diff] [blame] | 17 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 18 | @jd:body |
| 19 | |
Scott Main | efd83af | 2009-10-14 09:11:41 -0700 | [diff] [blame] | 20 | |
Dirk Dougherty | bf15ce6 | 2009-10-23 19:17:12 -0700 | [diff] [blame^] | 21 | <h2 id="quickstart">Quick Start</h2> |
Scott Main | efd83af | 2009-10-14 09:11:41 -0700 | [diff] [blame] | 22 | |
Dirk Dougherty | bf15ce6 | 2009-10-23 19:17:12 -0700 | [diff] [blame^] | 23 | <p>The steps below provide an overview of how to get started with the Android |
| 24 | SDK. For detailed instructions, start with the <a |
| 25 | href="{@docRoot}sdk/installing.html">Installing</a> guide. </p> |
Scott Main | efd83af | 2009-10-14 09:11:41 -0700 | [diff] [blame] | 26 | |
Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 27 | <p><strong>0. Prepare your development computer</strong></p> |
Scott Main | efd83af | 2009-10-14 09:11:41 -0700 | [diff] [blame] | 28 | |
Dirk Dougherty | bf15ce6 | 2009-10-23 19:17:12 -0700 | [diff] [blame^] | 29 | <p>Read the <a href="{@docRoot}sdk/requirements.html">System Requirements</a> |
| 30 | document and make sure that your development computer meets the hardware and |
| 31 | software requirements for the Android SDK. Install any additional software |
| 32 | needed before downloading the Android SDK. In particular, if you plan to develop |
| 33 | Android applications in the Eclipse IDE using the ADT Plugin (see below), make |
| 34 | sure that you have the correct version of Eclipse installed. |
Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 35 | |
| 36 | <p><strong>1. Download and install the SDK starter package</strong></p> |
| 37 | |
Dirk Dougherty | bf15ce6 | 2009-10-23 19:17:12 -0700 | [diff] [blame^] | 38 | <p>Select a starter package from the table at the top of this page and download |
| 39 | it to your development computer. To install the SDK, simply unpack the starter |
| 40 | package to a safe location and then add the location to your PATH. </p> |
Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 41 | |
| 42 | <p><strong>2. Install the ADT Plugin for Eclipse</strong></p> |
| 43 | |
Dirk Dougherty | bf15ce6 | 2009-10-23 19:17:12 -0700 | [diff] [blame^] | 44 | <p>If you are developing in Eclipse, set up a remote update site and install the |
| 45 | Android Development Tools (ADT) plugin. For detailed instructions, see <a |
| 46 | href="{@docRoot}sdk/eclipse-adt.html">Installing and Updating ADT</a>.</p> |
Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 47 | |
Dirk Dougherty | eeb0b25 | 2009-10-22 16:08:32 -0700 | [diff] [blame] | 48 | <p><strong>3. Add Android platforms to your SDK</strong></p> |
Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 49 | |
Dirk Dougherty | bf15ce6 | 2009-10-23 19:17:12 -0700 | [diff] [blame^] | 50 | <p>Use the Android SDK and AVD Manager, included in the SDK starter package, to |
| 51 | add one or more Android platforms (for example, Android 1.6 or Android 2.0) to |
| 52 | your SDK. In most cases, you will want to download multiple platforms, so that |
| 53 | you can build your application on the lowest version you want to support, but |
| 54 | test against higher versions that you intend the application to run on. |
| 55 | Information about each platform is available at left, under "Downloadable SDK |
| 56 | Components."</p> |
Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 57 | |
Dirk Dougherty | bf15ce6 | 2009-10-23 19:17:12 -0700 | [diff] [blame^] | 58 | <p>To launch the Android SDK and AVD Manager on Windows, execute <code>SDK |
| 59 | Setup.exe</code>, at the root of the SDK directory. On Mac OS X or Linux, |
| 60 | execute the <code>android</code> tool in the <code><sdk>/tools/</code> |
| 61 | folder. For more information about how to add platforms and other components, |
| 62 | see <a href="{@docRoot}sdk/adding-components.html">Adding SDK Components</a>. |
| 63 | </p> |
Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 64 | |
Dirk Dougherty | eeb0b25 | 2009-10-22 16:08:32 -0700 | [diff] [blame] | 65 | <p><strong>4. Get the latest documentation</strong></p> |
Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 66 | |
Dirk Dougherty | bf15ce6 | 2009-10-23 19:17:12 -0700 | [diff] [blame^] | 67 | <p>If you develop while offline, use the Android SDK and AVD Manager to download |
| 68 | the latest documentation package. The documentation covers all versions of the |
| 69 | API and lets you filter out those versions that your application won't support. |
| 70 | Once installed, the documentation is also available to you directly from the |
| 71 | Eclipse IDE. </p> |
Scott Main | efd83af | 2009-10-14 09:11:41 -0700 | [diff] [blame] | 72 | |
Dirk Dougherty | eeb0b25 | 2009-10-22 16:08:32 -0700 | [diff] [blame] | 73 | <p><strong>5. Download other SDK components</strong></p> |
Scott Main | efd83af | 2009-10-14 09:11:41 -0700 | [diff] [blame] | 74 | |
Dirk Dougherty | bf15ce6 | 2009-10-23 19:17:12 -0700 | [diff] [blame^] | 75 | <p>You can use the Android SDK and AVD Manager to download other SDK components, |
| 76 | such as the SDK add-ons. An SDK add-on provides a development environment for an |
| 77 | Android external library or a customized Android system image. For example, the |
| 78 | Google APIs Add-On lets you develop an application that takes advantage of the |
| 79 | Google Maps external library. </p> |
Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 80 | |
Dirk Dougherty | eeb0b25 | 2009-10-22 16:08:32 -0700 | [diff] [blame] | 81 | <p><strong>6. Get started with an application project</strong></p> |
Scott Main | efd83af | 2009-10-14 09:11:41 -0700 | [diff] [blame] | 82 | |
Dirk Dougherty | bf15ce6 | 2009-10-23 19:17:12 -0700 | [diff] [blame^] | 83 | <p>Once you've set up your SDK, the next step is to start a new application |
| 84 | project or move existing applications into the new SDK.</p> |
Scott Main | efd83af | 2009-10-14 09:11:41 -0700 | [diff] [blame] | 85 | |
Dirk Dougherty | bf15ce6 | 2009-10-23 19:17:12 -0700 | [diff] [blame^] | 86 | <p>If you are new to Android, you can use the <a |
| 87 | href="{@docRoot}guide/tutorials/hello-world.html">Hello World</a> tutorial to |
| 88 | get started quickly. <a href="{@docRoot}sdk/installing.html#NextSteps">Next |
| 89 | Steps</a> offers other suggestions of how to begin. Welcome!</p> |