xref: /aosp_15_r20/build/make/tools/droiddoc/templates-pdk/sdkpage.cs (revision 9e94795a3d4ef5c1d47486f9a02bb378756cea8a)
1*9e94795aSAndroid Build Coastguard Worker <?cs include:"doctype.cs" ?>
2*9e94795aSAndroid Build Coastguard Worker <?cs include:"macros.cs" ?>
3*9e94795aSAndroid Build Coastguard Worker <html>
4*9e94795aSAndroid Build Coastguard Worker <?cs if:sdk.redirect ?>
5*9e94795aSAndroid Build Coastguard Worker   <head>
6*9e94795aSAndroid Build Coastguard Worker     <title>Redirecting...</title>
7*9e94795aSAndroid Build Coastguard Worker     <meta http-equiv="refresh" content="0;url=<?cs var:toroot ?>sdk/<?cs
8*9e94795aSAndroid Build Coastguard Worker       if:sdk.redirect.path ?><?cs var:sdk.redirect.path ?><?cs
9*9e94795aSAndroid Build Coastguard Worker       else ?>index.html<?cs /if ?>">
10*9e94795aSAndroid Build Coastguard Worker     <link href="<?cs var:toroot ?>assets/android-developer-docs.css" rel="stylesheet" type="text/css" />
11*9e94795aSAndroid Build Coastguard Worker   </head>
12*9e94795aSAndroid Build Coastguard Worker <?cs else ?>
13*9e94795aSAndroid Build Coastguard Worker   <?cs include:"head_tag.cs" ?>
14*9e94795aSAndroid Build Coastguard Worker <?cs /if ?>
15*9e94795aSAndroid Build Coastguard Worker <body class="gc-documentation" itemscope itemtype="http://schema.org/CreativeWork">
16*9e94795aSAndroid Build Coastguard Worker <a name="top"></a>
17*9e94795aSAndroid Build Coastguard Worker <?cs call:custom_masthead() ?>
18*9e94795aSAndroid Build Coastguard Worker 
19*9e94795aSAndroid Build Coastguard Worker <?cs call:sdk_nav() ?>
20*9e94795aSAndroid Build Coastguard Worker 
21*9e94795aSAndroid Build Coastguard Worker <?cs if:sdk.redirect ?>
22*9e94795aSAndroid Build Coastguard Worker 
23*9e94795aSAndroid Build Coastguard Worker <div class="g-unit">
24*9e94795aSAndroid Build Coastguard Worker   <div id="jd-content">
25*9e94795aSAndroid Build Coastguard Worker     <p>Redirecting to
26*9e94795aSAndroid Build Coastguard Worker     <a href="<?cs var:toroot ?>sdk/<?cs
27*9e94795aSAndroid Build Coastguard Worker       if:sdk.redirect.path ?><?cs var:sdk.redirect.path ?><?cs
28*9e94795aSAndroid Build Coastguard Worker       else ?>index.html<?cs /if ?>"><?cs
29*9e94795aSAndroid Build Coastguard Worker       if:sdk.redirect.path ?><?cs var:sdk.redirect.path ?><?cs
30*9e94795aSAndroid Build Coastguard Worker       else ?>Download the SDK<?cs /if ?>
31*9e94795aSAndroid Build Coastguard Worker     </a> ...</p>
32*9e94795aSAndroid Build Coastguard Worker 
33*9e94795aSAndroid Build Coastguard Worker <?cs else ?>
34*9e94795aSAndroid Build Coastguard Worker <?cs # else, if NOT redirect ...
35*9e94795aSAndroid Build Coastguard Worker #
36*9e94795aSAndroid Build Coastguard Worker #
37*9e94795aSAndroid Build Coastguard Worker # The following is for SDK/NDK pages
38*9e94795aSAndroid Build Coastguard Worker #
39*9e94795aSAndroid Build Coastguard Worker #
40*9e94795aSAndroid Build Coastguard Worker ?>
41*9e94795aSAndroid Build Coastguard Worker 
42*9e94795aSAndroid Build Coastguard Worker <div class="g-unit" id="doc-content" >
43*9e94795aSAndroid Build Coastguard Worker   <div id="jd-header" class="guide-header" >
44*9e94795aSAndroid Build Coastguard Worker     <span class="crumb">&nbsp;</span>
45*9e94795aSAndroid Build Coastguard Worker     <h1 itemprop="name"><?cs if:android.whichdoc == "online" ?>Download the <?cs /if ?><?cs
46*9e94795aSAndroid Build Coastguard Worker var:page.title ?></h1>
47*9e94795aSAndroid Build Coastguard Worker   </div>
48*9e94795aSAndroid Build Coastguard Worker 
49*9e94795aSAndroid Build Coastguard Worker   <div id="jd-content" itemprop="description">
50*9e94795aSAndroid Build Coastguard Worker 
51*9e94795aSAndroid Build Coastguard Worker <?cs if:sdk.not_latest_version ?>
52*9e94795aSAndroid Build Coastguard Worker   <div class="special">
53*9e94795aSAndroid Build Coastguard Worker     <p><strong>This is NOT the current Android SDK release.</strong></p>
54*9e94795aSAndroid Build Coastguard Worker     <p><a href="/sdk/index.html">Download the current Android SDK</a></p>
55*9e94795aSAndroid Build Coastguard Worker   </div>
56*9e94795aSAndroid Build Coastguard Worker <?cs /if ?>
57*9e94795aSAndroid Build Coastguard Worker 
58*9e94795aSAndroid Build Coastguard Worker 
59*9e94795aSAndroid Build Coastguard Worker <?cs if:ndk ?>
60*9e94795aSAndroid Build Coastguard Worker <?cs #
61*9e94795aSAndroid Build Coastguard Worker #
62*9e94795aSAndroid Build Coastguard Worker #
63*9e94795aSAndroid Build Coastguard Worker #
64*9e94795aSAndroid Build Coastguard Worker #
65*9e94795aSAndroid Build Coastguard Worker #
66*9e94795aSAndroid Build Coastguard Worker #
67*9e94795aSAndroid Build Coastguard Worker # the following is for the NDK
68*9e94795aSAndroid Build Coastguard Worker #
69*9e94795aSAndroid Build Coastguard Worker # (nested in if/else redirect)
70*9e94795aSAndroid Build Coastguard Worker #
71*9e94795aSAndroid Build Coastguard Worker #
72*9e94795aSAndroid Build Coastguard Worker #
73*9e94795aSAndroid Build Coastguard Worker #
74*9e94795aSAndroid Build Coastguard Worker ?>
75*9e94795aSAndroid Build Coastguard Worker 
76*9e94795aSAndroid Build Coastguard Worker <p>The Android NDK is a companion tool to the Android SDK that lets you build
77*9e94795aSAndroid Build Coastguard Worker performance-critical portions of your apps in native code. It provides headers and
78*9e94795aSAndroid Build Coastguard Worker libraries that allow you to build activities, handle user input, use hardware sensors,
79*9e94795aSAndroid Build Coastguard Worker access application resources, and more, when programming in C or C++. If you write
80*9e94795aSAndroid Build Coastguard Worker native code, your applications are still packaged into an .apk file and they still run
81*9e94795aSAndroid Build Coastguard Worker inside of a virtual machine on the device. The fundamental Android application model
82*9e94795aSAndroid Build Coastguard Worker does not change.</p>
83*9e94795aSAndroid Build Coastguard Worker 
84*9e94795aSAndroid Build Coastguard Worker <p>Using native code does not result in an automatic performance increase,
85*9e94795aSAndroid Build Coastguard Worker but always increases application complexity. If you have not run into any limitations
86*9e94795aSAndroid Build Coastguard Worker using the Android framework APIs, you probably do not need the NDK. Read <a
87*9e94795aSAndroid Build Coastguard Worker href="<?cs var:toroot ?>sdk/ndk/overview.html">What is the NDK?</a> for more information about what
88*9e94795aSAndroid Build Coastguard Worker the NDK offers and whether it will be useful to you.
89*9e94795aSAndroid Build Coastguard Worker </p>
90*9e94795aSAndroid Build Coastguard Worker <p>
91*9e94795aSAndroid Build Coastguard Worker The NDK is designed for use <em>only</em> in conjunction with the
92*9e94795aSAndroid Build Coastguard Worker Android SDK. If you have not already installed and setup the <a
93*9e94795aSAndroid Build Coastguard Worker href="http://developer.android.com/sdk/index.html">Android SDK</a>, please
94*9e94795aSAndroid Build Coastguard Worker do so before downloading the NDK.
95*9e94795aSAndroid Build Coastguard Worker </p>
96*9e94795aSAndroid Build Coastguard Worker 
97*9e94795aSAndroid Build Coastguard Worker   <table class="download">
98*9e94795aSAndroid Build Coastguard Worker     <tr>
99*9e94795aSAndroid Build Coastguard Worker       <th>Platform</th>
100*9e94795aSAndroid Build Coastguard Worker       <th>Package</th>
101*9e94795aSAndroid Build Coastguard Worker       <th>Size</th>
102*9e94795aSAndroid Build Coastguard Worker       <th>MD5 Checksum</th>
103*9e94795aSAndroid Build Coastguard Worker   </tr>
104*9e94795aSAndroid Build Coastguard Worker   <tr>
105*9e94795aSAndroid Build Coastguard Worker     <td>Windows</td>
106*9e94795aSAndroid Build Coastguard Worker     <td>
107*9e94795aSAndroid Build Coastguard Worker   <a href="http://dl.google.com/android/ndk/<?cs var:ndk.win_download ?>"><?cs var:ndk.win_download ?></a>
108*9e94795aSAndroid Build Coastguard Worker     </td>
109*9e94795aSAndroid Build Coastguard Worker     <td><?cs var:ndk.win_bytes ?> bytes</td>
110*9e94795aSAndroid Build Coastguard Worker     <td><?cs var:ndk.win_checksum ?></td>
111*9e94795aSAndroid Build Coastguard Worker   </tr>
112*9e94795aSAndroid Build Coastguard Worker   <tr class="alt-color">
113*9e94795aSAndroid Build Coastguard Worker     <td>Mac OS X (intel)</td>
114*9e94795aSAndroid Build Coastguard Worker     <td>
115*9e94795aSAndroid Build Coastguard Worker   <a href="http://dl.google.com/android/ndk/<?cs var:ndk.mac_download ?>"><?cs var:ndk.mac_download ?></a>
116*9e94795aSAndroid Build Coastguard Worker     </td>
117*9e94795aSAndroid Build Coastguard Worker     <td><?cs var:ndk.mac_bytes ?> bytes</td>
118*9e94795aSAndroid Build Coastguard Worker     <td><?cs var:ndk.mac_checksum ?></td>
119*9e94795aSAndroid Build Coastguard Worker   </tr>
120*9e94795aSAndroid Build Coastguard Worker   <tr>
121*9e94795aSAndroid Build Coastguard Worker     <td>Linux 32/64-bit (x86)</td>
122*9e94795aSAndroid Build Coastguard Worker     <td>
123*9e94795aSAndroid Build Coastguard Worker   <a href="http://dl.google.com/android/ndk/<?cs var:ndk.linux_download ?>"><?cs var:ndk.linux_download ?></a>
124*9e94795aSAndroid Build Coastguard Worker     </td>
125*9e94795aSAndroid Build Coastguard Worker     <td><?cs var:ndk.linux_bytes ?> bytes</td>
126*9e94795aSAndroid Build Coastguard Worker     <td><?cs var:ndk.linux_checksum ?></td>
127*9e94795aSAndroid Build Coastguard Worker   </tr>
128*9e94795aSAndroid Build Coastguard Worker   </table>
129*9e94795aSAndroid Build Coastguard Worker 
130*9e94795aSAndroid Build Coastguard Worker   <?cs else ?>
131*9e94795aSAndroid Build Coastguard Worker <?cs # end if NDK ...
132*9e94795aSAndroid Build Coastguard Worker #
133*9e94795aSAndroid Build Coastguard Worker #
134*9e94795aSAndroid Build Coastguard Worker #
135*9e94795aSAndroid Build Coastguard Worker #
136*9e94795aSAndroid Build Coastguard Worker #
137*9e94795aSAndroid Build Coastguard Worker #
138*9e94795aSAndroid Build Coastguard Worker # the following is for the SDK
139*9e94795aSAndroid Build Coastguard Worker #
140*9e94795aSAndroid Build Coastguard Worker # (nested in if/else redirect and if/else NDK)
141*9e94795aSAndroid Build Coastguard Worker #
142*9e94795aSAndroid Build Coastguard Worker #
143*9e94795aSAndroid Build Coastguard Worker #
144*9e94795aSAndroid Build Coastguard Worker #
145*9e94795aSAndroid Build Coastguard Worker ?>
146*9e94795aSAndroid Build Coastguard Worker   <?cs if:android.whichdoc == "online" ?>
147*9e94795aSAndroid Build Coastguard Worker 
148*9e94795aSAndroid Build Coastguard Worker   <p>Welcome Developers! If you are new to the Android SDK, please read the steps below, for an
149*9e94795aSAndroid Build Coastguard Worker overview of how to set up the SDK. </p>
150*9e94795aSAndroid Build Coastguard Worker 
151*9e94795aSAndroid Build Coastguard Worker   <p>If you're already using the Android SDK, you should
152*9e94795aSAndroid Build Coastguard Worker update to the latest tools or platform using the <em>Android SDK and AVD Manager</em>, rather than
153*9e94795aSAndroid Build Coastguard Worker downloading a new SDK starter package. See <a
154*9e94795aSAndroid Build Coastguard Worker href="<?cs var:toroot ?>sdk/adding-components.html">Adding SDK Components</a>.</p>
155*9e94795aSAndroid Build Coastguard Worker 
156*9e94795aSAndroid Build Coastguard Worker   <table class="download">
157*9e94795aSAndroid Build Coastguard Worker     <tr>
158*9e94795aSAndroid Build Coastguard Worker       <th>Platform</th>
159*9e94795aSAndroid Build Coastguard Worker       <th>Package</th>
160*9e94795aSAndroid Build Coastguard Worker       <th>Size</th>
161*9e94795aSAndroid Build Coastguard Worker       <th>MD5 Checksum</th>
162*9e94795aSAndroid Build Coastguard Worker   </tr>
163*9e94795aSAndroid Build Coastguard Worker   <tr>
164*9e94795aSAndroid Build Coastguard Worker     <td rowspan="2">Windows</td>
165*9e94795aSAndroid Build Coastguard Worker     <td>
166*9e94795aSAndroid Build Coastguard Worker   <a onclick="onDownload(this)" href="http://dl.google.com/android/<?cs var:sdk.win_download
167*9e94795aSAndroid Build Coastguard Worker ?>"><?cs var:sdk.win_download ?></a>
168*9e94795aSAndroid Build Coastguard Worker     </td>
169*9e94795aSAndroid Build Coastguard Worker     <td><?cs var:sdk.win_bytes ?> bytes</td>
170*9e94795aSAndroid Build Coastguard Worker     <td><?cs var:sdk.win_checksum ?></td>
171*9e94795aSAndroid Build Coastguard Worker   </tr>
172*9e94795aSAndroid Build Coastguard Worker   <tr>
173*9e94795aSAndroid Build Coastguard Worker     <!-- blank TD from Windows rowspan -->
174*9e94795aSAndroid Build Coastguard Worker     <td>
175*9e94795aSAndroid Build Coastguard Worker   <a onclick="onDownload(this)" href="http://dl.google.com/android/<?cs var:sdk.win_installer
176*9e94795aSAndroid Build Coastguard Worker ?>"><?cs var:sdk.win_installer ?></a> (Recommended)
177*9e94795aSAndroid Build Coastguard Worker     </td>
178*9e94795aSAndroid Build Coastguard Worker     <td><?cs var:sdk.win_installer_bytes ?> bytes</td>
179*9e94795aSAndroid Build Coastguard Worker     <td><?cs var:sdk.win_installer_checksum ?></td>
180*9e94795aSAndroid Build Coastguard Worker   </tr>
181*9e94795aSAndroid Build Coastguard Worker   <tr class="alt-color">
182*9e94795aSAndroid Build Coastguard Worker     <td>Mac OS X (intel)</td>
183*9e94795aSAndroid Build Coastguard Worker     <td>
184*9e94795aSAndroid Build Coastguard Worker   <a onclick="onDownload(this)" href="http://dl.google.com/android/<?cs var:sdk.mac_download
185*9e94795aSAndroid Build Coastguard Worker ?>"><?cs var:sdk.mac_download ?></a>
186*9e94795aSAndroid Build Coastguard Worker     </td>
187*9e94795aSAndroid Build Coastguard Worker     <td><?cs var:sdk.mac_bytes ?> bytes</td>
188*9e94795aSAndroid Build Coastguard Worker     <td><?cs var:sdk.mac_checksum ?></td>
189*9e94795aSAndroid Build Coastguard Worker   </tr>
190*9e94795aSAndroid Build Coastguard Worker   <tr>
191*9e94795aSAndroid Build Coastguard Worker     <td>Linux (i386)</td>
192*9e94795aSAndroid Build Coastguard Worker     <td>
193*9e94795aSAndroid Build Coastguard Worker   <a onclick="onDownload(this)" href="http://dl.google.com/android/<?cs var:sdk.linux_download
194*9e94795aSAndroid Build Coastguard Worker ?>"><?cs var:sdk.linux_download ?></a>
195*9e94795aSAndroid Build Coastguard Worker     </td>
196*9e94795aSAndroid Build Coastguard Worker     <td><?cs var:sdk.linux_bytes ?> bytes</td>
197*9e94795aSAndroid Build Coastguard Worker     <td><?cs var:sdk.linux_checksum ?></td>
198*9e94795aSAndroid Build Coastguard Worker   </tr>
199*9e94795aSAndroid Build Coastguard Worker   </table>
200*9e94795aSAndroid Build Coastguard Worker 
201*9e94795aSAndroid Build Coastguard Worker 
202*9e94795aSAndroid Build Coastguard Worker <div id="next-steps" style="display:none">
203*9e94795aSAndroid Build Coastguard Worker   <p><b><em><span id="filename"></span></em> is now downloading. Follow the steps below to
204*9e94795aSAndroid Build Coastguard Worker get started.</b></p>
205*9e94795aSAndroid Build Coastguard Worker </div>
206*9e94795aSAndroid Build Coastguard Worker 
207*9e94795aSAndroid Build Coastguard Worker <script type="text/javascript">
onDownload(link)208*9e94795aSAndroid Build Coastguard Worker function onDownload(link) {
209*9e94795aSAndroid Build Coastguard Worker   $("#filename").text($(link).html());
210*9e94795aSAndroid Build Coastguard Worker   $("#next-steps").show();
211*9e94795aSAndroid Build Coastguard Worker }
212*9e94795aSAndroid Build Coastguard Worker </script>
213*9e94795aSAndroid Build Coastguard Worker   <?cs else ?> <?cs # end if online ?>
214*9e94795aSAndroid Build Coastguard Worker 
215*9e94795aSAndroid Build Coastguard Worker     <?cs if:sdk.preview ?><?cs # it's preview offline docs ?>
216*9e94795aSAndroid Build Coastguard Worker       <p>Welcome developers! We are pleased to provide you with a preview SDK for the upcoming
217*9e94795aSAndroid Build Coastguard Worker     Android 3.0 release, to give you a head-start on developing applications for it.
218*9e94795aSAndroid Build Coastguard Worker     </p>
219*9e94795aSAndroid Build Coastguard Worker 
220*9e94795aSAndroid Build Coastguard Worker       <p>See the <a
221*9e94795aSAndroid Build Coastguard Worker     href="<?cs var:toroot ?>sdk/preview/start.html">Getting Started</a> document for more information
222*9e94795aSAndroid Build Coastguard Worker     about how to set up the preview SDK and get started.</p>
223*9e94795aSAndroid Build Coastguard Worker     <style type="text/css">
224*9e94795aSAndroid Build Coastguard Worker     .non-preview { display:none; }
225*9e94795aSAndroid Build Coastguard Worker     </style>
226*9e94795aSAndroid Build Coastguard Worker 
227*9e94795aSAndroid Build Coastguard Worker     <?cs else ?><?cs # it's normal offline docs ?>
228*9e94795aSAndroid Build Coastguard Worker       <style type="text/css">
229*9e94795aSAndroid Build Coastguard Worker         p.offline-message { display:block; }
230*9e94795aSAndroid Build Coastguard Worker         p.online-message { display:none; }
231*9e94795aSAndroid Build Coastguard Worker       </style>
232*9e94795aSAndroid Build Coastguard Worker     <?cs /if ?>
233*9e94795aSAndroid Build Coastguard Worker 
234*9e94795aSAndroid Build Coastguard Worker   <?cs /if ?> <?cs # end if/else online ?>
235*9e94795aSAndroid Build Coastguard Worker 
236*9e94795aSAndroid Build Coastguard Worker <?cs /if ?> <?cs # end if/else NDK ?>
237*9e94795aSAndroid Build Coastguard Worker 
238*9e94795aSAndroid Build Coastguard Worker <?cs /if ?> <?cs # end if/else redirect ?>
239*9e94795aSAndroid Build Coastguard Worker 
240*9e94795aSAndroid Build Coastguard Worker <?cs call:tag_list(root.descr) ?>
241*9e94795aSAndroid Build Coastguard Worker 
242*9e94795aSAndroid Build Coastguard Worker </div><!-- end jd-content -->
243*9e94795aSAndroid Build Coastguard Worker 
244*9e94795aSAndroid Build Coastguard Worker <?cs if:!sdk.redirect ?>
245*9e94795aSAndroid Build Coastguard Worker <?cs include:"footer.cs" ?>
246*9e94795aSAndroid Build Coastguard Worker <?cs /if ?>
247*9e94795aSAndroid Build Coastguard Worker 
248*9e94795aSAndroid Build Coastguard Worker </div><!-- end g-unit -->
249*9e94795aSAndroid Build Coastguard Worker 
250*9e94795aSAndroid Build Coastguard Worker <?cs include:"trailer.cs" ?>
251*9e94795aSAndroid Build Coastguard Worker 
252*9e94795aSAndroid Build Coastguard Worker </body>
253*9e94795aSAndroid Build Coastguard Worker </html>
254*9e94795aSAndroid Build Coastguard Worker 
255*9e94795aSAndroid Build Coastguard Worker 
256*9e94795aSAndroid Build Coastguard Worker 
257