1 page.title=Installing the Eclipse Plugin 2 adt.zip.version=23.0.4 3 adt.zip.download=ADT-23.0.4.zip 4 adt.zip.bytes=103336810 5 adt.zip.checksum=91a43dcf686ab73dec2c08b77243492b 6 7 @jd:body 8 9 10 11 <p>Android offers a custom plugin for the Eclipse IDE, called Android 12 Development Tools (ADT). This plugin provides a powerful, integrated 13 environment in which to develop Android apps. It extends the capabilities 14 of Eclipse to let you quickly set up new Android projects, build an app 15 UI, debug your app, and export signed (or unsigned) app packages (APKs) for distribution. 16 </p> 17 18 <p class="note"><strong>Note:</strong> You should install the ADT plugin 19 only if you already have an Eclipse installation that you want to continue using. If you do not 20 have Eclipse installed, you should instead <b><a href="{@docRoot}sdk/index.html">install 21 the complete Android SDK</a></b>, which includes the latest IDE for Android developers.</p> 22 23 <p>Your existing Eclipse installation must meet these requirements:</p> 24 <ul> 25 <li><a href="http://eclipse.org/mobile/">Eclipse</a> 3.7.2 (Indigo) or greater 26 <p class="note"><strong>Note:</strong> Eclipse 3.6 (Helios) is no longer 27 supported with the latest version of ADT.</p></li> 28 <li>Eclipse <a href="http://www.eclipse.org/jdt">JDT</a> plugin (included 29 in most Eclipse IDE packages) </li> 30 <li><a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html">JDK 6</a> 31 (JRE alone is not sufficient)</li> 32 <li><strong>Not</strong> compatible with GNU Compiler for Java (gcj)</li> 33 </ul> 34 35 36 <h2 id="Download">Download the ADT Plugin</h2> 37 38 <p>To add the ADT plugin to Eclipse:</p> 39 <ol> 40 <li>Start Eclipse, then select <strong>Help</strong> > <strong>Install New 41 Software</strong>.</li> 42 <li>Click <strong>Add</strong>, in the top-right corner.</li> 43 <li>In the Add Repository dialog that appears, enter "ADT Plugin" for the <em>Name</em> and the 44 following URL for the <em>Location</em>: 45 <pre>https://dl-ssl.google.com/android/eclipse/</pre> 46 <p class="note"><strong>Note:</strong> The Android Developer Tools update site requires 47 a secure connection. Make sure the update site URL you enter starts with HTTPS.</p> 48 </li> 49 <li>Click <strong>OK</strong>.</li> 50 <li>In the Available Software dialog, select the checkbox next to Developer Tools and click 51 <strong>Next</strong>.</li> 52 <li>In the next window, you'll see a list of the tools to be downloaded. Click 53 <strong>Next</strong>. </li> 54 <li>Read and accept the license agreements, then click <strong>Finish</strong>. 55 <p>If you get a security warning saying that the authenticity or validity of 56 the software can't be established, click <strong>OK</strong>.</p></li> 57 <li>When the installation completes, restart Eclipse. </li> 58 </ol> 59 60 61 62 <h2 id="Configure">Configure the ADT Plugin</h2> 63 64 <p>Once Eclipse restarts, you 65 must specify the location of your Android SDK directory:</p> 66 67 <ol> 68 <li>In the "Welcome to Android Development" window that appears, select <strong>Use 69 existing SDKs</strong>.</li> 70 <li>Browse and select the location of the Android SDK directory you recently 71 downloaded and unpacked.</li> 72 <li>Click <strong>Next</strong>.</li> 73 </ol> 74 75 <p>Your Eclipse IDE is now set up to develop Android apps, but you need to add 76 the latest SDK platform tools and an Android platform to your environment. 77 To get these packages for your SDK, continue to 78 <a href="{@docRoot}sdk/installing/adding-packages.html">Adding Platforms and Packages</a>.</p> 79 80 81 <h2 id="Troubleshooting">Troubleshooting ADT Installation</h2> 82 83 <p>If you are having trouble downloading the ADT plugin after following the 84 steps above and you are behind a firewall (such as a corporate firewall), make sure that 85 you have properly configured your proxy settings in Eclipse. In Eclipse, 86 you can configure proxy information from the main Eclipse menu in 87 <strong>Window</strong> (on Mac OS X, <strong>Eclipse</strong>) > 88 <strong>Preferences</strong> > <strong>General</strong> > <strong>Network 89 Connections</strong>. 90 </p> 91 92 <p>If you are still unable to use Eclipse to download the ADT plugin as a 93 remote update site, you can download the ADT zip file to your local machine and 94 manually install it:</p> 95 96 <ol> 97 <li>Download the ADT Plugin zip file (do not unpack it): 98 99 <table class="download"> 100 <tr> 101 <th>Package</th> 102 <th>Size</th> 103 <th>MD5 Checksum</th> 104 </tr> 105 <tr> 106 <td> 107 <a href="https://dl.google.com/android/{@adtZipDownload}">{@adtZipDownload}</a> 108 </td> 109 <td>{@adtZipBytes} bytes</td> 110 <td>{@adtZipChecksum}</td> 111 </tr> 112 </table> 113 </li> 114 115 </li> 116 <li>Start Eclipse, then select <strong>Help</strong> > <strong>Install New 117 Software</strong>.</li> 118 <li>Click <strong>Add</strong>, in the top-right corner.</li> 119 <li>In the Add Repository dialog, click <strong>Archive</strong>.</li> 120 <li>Select the downloaded {@adtZipDownload} file and click <strong>OK</strong>.</li> 121 <li>Enter "ADT Plugin" for the name and click <strong>OK</strong>. 122 <li>In the Available Software dialog, select the checkbox next to Developer Tools and click 123 <strong>Next</strong>.</li> 124 <li>In the next window, you'll see a list of the tools to be downloaded. Click 125 <strong>Next</strong>. </li> 126 <li>Read and accept the license agreements, then click <strong>Finish</strong>. 127 <p>If you get a security warning saying that the authenticity or validity of 128 the software can't be established, click <strong>OK</strong>.</p></li> 129 <li>When the installation completes, restart Eclipse. </li> 130 </ol> 131 132 <p>To update your plugin once you've installed using the zip file, you will have 133 to follow these steps again instead of the default update instructions.</p> 134 135 <h4>Other install errors</h4> 136 137 <p>Note that there are features of ADT that require some optional 138 Eclipse packages (for example, WST). If you encounter an error when 139 installing ADT, your Eclipse installion might not include these packages. 140 For information about how to quickly add the necessary packages to your 141 Eclipse installation, see the troubleshooting topic 142 <a href="{@docRoot}resources/faq/troubleshooting.html#installeclipsecomponents">ADT 143 Installation Error: "requires plug-in org.eclipse.wst.sse.ui"</a>.</p> 144 145 <h4>For Linux users</h4> 146 <p>If you encounter this error when installing the ADT Plugin for Eclipse: 147 <pre> 148 An error occurred during provisioning. 149 Cannot connect to keystore. 150 JKS</pre> 151 <p> 152 ...then your development machine lacks a suitable Java VM. Installing Sun 153 Java 6 will resolve this issue and you can then reinstall the ADT 154 Plugin.</p> 155 156
