160 lines
6.0 KiB
Plaintext
160 lines
6.0 KiB
Plaintext
page.title=Installing the Eclipse Plugin
|
|
adt.zip.version=21.0.0
|
|
adt.zip.download=ADT-21.0.0.zip
|
|
adt.zip.bytes=13556487
|
|
adt.zip.checksum=7db4eaae5df6a34fd853317a2bd8250b
|
|
|
|
@jd:body
|
|
|
|
|
|
|
|
<p>Android offers a custom plugin for the Eclipse IDE, called Android
|
|
Development Tools (ADT). This plugin provides a powerful, integrated
|
|
environment in which to develop Android apps. It extends the capabilities
|
|
of Eclipse to let you quickly set up new Android projects, build an app
|
|
UI, debug your app, and export signed (or unsigned) app packages (APKs) for distribution.
|
|
</p>
|
|
|
|
<p>If you need to install Eclipse, you can download it from <a href=
|
|
"http://eclipse.org/mobile/">eclipse.org/mobile</a>.</p>
|
|
|
|
|
|
<p class="note"><strong>Note:</strong> 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.</p>
|
|
|
|
|
|
|
|
<h2 id="Download">Download the ADT Plugin</h2>
|
|
|
|
|
|
<ol>
|
|
<li>Start Eclipse, then select <strong>Help</strong> > <strong>Install New
|
|
Software</strong>.</li>
|
|
<li>Click <strong>Add</strong>, in the top-right corner.</li>
|
|
<li>In the Add Repository dialog that appears, enter "ADT Plugin" for the <em>Name</em> and the
|
|
following URL for the <em>Location</em>:
|
|
<pre>https://dl-ssl.google.com/android/eclipse/</pre>
|
|
</li>
|
|
<li>Click <strong>OK</strong>.
|
|
<p>If you have trouble acquiring the plugin, try using "http" in the Location URL,
|
|
instead of "https" (https is preferred for security reasons).</p></li>
|
|
<li>In the Available Software dialog, select the checkbox next to Developer Tools and click
|
|
<strong>Next</strong>.</li>
|
|
<li>In the next window, you'll see a list of the tools to be downloaded. Click
|
|
<strong>Next</strong>. </li>
|
|
<li>Read and accept the license agreements, then click <strong>Finish</strong>.
|
|
<p>If you get a security warning saying that the authenticity or validity of
|
|
the software can't be established, click <strong>OK</strong>.</p></li>
|
|
<li>When the installation completes, restart Eclipse. </li>
|
|
</ol>
|
|
|
|
|
|
|
|
|
|
<h2 id="Configure">Configure the ADT Plugin</h2>
|
|
|
|
<p>Once Eclipse restarts, you
|
|
must specify the location of your Android SDK directory:</p>
|
|
|
|
<ol>
|
|
<li>In the "Welcome to Android Development" window that appears, select <strong>Use
|
|
existing SDKs</strong>.</li>
|
|
<li>Browse and select the location of the Android SDK directory you recently
|
|
downloaded and unpacked.</li>
|
|
<li>Click <strong>Next</strong>.</li>
|
|
</ol>
|
|
|
|
<p>Your Eclipse IDE is now set up to develop Android apps, but you need to add
|
|
the latest SDK platform tools and an Android platform to your environment.
|
|
To get these packages for your SDK, continue to
|
|
<a href="{@docRoot}sdk/installing/adding-packages.html">Adding Platforms and Packages</a>.</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<h2 id="Troubleshooting">Troubleshooting Installation</h2>
|
|
|
|
<p> If you are having trouble downloading the ADT plugin after following the
|
|
steps above, here are some suggestions: </p>
|
|
|
|
<ul>
|
|
<li>If Eclipse can not find the remote update site containing the ADT plugin,
|
|
try changing the remote site URL to use http, rather than https. That is, set
|
|
the Location for the remote site to:
|
|
<pre>http://dl-ssl.google.com/android/eclipse/</pre></li>
|
|
<li>If you are behind a firewall (such as a corporate firewall), make sure that
|
|
you have properly configured your proxy settings in Eclipse. In Eclipse,
|
|
you can configure proxy information from the main Eclipse menu in
|
|
<strong>Window</strong> (on Mac OS X, <strong>Eclipse</strong>) >
|
|
<strong>Preferences</strong> > <strong>General</strong> > <strong>Network
|
|
Connections</strong>.</li>
|
|
</ul>
|
|
|
|
<p> 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 it:</p>
|
|
|
|
<ol>
|
|
<li>Download the ADT Plugin zip file (do not unpack it):
|
|
|
|
<table class="download">
|
|
<tr>
|
|
<th>Package</th>
|
|
<th>Size</th>
|
|
<th>MD5 Checksum</th>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<a href="http://dl.google.com/android/{@adtZipDownload}">{@adtZipDownload}</a>
|
|
</td>
|
|
<td>{@adtZipBytes} bytes</td>
|
|
<td>{@adtZipChecksum}</td>
|
|
</tr>
|
|
</table>
|
|
</li>
|
|
|
|
</li>
|
|
<li>Start Eclipse, then select <strong>Help</strong> > <strong>Install New
|
|
Software</strong>.</li>
|
|
<li>Click <strong>Add</strong>, in the top-right corner.</li>
|
|
<li>In the Add Repository dialog, click <strong>Archive</strong>.</li>
|
|
<li>Select the downloaded {@adtZipDownload} file and click <strong>OK</strong>.</li>
|
|
<li>Enter "ADT Plugin" for the name and click <strong>OK</strong>.
|
|
<li>In the Available Software dialog, select the checkbox next to Developer Tools and click
|
|
<strong>Next</strong>.</li>
|
|
<li>In the next window, you'll see a list of the tools to be downloaded. Click
|
|
<strong>Next</strong>. </li>
|
|
<li>Read and accept the license agreements, then click <strong>Finish</strong>.
|
|
<p>If you get a security warning saying that the authenticity or validity of
|
|
the software can't be established, click <strong>OK</strong>.</p></li>
|
|
<li>When the installation completes, restart Eclipse. </li>
|
|
</ol>
|
|
|
|
<p>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.</p>
|
|
|
|
<h4>Other install errors</h4>
|
|
|
|
<p>Note that there are features of ADT that require some optional
|
|
Eclipse packages (for example, WST). If you encounter an error when
|
|
installing ADT, your Eclipse installion might not include these packages.
|
|
For information about how to quickly add the necessary packages to your
|
|
Eclipse installation, see the troubleshooting topic
|
|
<a href="{@docRoot}resources/faq/troubleshooting.html#installeclipsecomponents">ADT
|
|
Installation Error: "requires plug-in org.eclipse.wst.sse.ui"</a>.</p>
|
|
|
|
<h4>For Linux users</h4>
|
|
<p>If you encounter this error when installing the ADT Plugin for Eclipse:
|
|
<pre>
|
|
An error occurred during provisioning.
|
|
Cannot connect to keystore.
|
|
JKS</pre>
|
|
<p>
|
|
...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.</p>
|
|
|