Gitiles
Code Review Sign In
review.blissroms.org / platform_build_make / c775c754f13bd54b7d5da8c28186cdd8167dc53a / . / tools / droiddoc / templates-sdk / sdkpage.cs
blob: cc7f5f5d9aeeaf6539f0162a41283aed8c0a3de8 [file] [log] [blame]
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]1<?cs include:"doctype.cs" ?>
2<?cs include:"macros.cs" ?>
3<html>
4<?cs if:sdk.redirect ?>
5 <head>
6 <title>Redirecting...</title>
Scott Mainf086a6e2010-10-27 22:35:24 -0700[diff] [blame]7 <meta http-equiv="refresh" content="0;url=<?cs var:toroot ?>sdk/<?cs
8 if:sdk.redirect.path ?><?cs var:sdk.redirect.path ?><?cs
Dirk Doughertye1233852010-03-03 14:34:51 -0800[diff] [blame]9 else ?>index.html<?cs /if ?>">
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]10 <link href="<?cs var:toroot ?>assets/android-developer-docs.css" rel="stylesheet" type="text/css" />
11 </head>
12<?cs else ?>
13 <?cs include:"head_tag.cs" ?>
14<?cs /if ?>
15<body class="gc-documentation">
16<a name="top"></a>
17<?cs call:custom_masthead() ?>
18
19<?cs call:sdk_nav() ?>
20
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]21<?cs if:sdk.redirect ?>
Dirk Doughertyd8cfce02009-07-15 16:37:21 -0700[diff] [blame]22
Dirk Dougherty19a4bd12009-04-24 11:30:32 -0700[diff] [blame]23<div class="g-unit">
24 <div id="jd-content">
Scott Mainf086a6e2010-10-27 22:35:24 -0700[diff] [blame]25 <p>Redirecting to
26 <a href="<?cs var:toroot ?>sdk/<?cs
Scott Mainb66a5c02010-07-08 11:29:28 -0700[diff] [blame]27 if:sdk.redirect.path ?><?cs var:sdk.redirect.path ?><?cs
28 else ?>index.html<?cs /if ?>"><?cs
29 if:sdk.redirect.path ?><?cs var:sdk.redirect.path ?><?cs
30 else ?>Download the SDK<?cs /if ?>
Dirk Doughertyd8cfce02009-07-15 16:37:21 -0700[diff] [blame]31 </a> ...</p>
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]32<?cs else ?>
Dirk Dougherty19a4bd12009-04-24 11:30:32 -0700[diff] [blame]33<div class="g-unit" id="doc-content" >
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]34 <div id="jd-header" class="guide-header" >
35 <span class="crumb">&nbsp;</span>
Dirk Dougherty3d3d7b72009-10-21 19:52:52 -0700[diff] [blame]36 <h1><?cs if:android.whichdoc == "online" ?>Download the <?cs /if ?><?cs var:page.title ?></h1>
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]37 </div>
38
Dirk Dougherty19a4bd12009-04-24 11:30:32 -0700[diff] [blame]39 <div id="jd-content">
Scott Mainf086a6e2010-10-27 22:35:24 -0700[diff] [blame]40 <?cs
41 if:ndk ?><?cs
42 else ?><?cs
43 if:android.whichdoc == "online" ?><p><em><?cs
44 var:sdk.date ?></em></p><?cs
Dirk Dougherty3d3d7b72009-10-21 19:52:52 -0700[diff] [blame]45 /if ?><?cs
46 /if ?>
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]47
48<?cs if:sdk.not_latest_version ?>
49 <div class="special">
50 <p><strong>This is NOT the current Android SDK release.</strong></p>
Dirk Dougherty3d3d7b72009-10-21 19:52:52 -0700[diff] [blame]51 <p><a href="/sdk/index.html">Download the current Android SDK</a></p>
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]52 </div>
53<?cs /if ?>
Dirk Doughertye6be85f2009-06-24 11:01:03 -0700[diff] [blame]54
Dirk Dougherty82a28812009-08-05 19:09:16 -0700[diff] [blame]55<?cs if:android.whichdoc != "online" && !android.preview ?>
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]56
Dirk Dougherty3d3d7b72009-10-21 19:52:52 -0700[diff] [blame]57<!-- <p>The sections below provide an overview of how to install the SDK package. </p> -->
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]58
59<?cs else ?>
Dirk Dougherty4e4c9192009-05-12 15:32:35 -0700[diff] [blame]60 <?cs if:ndk ?>
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]61
Robert Ly706e41e2010-11-02 18:35:43 -0700[diff] [blame]62<p>The Android NDK is a companion tool to the Android SDK that lets you build
63performance-critical portions of your apps in native code. It provides headers and
64libraries that allow you to build activities, handle user input, use hardware sensors,
65access application resources, and more, when programming in C or C++. If you write
66native code, your applications are still packaged into an .apk file and they still run
67inside of a virtual machine on the device. The fundamental Android application model
68does not change.</p>
69
Scott Mainec97fd32010-11-04 21:02:14 -0700[diff] [blame]70<p>Using native code does not result in an automatic performance increase,
Robert Ly706e41e2010-11-02 18:35:43 -0700[diff] [blame]71but always increases application complexity. If you have not run into any limitations
Scott Mainec97fd32010-11-04 21:02:14 -0700[diff] [blame]72using the Android framework APIs, you probably do not need the NDK. Read <a
73href="<?cs var:toroot ?>sdk/ndk/overview.html">What is the NDK?</a> for more information about what
74the NDK offers and whether it will be useful to you.
Robert Ly706e41e2010-11-02 18:35:43 -0700[diff] [blame]75</p>
76<p>
77The NDK is designed for use <em>only</em> in conjunction with the
Scott Mainec97fd32010-11-04 21:02:14 -0700[diff] [blame]78Android SDK. If you have not already installed and setup the <a
79href="http://developer.android.com/sdk/index.html">Android SDK</a>, please
Robert Ly706e41e2010-11-02 18:35:43 -0700[diff] [blame]80do so before downloading the NDK.
81</p>
Dirk Dougherty4e4c9192009-05-12 15:32:35 -0700[diff] [blame]82
Dirk Dougherty4e4c9192009-05-12 15:32:35 -0700[diff] [blame]83 <table class="download">
84 <tr>
85 <th>Platform</th>
86 <th>Package</th>
87 <th>Size</th>
88 <th>MD5 Checksum</th>
89 </tr>
90 <tr>
91 <td>Windows</td>
92 <td>
Dirk Doughertye6be85f2009-06-24 11:01:03 -0700[diff] [blame]93 <a href="http://dl.google.com/android/ndk/<?cs var:ndk.win_download ?>"><?cs var:ndk.win_download ?></a>
Dirk Dougherty4e4c9192009-05-12 15:32:35 -0700[diff] [blame]94 </td>
95 <td><?cs var:ndk.win_bytes ?> bytes</td>
96 <td><?cs var:ndk.win_checksum ?></td>
97 </tr>
98 <tr class="alt-color">
99 <td>Mac OS X (intel)</td>
100 <td>
Dirk Doughertye6be85f2009-06-24 11:01:03 -0700[diff] [blame]101 <a href="http://dl.google.com/android/ndk/<?cs var:ndk.mac_download ?>"><?cs var:ndk.mac_download ?></a>
Dirk Dougherty4e4c9192009-05-12 15:32:35 -0700[diff] [blame]102 </td>
103 <td><?cs var:ndk.mac_bytes ?> bytes</td>
104 <td><?cs var:ndk.mac_checksum ?></td>
105 </tr>
106 <tr>
Dirk Doughertye6be85f2009-06-24 11:01:03 -0700[diff] [blame]107 <td>Linux 32/64-bit (x86)</td>
Dirk Dougherty4e4c9192009-05-12 15:32:35 -0700[diff] [blame]108 <td>
Dirk Doughertye6be85f2009-06-24 11:01:03 -0700[diff] [blame]109 <a href="http://dl.google.com/android/ndk/<?cs var:ndk.linux_download ?>"><?cs var:ndk.linux_download ?></a>
Dirk Dougherty4e4c9192009-05-12 15:32:35 -0700[diff] [blame]110 </td>
111 <td><?cs var:ndk.linux_bytes ?> bytes</td>
112 <td><?cs var:ndk.linux_checksum ?></td>
113 </tr>
Dirk Dougherty4e4c9192009-05-12 15:32:35 -0700[diff] [blame]114 </table>
115
Dirk Dougherty82a28812009-08-05 19:09:16 -0700[diff] [blame]116 <?cs else ?><?cs if:android.whichdoc == "online" ?>
117
118 <?cs if:sdk.preview ?>
119 <p>Welcome developers! The next release of the Android platform will be
120 Android 1.6 and we are pleased to announce the availability of an early look
121 SDK to give you a head-start on developing applications for it. </p>
122
Dirk Dougherty123bb122009-08-27 16:45:47 -0700[diff] [blame]123 <p>The Android <?cs var:sdk.preview.version ?> platform includes a variety of
Scott Main462cc372009-10-23 16:19:37 -0700[diff] [blame]124 improvements and new features for users and developers. Additionally, the SDK
125 itself introduces several new capabilities that enable you to develop
126 applications more efficiently. See the <a href="features.html">Android <?cs
Scott Mainf086a6e2010-10-27 22:35:24 -0700[diff] [blame]127 var:sdk.preview.version ?> Platform Highlights</a> document for a list of
Scott Main462cc372009-10-23 16:19:37 -0700[diff] [blame]128 highlights.</p>
Scott Mainf086a6e2010-10-27 22:35:24 -0700[diff] [blame]129<?cs /if ?>
Scott Main462cc372009-10-23 16:19:37 -0700[diff] [blame]130<?cs # end if NDK ... the following is for the SDK ?>
Dirk Dougherty82a28812009-08-05 19:09:16 -0700[diff] [blame]131
Scott Mainf086a6e2010-10-27 22:35:24 -0700[diff] [blame]132<?cs #
Dirk Doughertye1233852010-03-03 14:34:51 -0800[diff] [blame]133 <div class="toggle-content special">
Scott Mainf086a6e2010-10-27 22:35:24 -0700[diff] [blame]134 <p>The Android SDK has changed! If you've worked with the Android SDK before,
Scott Main462cc372009-10-23 16:19:37 -0700[diff] [blame]135 you will notice several important differences:</p>
Scott Mainf086a6e2010-10-27 22:35:24 -0700[diff] [blame]136
Scott Main462cc372009-10-23 16:19:37 -0700[diff] [blame]137 <div class="toggle-content-toggleme" style="display:none">
Dirk Doughertyc2c5e502009-10-24 14:38:58 -0700[diff] [blame]138 <ul style="padding-bottom:.0;">
Scott Main462cc372009-10-23 16:19:37 -0700[diff] [blame]139 <li style="margin-top:.5em">The SDK downloadable package includes <em>only</em>
140 the latest version of the Android SDK Tools.</li>
141 <li>Once you've installed the SDK, you now use the Android SDK and AVD Manager
142 to download all of the SDK components that you need, such as Android platforms,
143 SDK add-ons, tools, and documentation. </li>
144 <li>The new approach is modular &mdash; you can install only the components you
145 need and update any or all components without affecting other parts of your
146 development environment.</li>
147 <li>In short, once you've installed the new SDK, you will not need to download
148 an SDK package again. Instead, you will use the Android SDK and AVD Manager to
149 keep your development environment up-to-date. </li>
150 </ul>
Dirk Doughertyc2c5e502009-10-24 14:38:58 -0700[diff] [blame]151 <p style="margin-top:0">If you are currently using the Android 1.6 SDK, you
Scott Mainf086a6e2010-10-27 22:35:24 -0700[diff] [blame]152 do not need to install the new SDK, because your existing SDK already
153 includes the Android SDK and AVD Manager tool. To develop against Android
154 2.0.1, for example, you can just download the Android 2.0.1 platform (and
155 updated SDK Tools) into your existing SDK. Refer to <a
Dirk Doughertyc2c5e502009-10-24 14:38:58 -0700[diff] [blame]156 href="adding-components.html">Adding SDK Components</a>.</p>
Scott Main462cc372009-10-23 16:19:37 -0700[diff] [blame]157 </div>
Scott Mainf086a6e2010-10-27 22:35:24 -0700[diff] [blame]158
Dirk Doughertye1233852010-03-03 14:34:51 -0800[diff] [blame]159 <a href='#' class='toggle-content-button show' onclick="toggleContent(this,true);return false;">
Scott Main462cc372009-10-23 16:19:37 -0700[diff] [blame]160 <span>show more</span><span style='display:none'>show less</span>
161 </a>
162 </div>
Dirk Doughertye1233852010-03-03 14:34:51 -0800[diff] [blame]163?>
Scott Maina1b358a2010-06-24 16:36:54 -0700[diff] [blame]164
Dirk Dougherty4b2eb972010-03-08 17:31:26 -0800[diff] [blame]165 <p>Welcome Developers! If you are new to the Android SDK, please read the <a
166href="#quickstart">Quick Start</a>, below, for an overview of how to install and
167set up the SDK. </p>
168
Scott Mainf086a6e2010-10-27 22:35:24 -0700[diff] [blame]169 <p>If you're already using the Android SDK, you should
170update to the latest tools or platform using the <em>Android SDK and AVD Manager</em>, rather than
171downloading a new SDK starter package. See <a
172href="{@docRoot}sdk/adding-components.html">Adding SDK Components</a>.</p>
Dirk Dougherty4b2eb972010-03-08 17:31:26 -0800[diff] [blame]173
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]174 <table class="download">
175 <tr>
176 <th>Platform</th>
177 <th>Package</th>
178 <th>Size</th>
179 <th>MD5 Checksum</th>
180 </tr>
181 <tr>
Scott Mainf086a6e2010-10-27 22:35:24 -0700[diff] [blame]182 <td rowspan="2">Windows</td>
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]183 <td>
Scott Maina1b358a2010-06-24 16:36:54 -0700[diff] [blame]184 <a onclick="onDownload(this)" href="http://dl.google.com/android/<?cs var:sdk.win_download
185?>"><?cs var:sdk.win_download ?></a>
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]186 </td>
187 <td><?cs var:sdk.win_bytes ?> bytes</td>
188 <td><?cs var:sdk.win_checksum ?></td>
189 </tr>
Scott Mainf086a6e2010-10-27 22:35:24 -0700[diff] [blame]190 <tr>
191 <!-- blank TD from Windows rowspan -->
192 <td>
193 <a onclick="onDownload(this)" href="http://dl.google.com/android/<?cs var:sdk.win_installer
194?>"><?cs var:sdk.win_installer ?></a> (Recommended)
195 </td>
196 <td><?cs var:sdk.win_installer_bytes ?> bytes</td>
197 <td><?cs var:sdk.win_installer_checksum ?></td>
198 </tr>
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]199 <tr class="alt-color">
200 <td>Mac OS X (intel)</td>
201 <td>
Scott Maina1b358a2010-06-24 16:36:54 -0700[diff] [blame]202 <a onclick="onDownload(this)" href="http://dl.google.com/android/<?cs var:sdk.mac_download
203?>"><?cs var:sdk.mac_download ?></a>
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]204 </td>
205 <td><?cs var:sdk.mac_bytes ?> bytes</td>
206 <td><?cs var:sdk.mac_checksum ?></td>
207 </tr>
208 <tr>
209 <td>Linux (i386)</td>
210 <td>
Scott Maina1b358a2010-06-24 16:36:54 -0700[diff] [blame]211 <a onclick="onDownload(this)" href="http://dl.google.com/android/<?cs var:sdk.linux_download
212?>"><?cs var:sdk.linux_download ?></a>
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]213 </td>
214 <td><?cs var:sdk.linux_bytes ?> bytes</td>
215 <td><?cs var:sdk.linux_checksum ?></td>
216 </tr>
Dirk Dougherty82a28812009-08-05 19:09:16 -0700[diff] [blame]217 <?cs if:adt.zip_download ?>
218 <tr class="alt-color">
219 <td>ADT Plugin for Eclipse <?cs var:adt.zip_version ?></td>
220 <td>
Dirk Doughertyc66c90a2009-09-16 10:11:01 -0700[diff] [blame]221 <a href="http://dl.google.com/android/<?cs var:adt.zip_download ?>"><?cs var:adt.zip_download ?></a>
Dirk Dougherty82a28812009-08-05 19:09:16 -0700[diff] [blame]222 </td>
223 <td><?cs var:adt.zip_bytes ?> bytes</td>
224 <td><?cs var:adt.zip_checksum ?></td>
225 </tr>
226 <?cs /if ?>
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]227 </table>
228
Scott Maina1b358a2010-06-24 16:36:54 -0700[diff] [blame]229
230<div id="next-steps" style="display:none">
Scott Mainf086a6e2010-10-27 22:35:24 -0700[diff] [blame]231 <p><b><em><span id="filename"></span></em> is now downloading. Follow the steps below to
232get started.</b></p>
Scott Maina1b358a2010-06-24 16:36:54 -0700[diff] [blame]233</div>
234
235<script type="text/javascript">
236function onDownload(link) {
Scott Maina1b358a2010-06-24 16:36:54 -0700[diff] [blame]237 $("#filename").text($(link).html());
238 $("#next-steps").show();
239}
240</script>
241
Dirk Dougherty82a28812009-08-05 19:09:16 -0700[diff] [blame]242 <?cs /if ?>
243 <?cs /if ?>
Scott Mainf086a6e2010-10-27 22:35:24 -0700[diff] [blame]244<?cs /if ?>
Dirk Dougherty82a28812009-08-05 19:09:16 -0700[diff] [blame]245
246<?cs if:android.whichdoc != "online" && sdk.preview ?>
247 <p>Welcome developers! The next release of the Android platform will be
Dirk Dougherty123bb122009-08-27 16:45:47 -0700[diff] [blame]248Android <?cs var:sdk.preview.version ?> and we are pleased to announce the
249availability of an early look SDK to give you a head-start on developing
250applications for it. </p>
Dirk Dougherty82a28812009-08-05 19:09:16 -0700[diff] [blame]251
Dirk Dougherty123bb122009-08-27 16:45:47 -0700[diff] [blame]252 <p>The Android <?cs var:sdk.preview.version ?> platform includes a variety of
253improvements and new features for users and developers. Additionally, the SDK
254itself introduces several new capabilities that enable you to develop
255applications more efficiently. See the <a
Scott Mainf086a6e2010-10-27 22:35:24 -0700[diff] [blame]256href="http://developer.android.com/sdk/preview/features.html">Android
Dirk Dougherty123bb122009-08-27 16:45:47 -0700[diff] [blame]257<?cs var:sdk.preview.version ?> Highlights</a> document for a list of
258highlights.</p>
Dirk Dougherty4e4c9192009-05-12 15:32:35 -0700[diff] [blame]259<?cs /if ?>
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]260
261 <?cs call:tag_list(root.descr) ?>
262
263<?cs /if ?>
264</div><!-- end jd-content -->
265
Dirk Dougherty19a4bd12009-04-24 11:30:32 -0700[diff] [blame]266<?cs if:!sdk.redirect ?>
267 <?cs include:"footer.cs" ?>
268<?cs /if ?>
269
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]270</div><!-- end doc-content -->
271
272<?cs include:"trailer.cs" ?>
273
274</body>
275</html>
276
277
278