Gitiles
Code Review Sign In
review.shift-gmbh.com / SHIFTPHONES / android_frameworks_base / a489f0b3d9007d94ba514bf4ce71ce9957147e33 / . / docs / html / preview / index.html
blob: 4f7722cd116b100a38e7b437a07338b5b95fbd5b [file] [log] [blame]
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]1<!DOCTYPE html>
2
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]3<html>
4<head>
5
6
7<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
8<meta name="viewport" content="width=970" />
9
10<meta name="Description" content="Test and build your apps against the next version of Android to ensure they're ready when the platform officially launches.">
11<link rel="shortcut icon" type="image/x-icon" href="/favicon.ico" />
12<title>Android L Developer Preview | Android Developers</title>
13
14<!-- STYLESHEETS -->
15<link rel="stylesheet"
16href="//fonts.googleapis.com/css?family=Roboto+Condensed">
17<link rel="stylesheet" href="//fonts.googleapis.com/css?family=Roboto:light,regular,medium,thin,italic,mediumitalic,bold"
18 title="roboto">
19<link href="/assets/css/default.css" rel="stylesheet" type="text/css">
20
21
22
23<!-- JAVASCRIPT -->
24<script src="//www.google.com/jsapi" type="text/javascript"></script>
25<script src="/assets/js/android_3p-bundle.js" type="text/javascript"></script>
26<script type="text/javascript">
27 var toRoot = "/";
28 var metaTags = [];
29 var devsite = false;
30</script>
31<script src="/assets/js/docs.js" type="text/javascript"></script>
32
33<script>
34 (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
35 (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
36 m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
37 })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
38
39 ga('create', 'UA-5831155-1', 'android.com');
40 ga('create', 'UA-49880327-2', 'android.com', {'name': 'universal'}); // New tracker);
41 ga('send', 'pageview');
42 ga('universal.send', 'pageview'); // Send page view for new tracker.
43</script>
44
45</head>
46
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]47
smain@google.com271078f2014-10-09 17:00:20 -0700[diff] [blame]48<body class="gc-documentation" itemscope="" itemtype="http://schema.org/Article">
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]49
Joe Fernandezf50f51c2014-06-27 17:00:59 -0700[diff] [blame]50
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]51<a name="top"></a>
smain@google.com271078f2014-10-09 17:00:20 -0700[diff] [blame]52<a name="download"></a>
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]53<div id="body-content">
smain@google.com271078f2014-10-09 17:00:20 -0700[diff] [blame]54<div class="fullpage">
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]55<div id="jd-content">
56 <div class="jd-descr" itemprop="articleBody">
smain@google.com271078f2014-10-09 17:00:20 -0700[diff] [blame]57<style>
58body,html, #qv {background-color:#e9e9e9}
59
60#qv * { font-weight:bold;}
61
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]62.fullpage>#footer,
63#jd-content>.content-footer.wrap {
64 display:none;
65}
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]66
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]67.content-footer {
68 display: none;
69}
70</style>
71
smain@google.com271078f2014-10-09 17:00:20 -0700[diff] [blame]72 <div style="border-bottom: 1px solid #a5c43a; position: absolute; left: 0; right: 0; top: 0; z-index:99">
73 <div class="wrap" style="position: relative; height: 45px; padding: 0 20px;">
74 <a href="/index.html" style="position:absolute;top:8px">
75 <img src="/assets/images/dac_logo.png" srcset="/assets/images/dac_logo@2x.png 2x" width="123" height="25" alt="Android Developers home page">
smain@google.com075531a2014-10-14 19:34:43 -0700[diff] [blame]76 </a>
77 </div>
78 </div>
79
80
smain@google.com271078f2014-10-09 17:00:20 -0700[diff] [blame]81
82
83
84
85
86
87
88
89
90
91
92 <div class="landing-rest-of-page" style="position:relative;">
93
94
95
96
97
98
99
100
101 <div class="wrap" id="tos" style="display:none;padding-top:90px">
102
103 <p class="sdk-terms-intro">Before downloading the Android Preview system image,
104 you must agree to the following terms and conditions.</p>
105
106 <h2 class="norule">Terms and Conditions</h2>
107 <div class="sdk-terms" onfocus="this.blur()" style="width:100%">
108This is the Android SDK Preview License Agreement (the “License Agreement”).
109
1101. Introduction
111
1121.1 The Android SDK Preview (referred to in the License Agreement as the “Preview” and specifically including the Android system files, packaged APIs, and Preview library files, if and when they are made available) is licensed to you subject to the terms of the License Agreement. The License Agreement forms a legally binding contract between you and Google in relation to your use of the Preview.
113
1141.2 "Android" means the Android software stack for devices, as made available under the Android Open Source Project, which is located at the following URL: http://source.android.com/, as updated from time to time.
115
1161.3 "Google" means Google Inc., a Delaware corporation with principal place of business at 1600 Amphitheatre Parkway, Mountain View, CA 94043, United States.
117
1182. Accepting the License Agreement
119
1202.1 In order to use the Preview, you must first agree to the License Agreement. You may not use the Preview if you do not accept the License Agreement.
121
1222.2 By clicking to accept and/or using the Preview, you hereby agree to the terms of the License Agreement.
123
1242.3 You may not use the Preview and may not accept the License Agreement if you are a person barred from receiving the Preview under the laws of the United States or other countries including the country in which you are resident or from which you use the Preview.
125
1262.4 If you will use the Preview internally within your company or organization you agree to be bound by the License Agreement on behalf of your employer or other entity, and you represent and warrant that you have full legal authority to bind your employer or such entity to the License Agreement. If you do not have the requisite authority, you may not accept the License Agreement or use the Preview on behalf of your employer or other entity.
127
1283. Preview License from Google
129
1303.1 Subject to the terms of the License Agreement, Google grants you a royalty-free, non-assignable, non-exclusive, non-sublicensable, limited, revocable license to use the Preview, personally or internally within your company or organization, solely to develop applications to run on the Android platform.
131
1323.2 You agree that Google or third parties owns all legal right, title and interest in and to the Preview, including any Intellectual Property Rights that subsist in the Preview. "Intellectual Property Rights" means any and all rights under patent law, copyright law, trade secret law, trademark law, and any and all other proprietary rights. Google reserves all rights not expressly granted to you.
133
1343.3 You may not use the Preview for any purpose not expressly permitted by the License Agreement. Except to the extent required by applicable third party licenses, you may not: (a) copy (except for backup purposes), modify, adapt, redistribute, decompile, reverse engineer, disassemble, or create derivative works of the Preview or any part of the Preview; or (b) load any part of the Preview onto a mobile handset or any other hardware device except a personal computer, combine any part of the Preview with other software, or distribute any software or device incorporating a part of the Preview.
135
1363.4 You agree that you will not take any actions that may cause or result in the fragmentation of Android, including but not limited to distributing, participating in the creation of, or promoting in any way a software development kit derived from the Preview.
137
1383.5 Use, reproduction and distribution of components of the Preview licensed under an open source software license are governed solely by the terms of that open source software license and not the License Agreement. You agree to remain a licensee in good standing in regard to such open source software licenses under all the rights granted and to refrain from any actions that may terminate, suspend, or breach such rights.
139
1403.6 You agree that the form and nature of the Preview that Google provides may change without prior notice to you and that future versions of the Preview may be incompatible with applications developed on previous versions of the Preview. You agree that Google may stop (permanently or temporarily) providing the Preview (or any features within the Preview) to you or to users generally at Google's sole discretion, without prior notice to you.
141
1423.7 Nothing in the License Agreement gives you a right to use any of Google's trade names, trademarks, service marks, logos, domain names, or other distinctive brand features.
143
1443.8 You agree that you will not remove, obscure, or alter any proprietary rights notices (including copyright and trademark notices) that may be affixed to or contained within the Preview.
145
1464. Use of the Preview by You
147
1484.1 Google agrees that nothing in the License Agreement gives Google any right, title or interest from you (or your licensors) under the License Agreement in or to any software applications that you develop using the Preview, including any intellectual property rights that subsist in those applications.
149
1504.2 You agree to use the Preview and write applications only for purposes that are permitted by (a) the License Agreement, and (b) any applicable law, regulation or generally accepted practices or guidelines in the relevant jurisdictions (including any laws regarding the export of data or software to and from the United States or other relevant countries).
151
1524.3 You agree that if you use the Preview to develop applications, you will protect the privacy and legal rights of users. If users provide you with user names, passwords, or other login information or personal information, you must make the users aware that the information will be available to your application, and you must provide legally adequate privacy notice and protection for those users. If your application stores personal or sensitive information provided by users, it must do so securely. If users provide you with Google Account information, your application may only use that information to access the user's Google Account when, and for the limited purposes for which, each user has given you permission to do so.
153
1544.4 You agree that you will not engage in any activity with the Preview, including the development or distribution of an application, that interferes with, disrupts, damages, or accesses in an unauthorized manner the servers, networks, or other properties or services of Google or any third party.
155
1564.5 You agree that you are solely responsible for (and that Google has no responsibility to you or to any third party for) any data, content, or resources that you create, transmit or display through Android and/or applications for Android, and for the consequences of your actions (including any loss or damage which Google may suffer) by doing so.
157
1584.6 You agree that you are solely responsible for (and that Google has no responsibility to you or to any third party for) any breach of your obligations under the License Agreement, any applicable third party contract or Terms of Service, or any applicable law or regulation, and for the consequences (including any loss or damage which Google or any third party may suffer) of any such breach.
159
1604.7 The Preview is in development, and your testing and feedback are an important part of the development process. By using the Preview, you acknowledge that implementation of some features are still under development and that you should not rely on the Preview having the full functionality of a stable release. You agree not to publicly distribute or ship any application using this Preview as this Preview will no longer be supported after the official Android SDK is released.
161
1625. Your Developer Credentials
163
1645.1 You agree that you are responsible for maintaining the confidentiality of any developer credentials that may be issued to you by Google or which you may choose yourself and that you will be solely responsible for all applications that are developed under your developer credentials.
165
1666. Privacy and Information
167
1686.1 In order to continually innovate and improve the Preview, Google may collect certain usage statistics from the software including but not limited to a unique identifier, associated IP address, version number of the software, and information on which tools and/or services in the Preview are being used and how they are being used. Before any of this information is collected, the Preview will notify you and seek your consent. If you withhold consent, the information will not be collected.
169
1706.2 The data collected is examined in the aggregate to improve the Preview and is maintained in accordance with Google's Privacy Policy located at http://www.google.com/policies/privacy/.
171
1727. Third Party Applications
173
1747.1 If you use the Preview to run applications developed by a third party or that access data, content or resources provided by a third party, you agree that Google is not responsible for those applications, data, content, or resources. You understand that all data, content or resources which you may access through such third party applications are the sole responsibility of the person from which they originated and that Google is not liable for any loss or damage that you may experience as a result of the use or access of any of those third party applications, data, content, or resources.
175
1767.2 You should be aware the data, content, and resources presented to you through such a third party application may be protected by intellectual property rights which are owned by the providers (or by other persons or companies on their behalf). You may not modify, rent, lease, loan, sell, distribute or create derivative works based on these data, content, or resources (either in whole or in part) unless you have been specifically given permission to do so by the relevant owners.
177
1787.3 You acknowledge that your use of such third party applications, data, content, or resources may be subject to separate terms between you and the relevant third party.
179
1808. Using Google APIs
181
1828.1 Google APIs
183
1848.1.1 If you use any API to retrieve data from Google, you acknowledge that the data may be protected by intellectual property rights which are owned by Google or those parties that provide the data (or by other persons or companies on their behalf). Your use of any such API may be subject to additional Terms of Service. You may not modify, rent, lease, loan, sell, distribute or create derivative works based on this data (either in whole or in part) unless allowed by the relevant Terms of Service.
185
1868.1.2 If you use any API to retrieve a user's data from Google, you acknowledge and agree that you shall retrieve data only with the user's explicit consent and only when, and for the limited purposes for which, the user has given you permission to do so.
187
1889. Terminating the License Agreement
189
1909.1 the License Agreement will continue to apply until terminated by either you or Google as set out below.
191
1929.2 If you want to terminate the License Agreement, you may do so by ceasing your use of the Preview and any relevant developer credentials.
193
1949.3 Google may at any time, terminate the License Agreement, with or without cause, upon notice to you.
195
1969.4 The License Agreement will automatically terminate without notice or other action upon the earlier of:
197(A) when Google ceases to provide the Preview or certain parts of the Preview to users in the country in which you are resident or from which you use the service; and
198(B) Google issues a final release version of the Android SDK.
199
2009.5 When the License Agreement is terminated, the license granted to you in the License Agreement will terminate, you will immediately cease all use of the Preview, and the provisions of paragraphs 10, 11, 12 and 14 shall survive indefinitely.
201
20210. DISCLAIMERS
203
20410.1 YOU EXPRESSLY UNDERSTAND AND AGREE THAT YOUR USE OF THE PREVIEW IS AT YOUR SOLE RISK AND THAT THE PREVIEW IS PROVIDED "AS IS" AND "AS AVAILABLE" WITHOUT WARRANTY OF ANY KIND FROM GOOGLE.
205
20610.2 YOUR USE OF THE PREVIEW AND ANY MATERIAL DOWNLOADED OR OTHERWISE OBTAINED THROUGH THE USE OF THE PREVIEW IS AT YOUR OWN DISCRETION AND RISK AND YOU ARE SOLELY RESPONSIBLE FOR ANY DAMAGE TO YOUR COMPUTER SYSTEM OR OTHER DEVICE OR LOSS OF DATA THAT RESULTS FROM SUCH USE. WITHOUT LIMITING THE FOREGOING, YOU UNDERSTAND THAT THE PREVIEW IS NOT A STABLE RELEASE AND MAY CONTAIN ERRORS, DEFECTS AND SECURITY VULNERABILITIES THAT CAN RESULT IN SIGNIFICANT DAMAGE, INCLUDING THE COMPLETE, IRRECOVERABLE LOSS OF USE OF YOUR COMPUTER SYSTEM OR OTHER DEVICE.
207
20810.3 GOOGLE FURTHER EXPRESSLY DISCLAIMS ALL WARRANTIES AND CONDITIONS OF ANY KIND, WHETHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO THE IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
209
21011. LIMITATION OF LIABILITY
211
21211.1 YOU EXPRESSLY UNDERSTAND AND AGREE THAT GOOGLE, ITS SUBSIDIARIES AND AFFILIATES, AND ITS LICENSORS SHALL NOT BE LIABLE TO YOU UNDER ANY THEORY OF LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL OR EXEMPLARY DAMAGES THAT MAY BE INCURRED BY YOU, INCLUDING ANY LOSS OF DATA, WHETHER OR NOT GOOGLE OR ITS REPRESENTATIVES HAVE BEEN ADVISED OF OR SHOULD HAVE BEEN AWARE OF THE POSSIBILITY OF ANY SUCH LOSSES ARISING.
213
21412. Indemnification
215
21612.1 To the maximum extent permitted by law, you agree to defend, indemnify and hold harmless Google, its affiliates and their respective directors, officers, employees and agents from and against any and all claims, actions, suits or proceedings, as well as any and all losses, liabilities, damages, costs and expenses (including reasonable attorneys’ fees) arising out of or accruing from (a) your use of the Preview, (b) any application you develop on the Preview that infringes any Intellectual Property Rights of any person or defames any person or violates their rights of publicity or privacy, and (c) any non-compliance by you of the License Agreement.
217
21813. Changes to the License Agreement
219
22013.1 Google may make changes to the License Agreement as it distributes new versions of the Preview. When these changes are made, Google will make a new version of the License Agreement available on the website where the Preview is made available.
221
22214. General Legal Terms
223
22414.1 the License Agreement constitutes the whole legal agreement between you and Google and governs your use of the Preview (excluding any services which Google may provide to you under a separate written agreement), and completely replaces any prior agreements between you and Google in relation to the Preview.
225
22614.2 You agree that if Google does not exercise or enforce any legal right or remedy which is contained in the License Agreement (or which Google has the benefit of under any applicable law), this will not be taken to be a formal waiver of Google's rights and that those rights or remedies will still be available to Google.
227
22814.3 If any court of law, having the jurisdiction to decide on this matter, rules that any provision of the License Agreement is invalid, then that provision will be removed from the License Agreement without affecting the rest of the License Agreement. The remaining provisions of the License Agreement will continue to be valid and enforceable.
229
23014.4 You acknowledge and agree that each member of the group of companies of which Google is the parent shall be third party beneficiaries to the License Agreement and that such other companies shall be entitled to directly enforce, and rely upon, any provision of the License Agreement that confers a benefit on (or rights in favor of) them. Other than this, no other person or company shall be third party beneficiaries to the License Agreement.
231
23214.5 EXPORT RESTRICTIONS. THE PREVIEW IS SUBJECT TO UNITED STATES EXPORT LAWS AND REGULATIONS. YOU MUST COMPLY WITH ALL DOMESTIC AND INTERNATIONAL EXPORT LAWS AND REGULATIONS THAT APPLY TO THE PREVIEW. THESE LAWS INCLUDE RESTRICTIONS ON DESTINATIONS, END USERS AND END USE.
233
23414.6 The License Agreement may not be assigned or transferred by you without the prior written approval of Google, and any attempted assignment without such approval will be void. You shall not delegate your responsibilities or obligations under the License Agreement without the prior written approval of Google.
235
23614.7 The License Agreement, and your relationship with Google under the License Agreement, shall be governed by the laws of the State of California without regard to its conflict of laws provisions. You and Google agree to submit to the exclusive jurisdiction of the courts located within the county of Santa Clara, California to resolve any legal matter arising from the License Agreement. Notwithstanding this, you agree that Google shall still be allowed to apply for injunctive remedies (or an equivalent type of urgent legal relief) in any jurisdiction.
237 </div><!-- sdk terms -->
238
239
240
241 <div id="sdk-terms-form">
242 <p>
243 <input id="agree" type="checkbox" name="agree" value="1" onclick="onAgreeChecked()" />
244 <label id="agreeLabel" for="agree">I have read and agree with the above terms and conditions</label>
245 </p>
246 <p><a href="" class="button disabled" id="downloadForRealz" onclick="return onDownloadForRealz(this);"></a></p>
247 </div>
248
249
250 </div><!-- end TOS -->
251
252
253
254
255
256
257
258 <div class="landing-section" id="landing-wrapper" style="padding:55px 10px 0">
259 <div class="landing-section-header" style="margin:0">
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]260 <div class="landing-h1">Android L Developer Preview</div>
smain@google.com271078f2014-10-09 17:00:20 -0700[diff] [blame]261 <div class="landing-subhead" style="padding-bottom:40px">
262 Final APIs now available!
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]263 </div>
264 </div>
smain@google.com271078f2014-10-09 17:00:20 -0700[diff] [blame]265 <div class="wrap" style="padding:20px; position:relative">
266
267 <img src="/images/home/l-hero_2x.png"
268 srcset="/images/home/l-hero.png 1x, /images/home/l-hero_2x.png 2x"
269 style=" margin:-5px -30px 0 0;float:right" alt="" width="510">
270
271 <a href="/about/versions/android-5.0.html" class="landing-button landing-primary"
272 style="position:absolute;z-index:100;right:215px;top:375px">Android 5.0 API Overview</a>
273
274 <div style="width:440px">
275<p>Android 5.0 (Lollipop) is almost here and users will begin receiving
276device updates in November. To help you prepare, the Android 5.0 SDK is now available
277with final APIs.</p>
278
279<p>Since the L Developer Preview began, various APIs and behaviors have changed,
280so if you've been using the Preview SDK
281you should update now to test your apps and take advantage of new features.</p>
282
283
284 <p>To get the latest Android 5.0 SDK:</p>
285 <ol>
286 <li>Start the <a href="/tools/help/sdk-manager.html">Android SDK Manager</a>.</li>
287 <li>In the <b>Tools</b> section, select the latest <b>SDK Tools</b>,
288 <b>SDK Platform-tools</b>, and <b>SDK Build-tools</b>.</li>
289 <!-- Android L not yet showing up in Android SDK Manager... -->
290 <li>Select everything under the <b>Android 5.0</b> section, then
291 click <b>Install packages...</b></li>
292 <li>Accept the licensing agreement for the packages, then click
293 <b>Install</b>.</li>
294 <li>If you previously installed the Android L Preview SDK, select all those
295 packages in the SDK Manager and click <strong>Delete packages</strong>.
296 </ol>
297 <p>Now you're ready to develop and test on Android 5.0 with your normal workflow
298 and begin publishing app updates to Google Play.
299 </div>
300
301 <h2 id="Start" class="norule" style="margin:60px 0 0 0">Get Started on Android 5.0</h2>
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]302 </div> <!-- end .wrap -->
smain@google.com271078f2014-10-09 17:00:20 -0700[diff] [blame]303
304
305
306 <div class="wrap" style="background-color:#fff;padding:20px;position:relative">
307
308 <div id="qv-wrapper">
309 <div id="qv">
310 <h2>More about Android 5.0</h2>
311 <ul>
312 <li><a href="http://android-developers.blogspot.com/">Android 5.0 announcement</a></li>
313 <li><a href="/about/versions/android-5.0.html">Android 5.0 API Overview</a></li>
314 <li><a href="/sdk/api_diff/21/changes.html">Android 5.0 API Diff Report</a></li>
smain@google.comf7a7d6d2014-10-17 01:31:24 -0700[diff] [blame]315 <li><a href="/samples/new/index.html">Android 5.0 API Samples</a></li>
smain@google.com271078f2014-10-09 17:00:20 -0700[diff] [blame]316 </ul>
317 </div>
318 </div>
319
320 <p>Now that Android 5.0 APIs are final:</p>
321 <ul>
322 <li>The API level for Android 5.0 is 21, so be sure to update your
323 app's manifest file to set <a href="/guide/topics/manifest/uses-sdk-element.html#target"
324 ><code>targetSdkVersion</code></a> to
325 <code>"21"</code> when you begin testing:
326 <pre>&lt;uses-sdk android:targetSdkVersion="21" ... /></pre>
327 </li>
328 <li>Google Play now accepts APKs with <a
329 href="/guide/topics/manifest/uses-sdk-element.html#min"><code>minSdkVersion</code></a> or
330 <a href="/guide/topics/manifest/uses-sdk-element.html#target"
331 ><code>targetSdkVersion</code></a> set
332 to <code>"21"</code>, so you can upload your updated apps today.</li>
333 </ul>
334
smain@google.com5e5af932014-11-14 10:12:53 -0800[diff] [blame]335 <p>If you previously flashed your Nexus 5 or Nexus 7 with a preview system image, you should
336 now update your device to the final factory system image.
337 Download the appropriate image from
smain@google.com271078f2014-10-09 17:00:20 -0700[diff] [blame]338 <a href="http://developers.google.com/android/nexus/images">Factory Images for Nexus
smain@google.com5e5af932014-11-14 10:12:53 -0800[diff] [blame]339 Devices</a> and follow the flashing instructions on that page.</p>
smain@google.com271078f2014-10-09 17:00:20 -0700[diff] [blame]340
341 </div> <!-- end .wrap -->
342
343
344
345
346
347
348
349
350 <div class="wrap" style="padding:20px; position:relative">
351 <h2 id="Material" class="norule" style="margin:40px 0 0 0">Design with Material</h2>
352 </div>
353
354 <div class="wrap" style="background-color:#fff;padding:20px;position:relative">
355 <img src="images/material-layers.png" width="240"
356 style="position:absolute;right:20px;top:-50px">
357
358 <div id="qv-wrapper" style="margin-top:120px">
359 <div id="qv">
360
361 <h2>More about Material Design</h2>
362 <ul>
363 <li><a href="http://www.google.com/design/spec/material-design/introduction.html">Material
364 Design Spec</a></li>
365 <li><a href="/design/material/index.html">Android Material Design</a></li>
366 <li><a href="/training/material/index.html">Creating Apps with Material Design</a>
367 </ul>
368 </div>
369 </div>
370
371
372<p>Material design is a complete design philosophy for visual, motion, and interaction design
373across platforms and devices. The <a href=
374"http://www.google.com/design/spec/material-design/introduction.html">material design specification
375(preview)</a> provides all the details for designers.</p>
376
377
378 <p>To get started with Material design in your Android app, update
379 your <a href="/guide/topics/manifest/uses-sdk-element.html#target"
380 ><code>targetSdkVersion</code></a> to <code>"21"</code> and apply the new
381 <a href="/reference/android/R.style.html#Theme_Material"
382 ><code>Material</code></a> theme. For example, when creating
383 a <a href="/guide/topics/ui/themes.html">custom theme</a>
384 for your app, open your project's <code>res/values/styles.xml</code> file
385 and extend the <a href="/reference/android/R.style.html#Theme_Material"
386 ><code>Material</code></a> theme:</p>
387<pre>
388&lt;resources>
389 &lt;style name="AppTheme" parent="android:Theme.Material">
390 &lt;!-- Customize the Material elements here -->
391 &lt;/style>
392&lt;/resources>
393</pre>
394<p>Then apply your custom theme to your application in the manifest file:</p>
395<pre>
396&lt;application android:theme="&#64;style/AppTheme">
397</pre>
398<p>Material design is more than just the UI theme, though. It's also about the way the app
399 behaves&mdash;how elements move and transform when the user interacts with them. So Android 5.0
400 and the <a href="/tools/support-library/features.html#v7">v7 support library</a> provide new
401 widgets and animation APIs that allow you to
402 build interaction patterns described in the
403 <a href="http://www.google.com/design/spec/material-design/introduction.html">Material design
404 specification</a>.</p>
405
406<p>All the Material design elements and interaction patterns provided by the UI styles and widgets
407are flexible, so you can adopt only what's appropriate for your app and retain a unique identity
408and experience for your product.</p>
409
410<p>And Material design on Android isn't just for Android 5.0. The
411 <a href="/tools/support-library/features.html#v7">v7 support library</a> has been significantly
412 updated in revision 21 to make many of the Material design elements available when
413 running on older versions of the platform.</p>
414
415<p>For many more details about how to implement the Material look and feel,
416 see <a href="/training/material/index.html">Creating Apps with Material
417 Design</a>.</p>
418
419
420 </div>
421
422
423
424
425
426
427
428
429
430
431
432 <div class="wrap" style="padding:20px; position:relative">
433 <h2 id="TV" class="norule" style="margin:40px 0 0 0">Build for Android TV</h2>
434 </div>
435
436 <div class="wrap" style="background-color:#fff;padding:20px;position:relative">
437 <img src="/tv/images/components.png" width="240"
438 style="position:absolute;right:20px;top:-50px">
439
440 <div id="qv-wrapper" style="margin-top:120px">
441 <div id="qv">
442
443 <h2>More about Android TV</h2>
444 <ul>
445 <li><a href="/design/tv/index.html">Android TV Design</a></li>
446 <li><a href="/training/tv/start/index.html">Building Apps for Android TV</a></li>
447 <li><a href="/training/tv/games/index.html">Building TV Games</a></li>
448 <li><a href="/training/tv/playback/index.html">Building TV Playback Apps</a></li>
449 <li><a href="/distribute/essentials/quality/tv.html">TV App Quality</a></li>
450 </ul>
451 </div>
452 </div>
453
454<p>Android 5.0 provides a new platform for users to experience your app on a big screen. The
455Android TV experience is centered around a simplified home screen that allows users to discover
456your app's content with personalized recommendations and voice search, or select your app to launch
457into your fullscreen experience.</p>
458
459
460<p>Making your app available on Android TV does not require that you build an entirely new app.
461Android TV is simply another form factor for the Android platform, so you can deliver the same APK
462that you provide for phones and tablets to TVs through Google Play. However, to make your app
463available on Android TV, you'll need to make some optimizations such as adding layouts
464for the big screen and adding support for remote control input. For more information about design
465guidelines, see <a href="/distribute/essentials/quality/tv.html">TV App Quality</a>.</p>
466
467<p class="note"><strong>Note:</strong> Google Play for Android TV will officially
468open for apps on November 3.</p>
469
470<p>Android TV is also great new opportunity for Android games. If you'd like to make your games
471available on Android TV, be sure to optimize the user experience for the big screen by following
472the recommendations in <a href="/training/tv/games/index.html">Building TV Games</a>.</p>
473
474
475 <p>To get started on Android TV, you need:</p>
476 <ul>
477 <li>The Android 5.0 SDK packages from the
478 <a href="/tools/help/sdk-manager.html">Android SDK Manager</a>,
479 including the <strong>Android TV System Image</strong> so you can create an
480 Android TV emulator.</li>
481 <li>An activity that's launchable from the Android TV home screen. This requires that you
482 add the <a href="/reference/android/content/Intent.html#CATEGORY_LEANBACK_LAUNCHER"
483 ><code>LEANBACK_LAUNCHER</code></a> category to one of your activities. For example:
484<pre>
485&lt;activity ... >
486 &lt;intent-filter>
487 &lt;action android:name="android.intent.action.MAIN" />
488 &lt;category android:name="android.intent.category.LEANBACK_LAUNCHER" />
489 &lt;/intent-filter>
490&lt;/activity>
491</pre>
492 </li>
493
494 <li>For a set of default styles that optimize your UI for the TV's
495 <em>leanback user experience</em>,
496 you should also apply the <a
497 href="/reference/android/support/v17/leanback/R.style.html#Theme_Leanback"
498 ><code>Leanback</code></a> theme to your activity:
499<pre>
500&lt;activity android:theme="@style/Theme.Leanback" ... >
501</pre>
502 </li>
503
504 </ul>
505 <p>You should also take advantage of the <a
smain@google.comf7a7d6d2014-10-17 01:31:24 -0700[diff] [blame]506 href="/tools/support-library/features.html#v17-leanback">v17 leanback library</a>, which
smain@google.com271078f2014-10-09 17:00:20 -0700[diff] [blame]507 provides the <a href="/reference/android/support/v17/leanback/R.style.html#Theme_Leanback"
508 ><code>Leanback</code></a> theme shown above, plus several widgets designed to
509 make your UI beautiful and easy to navigate on the big screen, such as a widget that creates
510 a set of large horizontal card views.</p>
511
512 <p>For more information about setting up a project for your TV app, building
513 TV layouts, and handling controller input,
514 see <a href="/training/tv/start/index.html">Building
515 TV Apps</a>.</p>
516 </div>
517
518
519
520
521
522
523
524
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]525 </div> <!-- end .landing-section -->
526
527
528
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]529
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]530
smain@google.com271078f2014-10-09 17:00:20 -0700[diff] [blame]531
532
533
534 <!-- spacer -->
535 <div class="wrap" style="padding:20px; position:relative">
536 <p>&nbsp;</p>
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]537 </div>
smain@google.com271078f2014-10-09 17:00:20 -0700[diff] [blame]538
539
540
541 <div id="footer" class="wrap" style="width:940px;position:relative;">
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]542 <div id="copyright">
543 Except as noted, this content is
544 licensed under <a href="http://creativecommons.org/licenses/by/2.5/">
545 Creative Commons Attribution 2.5</a>. For details and
smain@google.com271078f2014-10-09 17:00:20 -0700[diff] [blame]546 restrictions, see the <a href="https://developer.android.com/license.html">Content
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]547 License</a>.
548 </div>
549 </div>
550 </div> <!-- end landing-body-content -->
551
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]552 </div>
553
smain@google.com271078f2014-10-09 17:00:20 -0700[diff] [blame]554 <div class="content-footer wrap" itemscope=""
555 itemtype="http://schema.org/SiteNavigationElement">
Joe Fernandezf50f51c2014-06-27 17:00:59 -0700[diff] [blame]556
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]557 <div class="paging-links layout-content-col col-10">
Joe Fernandezf50f51c2014-06-27 17:00:59 -0700[diff] [blame]558
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]559 </div>
Joe Fernandezf50f51c2014-06-27 17:00:59 -0700[diff] [blame]560
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]561 </div>
562
Joe Fernandezf50f51c2014-06-27 17:00:59 -0700[diff] [blame]563
564
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]565
566 </div> <!-- end jd-content -->
567
568<div id="footer" class="wrap" style="width:940px">
Joe Fernandezf50f51c2014-06-27 17:00:59 -0700[diff] [blame]569
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]570
571 <div id="copyright">
Joe Fernandezf50f51c2014-06-27 17:00:59 -0700[diff] [blame]572
573 Except as noted, this content is
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]574 licensed under <a href="http://creativecommons.org/licenses/by/2.5/">
Joe Fernandezf50f51c2014-06-27 17:00:59 -0700[diff] [blame]575 Creative Commons Attribution 2.5</a>. For details and
smain@google.com271078f2014-10-09 17:00:20 -0700[diff] [blame]576 restrictions, see the <a href="https://developer.android.com/license.html">Content
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]577 License</a>.
578 </div>
579
580
581</div> <!-- end footer -->
582</div><!-- end doc-content -->
583
Joe Fernandezf50f51c2014-06-27 17:00:59 -0700[diff] [blame]584</div> <!-- end body-content -->
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]585
586
smain@google.com271078f2014-10-09 17:00:20 -0700[diff] [blame]587<script>
588 var urlRoot = "http://storage.googleapis.com/androiddevelopers/finalpreview/";
589 function onDownload(link) {
590
591 $("#downloadForRealz").html("Download " + $(link).text());
592 $("#downloadForRealz").attr('href', urlRoot + $(link).text());
593
594 $("#tos").show();
595 $("#landing-wrapper").hide();
596
597 return true;
598 }
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]599
600
smain@google.com271078f2014-10-09 17:00:20 -0700[diff] [blame]601 function onAgreeChecked() {
602 /* verify that the TOS is agreed */
603 if ($("input#agree").is(":checked")) {
604 /* reveal the download button */
605 $("a#downloadForRealz").removeClass('disabled');
606 } else {
607 $("a#downloadForRealz").addClass('disabled');
608 }
609 }
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]610
smain@google.com271078f2014-10-09 17:00:20 -0700[diff] [blame]611 function onDownloadForRealz(link) {
612 if ($("input#agree").is(':checked')) {
613 $("#tos").fadeOut('fast');
614 $("#landing-wrapper").fadeIn('fast');
615 ga('send', 'event', 'L Preview', 'System Image', $("#downloadForRealz").html());
616 location.hash = "";
617 // reset the checkbox for future downloads
618 $("#agree").trigger('click');
619 $("a#downloadForRealz").addClass('disabled');
620 return true;
621 } else {
622 $("label#agreeLabel").parent().stop().animate({color: "#258AAF"}, 200,
623 function() {$("label#agreeLabel").parent().stop().animate({color: "#222"}, 200)}
624 );
625 return false;
626 }
627 }
628
smain@google.com271078f2014-10-09 17:00:20 -0700[diff] [blame]629</script>
630
Robert Ly26115662014-06-18 19:56:05 -0700[diff] [blame]631
632</body>
smain@google.com271078f2014-10-09 17:00:20 -0700[diff] [blame]633</html>