Gitiles
Code Review Sign In
review.blissroms.org / platform_build_make / badffa84327de8154ea3ba96dcf908478c4d4a17 / . / tools / droiddoc / templates-sdk / sdkpage.cs
blob: 77bb9599844a0a2f64ec33b316a096872d7478fc [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
Scott Mainbadffa82010-11-08 12:28:14 -0800[diff] [blame^]165 <p>Welcome Developers! If you are new to the Android SDK, please read the steps below, for an
166overview of how to set up the SDK. </p>
Dirk Dougherty4b2eb972010-03-08 17:31:26 -0800[diff] [blame]167
Scott Mainf086a6e2010-10-27 22:35:24 -0700[diff] [blame]168 <p>If you're already using the Android SDK, you should
169update to the latest tools or platform using the <em>Android SDK and AVD Manager</em>, rather than
170downloading a new SDK starter package. See <a
171href="{@docRoot}sdk/adding-components.html">Adding SDK Components</a>.</p>
Dirk Dougherty4b2eb972010-03-08 17:31:26 -0800[diff] [blame]172
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]173 <table class="download">
174 <tr>
175 <th>Platform</th>
176 <th>Package</th>
177 <th>Size</th>
178 <th>MD5 Checksum</th>
179 </tr>
180 <tr>
Scott Mainf086a6e2010-10-27 22:35:24 -0700[diff] [blame]181 <td rowspan="2">Windows</td>
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]182 <td>
Scott Maina1b358a2010-06-24 16:36:54 -0700[diff] [blame]183 <a onclick="onDownload(this)" href="http://dl.google.com/android/<?cs var:sdk.win_download
184?>"><?cs var:sdk.win_download ?></a>
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]185 </td>
186 <td><?cs var:sdk.win_bytes ?> bytes</td>
187 <td><?cs var:sdk.win_checksum ?></td>
188 </tr>
Scott Mainf086a6e2010-10-27 22:35:24 -0700[diff] [blame]189 <tr>
190 <!-- blank TD from Windows rowspan -->
191 <td>
192 <a onclick="onDownload(this)" href="http://dl.google.com/android/<?cs var:sdk.win_installer
193?>"><?cs var:sdk.win_installer ?></a> (Recommended)
194 </td>
195 <td><?cs var:sdk.win_installer_bytes ?> bytes</td>
196 <td><?cs var:sdk.win_installer_checksum ?></td>
197 </tr>
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]198 <tr class="alt-color">
199 <td>Mac OS X (intel)</td>
200 <td>
Scott Maina1b358a2010-06-24 16:36:54 -0700[diff] [blame]201 <a onclick="onDownload(this)" href="http://dl.google.com/android/<?cs var:sdk.mac_download
202?>"><?cs var:sdk.mac_download ?></a>
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]203 </td>
204 <td><?cs var:sdk.mac_bytes ?> bytes</td>
205 <td><?cs var:sdk.mac_checksum ?></td>
206 </tr>
207 <tr>
208 <td>Linux (i386)</td>
209 <td>
Scott Maina1b358a2010-06-24 16:36:54 -0700[diff] [blame]210 <a onclick="onDownload(this)" href="http://dl.google.com/android/<?cs var:sdk.linux_download
211?>"><?cs var:sdk.linux_download ?></a>
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]212 </td>
213 <td><?cs var:sdk.linux_bytes ?> bytes</td>
214 <td><?cs var:sdk.linux_checksum ?></td>
215 </tr>
Dirk Dougherty82a28812009-08-05 19:09:16 -0700[diff] [blame]216 <?cs if:adt.zip_download ?>
217 <tr class="alt-color">
218 <td>ADT Plugin for Eclipse <?cs var:adt.zip_version ?></td>
219 <td>
Dirk Doughertyc66c90a2009-09-16 10:11:01 -0700[diff] [blame]220 <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]221 </td>
222 <td><?cs var:adt.zip_bytes ?> bytes</td>
223 <td><?cs var:adt.zip_checksum ?></td>
224 </tr>
225 <?cs /if ?>
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]226 </table>
227
Scott Maina1b358a2010-06-24 16:36:54 -0700[diff] [blame]228
229<div id="next-steps" style="display:none">
Scott Mainf086a6e2010-10-27 22:35:24 -0700[diff] [blame]230 <p><b><em><span id="filename"></span></em> is now downloading. Follow the steps below to
231get started.</b></p>
Scott Maina1b358a2010-06-24 16:36:54 -0700[diff] [blame]232</div>
233
234<script type="text/javascript">
235function onDownload(link) {
Scott Maina1b358a2010-06-24 16:36:54 -0700[diff] [blame]236 $("#filename").text($(link).html());
237 $("#next-steps").show();
238}
239</script>
240
Dirk Dougherty82a28812009-08-05 19:09:16 -0700[diff] [blame]241 <?cs /if ?>
242 <?cs /if ?>
Scott Mainf086a6e2010-10-27 22:35:24 -0700[diff] [blame]243<?cs /if ?>
Dirk Dougherty82a28812009-08-05 19:09:16 -0700[diff] [blame]244
245<?cs if:android.whichdoc != "online" && sdk.preview ?>
246 <p>Welcome developers! The next release of the Android platform will be
Dirk Dougherty123bb122009-08-27 16:45:47 -0700[diff] [blame]247Android <?cs var:sdk.preview.version ?> and we are pleased to announce the
248availability of an early look SDK to give you a head-start on developing
249applications for it. </p>
Dirk Dougherty82a28812009-08-05 19:09:16 -0700[diff] [blame]250
Dirk Dougherty123bb122009-08-27 16:45:47 -0700[diff] [blame]251 <p>The Android <?cs var:sdk.preview.version ?> platform includes a variety of
252improvements and new features for users and developers. Additionally, the SDK
253itself introduces several new capabilities that enable you to develop
254applications more efficiently. See the <a
Scott Mainf086a6e2010-10-27 22:35:24 -0700[diff] [blame]255href="http://developer.android.com/sdk/preview/features.html">Android
Dirk Dougherty123bb122009-08-27 16:45:47 -0700[diff] [blame]256<?cs var:sdk.preview.version ?> Highlights</a> document for a list of
257highlights.</p>
Dirk Dougherty4e4c9192009-05-12 15:32:35 -0700[diff] [blame]258<?cs /if ?>
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]259
260 <?cs call:tag_list(root.descr) ?>
261
262<?cs /if ?>
263</div><!-- end jd-content -->
264
Dirk Dougherty19a4bd12009-04-24 11:30:32 -0700[diff] [blame]265<?cs if:!sdk.redirect ?>
266 <?cs include:"footer.cs" ?>
267<?cs /if ?>
268
The Android Open Source Project88b60792009-03-03 19:28:42 -0800[diff] [blame]269</div><!-- end doc-content -->
270
271<?cs include:"trailer.cs" ?>
272
273</body>
274</html>
275
276
277