blob: 9d5e8c1ca3a5fa3e7b020791bfabb63e0c9012b2 [file] [log] [blame]
Scott Main6453dfb2012-10-23 14:14:18 -07001page.title=Setting Up an Existing IDE
Scott Main50e990c2012-06-21 17:14:39 -07002
3@jd:body
4
5
Scott Main6453dfb2012-10-23 14:14:18 -07006<p>You should have already downloaded the <a href="{@docRoot}sdk/index.html#ExistingIDE"
7>Android SDK Tools</a>. (If you downloaded the ADT Bundle, you should instead read
8<a href="{@docRoot}sdk/installing/bundle.html">Setting Up the ADT Bundle</a>.)</p>
Scott Main50e990c2012-06-21 17:14:39 -07009
Scott Main6453dfb2012-10-23 14:14:18 -070010<p>The SDK Tools package is not the complete SDK environment. It includes only the core SDK tools, which you can
Scott Main50e990c2012-06-21 17:14:39 -070011use to download the rest of the SDK packages (such as the latest system image).</p>
12
13
14<div id="win" class="docs" style="display:none">
Scott Main6453dfb2012-10-23 14:14:18 -070015
Scott Main50e990c2012-06-21 17:14:39 -070016<h3>Getting started on Windows</h3>
17<p>Your download package is an executable file that starts an installer. The installer checks your machine
18 for required tools, such as the proper Java SE Development Kit (JDK) and installs it if necessary.
19 The installer then saves the Android SDK Tools into a default location (or you can specify the location).</p>
20
Scott Main6453dfb2012-10-23 14:14:18 -070021<ol>
22<li>Double-click the executable ({@code .exe} file) to start the install.</li>
23<li>Make a note of the name and location in which it saves the SDK on your system&mdash;you will need to
Scott Main50e990c2012-06-21 17:14:39 -070024refer to the SDK directory later, when setting up the ADT plugin and when using
Scott Main6453dfb2012-10-23 14:14:18 -070025the SDK tools from the command line.</li>
Scott Main57655252012-11-13 00:44:17 -080026<li>Once the installation completes, the installer offers to start the Android SDK Manager.
Scott Main6453dfb2012-10-23 14:14:18 -070027If you'll be using Eclipse, <strong>do not</strong> start the Android SDK Manager,
28and instead move on to <a href="{@docRoot}sdk/installing/installing-adt.html"
29>Installing the Eclipse Plugin</a>.
30<p>If you're using a different IDE,
31start the SDK Manager and read <a href="{@docRoot}sdk/installing/adding-packages.html"
32>Adding Platforms and Packages</a>.</p>
33</li>
34</ol>
Scott Main50e990c2012-06-21 17:14:39 -070035
36</div>
37
38
39
40<div id="mac" class="docs" style="display:none">
41
42<h3>Getting started on Mac</h3>
43
Scott Main6453dfb2012-10-23 14:14:18 -070044<ol>
45<li>Unpack the ZIP file you've downloaded. By default, it's unpacked
46into a directory named <code>android-sdk-mac_x86</code>. Move it to an appropriate location on your machine,
47such as a "Development" directory in your home directory.
Scott Main50e990c2012-06-21 17:14:39 -070048
49<p>Make a note of the name and location of the SDK directory on your system&mdash;you will need to
50refer to the SDK directory later, when setting up the ADT plugin and when using
51the SDK tools from the command line.</p>
Scott Main6453dfb2012-10-23 14:14:18 -070052</li>
53<li>If you're using Eclipse, move on to <a href="{@docRoot}sdk/installing/installing-adt.html"
54>Installing the Eclipse Plugin</a>. Otherwise, if you're using a different IDE,
55read <a href="{@docRoot}sdk/installing/adding-packages.html"
56>Adding Platforms and Packages</a>.</li>
57</ol>
Scott Main50e990c2012-06-21 17:14:39 -070058
59</div>
60
61
62
63
64<div id="linux" class="docs" style="display:none">
65
66<h3>Getting started on Linux</h3>
67
Scott Main6453dfb2012-10-23 14:14:18 -070068<ol>
69<li>Unpack the {@code .tgz} file you've downloaded. By default, the SDK files are unpacked
70into a directory named <code>android-sdk-linux_x86</code>. Move it to an appropriate location on your machine,
71such as a "Development" directory in your home directory.
Scott Main50e990c2012-06-21 17:14:39 -070072
73<p>Make a note of the name and location of the SDK directory on your system&mdash;you will need to
74refer to the SDK directory later, when setting up the ADT plugin and when using
75the SDK tools from the command line.</p>
Scott Main6453dfb2012-10-23 14:14:18 -070076</li>
77<li>If you're using Eclipse, move on to <a href="{@docRoot}sdk/installing/installing-adt.html"
78>Installing the Eclipse Plugin</a>. Otherwise, if you're using a different IDE,
79read <a href="{@docRoot}sdk/installing/adding-packages.html"
80>Adding Platforms and Packages</a>.</li>
81</ol>
Scott Main50e990c2012-06-21 17:14:39 -070082
83
Scott Main6453dfb2012-10-23 14:14:18 -070084<h5 id="Troubleshooting"><a href='' class="expandable"
85 onclick="toggleExpandable(this,'#ubuntu-trouble');return false;"
86 >Troubleshooting Ubuntu</a></h5>
Scott Main50e990c2012-06-21 17:14:39 -070087
Scott Main6453dfb2012-10-23 14:14:18 -070088<div id="ubuntu-trouble" style="display:none">
Scott Main50e990c2012-06-21 17:14:39 -070089<ul>
90 <li>If you need help installing and configuring Java on your
91 development machine, you might find these resources helpful:
92 <ul>
93 <li><a href="https://help.ubuntu.com/community/Java">https://help.ubuntu.com/community/Java </a></li>
94 <li><a href="https://help.ubuntu.com/community/Java">https://help.ubuntu.com/community/JavaInstallation</a></li>
95 </ul>
96 </li>
97 <li>Here are the steps to install Java and Eclipse, prior to installing
98 the Android SDK and ADT Plugin.
99 <ol>
100 <li>If you are running a 64-bit distribution on your development
101 machine, you need to install the <code>ia32-libs</code> package using
102 <code>apt-get:</code>:
103 <pre>apt-get install ia32-libs</pre>
104 </li>
105 <li>Next, install Java: <pre>apt-get install sun-java6-jdk</pre></li>
Scott Maince6c8502012-06-27 00:55:18 -0700106 <li>The Ubuntu package manager does not currently offer an Eclipse 3.6
Scott Main50e990c2012-06-21 17:14:39 -0700107 version for download, so we recommend that you download Eclipse from
108 eclipse.org (<a
109 href="http://www.eclipse.org/downloads/">http://www.eclipse.org/
110 downloads/</a>). A Java or RCP version of Eclipse is recommended.</li>
111 <li>Follow the steps given in previous sections to install the SDK
112 and the ADT plugin. </li>
113 </ol>
114 </li>
115</ul>
Scott Main6453dfb2012-10-23 14:14:18 -0700116</div><!-- end ubuntu trouble -->
117
Scott Main50e990c2012-06-21 17:14:39 -0700118
119</div>
120
Scott Main6453dfb2012-10-23 14:14:18 -0700121<p style="margin-top:2em;"><a href='' onclick='showAll();return false;'>Information for other platforms</a></p>
Scott Main50e990c2012-06-21 17:14:39 -0700122
123<script>
124 var $osDocs;
125 if (navigator.appVersion.indexOf("Win")!=-1) {
126 $osDocs = $('#win');
127 } else if (navigator.appVersion.indexOf("Mac")!=-1) {
128 $osDocs = $('#mac');
129 } else if (navigator.appVersion.indexOf("Linux")!=-1) {
130 $osDocs = $('#linux');
131 }
132
133 if ($osDocs.length) {
134 // reveal only the docs for this OS
135 $osDocs.show();
136 } else {
137 // not running a compatible OS, so just show all the docs
138 $('.docs').show();
139 }
140
141 function showAll() {
142 $('.docs').each(function() {
143 if (!$(this).is(':visible')) {
144 console.log('show')
145 $(this).show();
146 } else {
147 console.log('hide')
148 $(this).hide();
149 $osDocs.show();
150 }
151 });
152 }
153</script>