blob: 1e814565adacb0e5d6fea8974c0ddfe7347be655 [file] [log] [blame]
Dirk Doughertyc85bf852015-05-24 19:56:35 -07001page.title=Program Overview
2page.metaDescription=Welcome to the Android M Developer Preview, a program that gives you everything you need to test and optimize your apps for the next version of Android.
Dirk Dougherty74709452015-05-15 00:51:24 -07003page.image=images/cards/card-preview_16-9_2x.png
Dirk Doughertyc85bf852015-05-24 19:56:35 -07004page.tags="preview", "developer", "android"
Joe Fernandeze7866882015-05-06 17:15:03 -07005
6@jd:body
7
David Friedman6fb22b42015-07-09 16:00:38 -07008<div class="cols" style=
Dirk Dougherty2906bd52015-08-13 09:55:30 -07009"background-color:#f2daf5; padding: 5px 0;margin-bottom:1em; text-align:center;">
David Friedman6fb22b42015-07-09 16:00:38 -070010<h3>
Dirk Dougherty2906bd52015-08-13 09:55:30 -070011 Developer Preview 3 is now available
David Friedman6fb22b42015-07-09 16:00:38 -070012 </h3>
Dirk Dougherty2906bd52015-08-13 09:55:30 -070013 <p>Includes final SDK and near-final system images</p>
14 <div style="margin:auto 1em">
David Friedman6fb22b42015-07-09 16:00:38 -070015 <ul class="dac-section-links">
16 <li class="dac-section-link">
Dirk Dougherty2906bd52015-08-13 09:55:30 -070017 <a href="{@docRoot}preview/support.html#preview3-notes">
David Friedman6fb22b42015-07-09 16:00:38 -070018 <span class="dac-sprite dac-auto-chevron"></span>
19 Read the Notes</a>
20 </li>
21
22 <li class="dac-section-link">
Dirk Dougherty2906bd52015-08-13 09:55:30 -070023 <a href="{@docRoot}preview/support.html#preview3-get">
David Friedman6fb22b42015-07-09 16:00:38 -070024 <span class="dac-sprite dac-auto-chevron"></span>
25 Get the Update</a>
26 </li>
27
28 <li class="dac-section-link">
29 <a href="https://code.google.com/p/android-developer-preview/">
30 <span class="dac-sprite dac-auto-chevron"></span>
31 Report Issues</a>
32 </li>
33 </ul>
Dirk Dougherty2906bd52015-08-13 09:55:30 -070034 </div>
David Friedman6fb22b42015-07-09 16:00:38 -070035</div>
36
Joe Fernandeze7866882015-05-06 17:15:03 -070037<p>
Dirk Doughertyc85bf852015-05-24 19:56:35 -070038 Welcome to the <strong>Android M Developer Preview</strong>, a program that gives you
39 everything you need to test and optimize your apps for the next version of
40 Android. It's free, and you can get started right away just by downloading
41 the M Developer Preview tools.
Joe Fernandezd575b1c2015-05-08 17:16:27 -070042</p>
43
Dirk Doughertyc85bf852015-05-24 19:56:35 -070044<div style="background-color:#eceff1;padding:1em;">
45<div class="wrap">
46 <div class="cols">
47 <div class="col-4of12">
48 <h5>
49 Hardware and emulator system images
50 </h5>
51
52 <p>
53 Run and test your apps on Nexus 5, 6, 9, and Player (for TV), as well
54 as emulator.
55 </p>
56 </div>
57
58 <div class="col-4of12">
59 <h5>
60 Latest platform code
61 </h5>
62
63 <p>
64 We’ll provide multiple updates during the Preview, so you’ll be testing
65 against the latest platform changes.
66 </p>
67 </div>
68
69 <div class="col-4of12">
70 <h5>
71 Updates delivered by OTA
72 </h5>
73
74 <p>
Dirk Doughertyae70b692015-05-27 16:58:46 -070075 You can get updates over-the-air, once you’ve flashed a
Dirk Doughertyc85bf852015-05-24 19:56:35 -070076 device to the initial preview.
77 </p>
78 </div>
79 </div>
80
81 <div class="cols">
82
Dirk Doughertyc85bf852015-05-24 19:56:35 -070083
84 <div class="col-4of12">
85 <h5>
86 New behaviors and capabilities
87 </h5>
88
89 <p>
90 Start work early to support new platform behaviors such as
91 the new runtime permissions model and power-saving features.
92 </p>
93 </div>
94
95 <div class="col-4of12">
96 <h5>
97 Priority window for developer-reported issues
98 </h5>
99
100 <p>
101 During the first several weeks we’ll give priority to developer-reported
102 issues, so test and give feedback as soon as possible.
103 </p>
104 </div>
105
106 <div class="col-4of12">
107 <h5>
Dirk Doughertyae70b692015-05-27 16:58:46 -0700108 Feedback and support
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700109 </h5>
110
111 <p>
112 Report issues and give us feedback using our <a href=
113 "https://code.google.com/p/android-developer-preview/">issue tracker</a>.
114 Connect with other developers in the <a
115 href="http://g.co/dev/AndroidMDevPreview">M&nbsp;Developer Community</a>.
Dirk Doughertyae70b692015-05-27 16:58:46 -0700116
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700117 </p>
118 </div>
119 </div>
120</div>
121</div>
122
123<!--
124<p>
125 With the M Developer Preview, you'll get an early start on testing your apps,
126 with enough time to make adjustments before the public platform release later
127 in the year. We'll provide several updates to the Preview tools in the weeks
128 ahead, so you can keep in sync with the latest changes as the platform moves
129 toward launch.
130</p>
131<img src="{@docRoot}preview/images/m-preview-timeline.png" alt=
132"Preview program timeline" id="timeline">
133<p>
134 You can help us improve the platform by <a href=
135 "https://code.google.com/p/android-developer-preview/">reporting issues</a>
136 through our feedback channels. This is especially
137 critical in the first month of the preview, when we’ll be giving priority to
138 developer-reported issues and feedback.
139</p> -->
140
141
142<h2 id="timeline">
143 Timeline and updates
144</h2>
145<img src="{@docRoot}preview/images/m-preview-timeline-crop.png" alt=
146"Preview program timeline" id="timeline">
147<p>
Dirk Dougherty2906bd52015-08-13 09:55:30 -0700148 The M Developer Preview runs from May 28 until the final Android M public release planned for Q3
Luan Nguyen17e46062015-05-28 10:42:26 -0700149 2015.
Joe Fernandezd575b1c2015-05-08 17:16:27 -0700150</p>
151
152<p>
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700153 At key development milestones, we’ll deliver updates for your test devices.
Dirk Dougherty2906bd52015-08-13 09:55:30 -0700154 The milestones are
Joe Fernandezd575b1c2015-05-08 17:16:27 -0700155</p>
156
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700157<ul>
158 <li>
David Friedman6fb22b42015-07-09 16:00:38 -0700159 <strong><a href="{@docRoot}preview/download_mp1.html">Preview&nbsp;1</a></strong> (available).
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700160 </li>
161
162 <li>
Dirk Dougherty49eeebb2015-08-16 12:55:29 -0700163 <strong><a href="{@docRoot}preview/download_mp2.html">Preview&nbsp;2</a></strong> (available).
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700164 </li>
165
166 <li>
Dirk Dougherty49eeebb2015-08-16 12:55:29 -0700167 <strong><a href="{@docRoot}preview/download.html">Preview&nbsp;3</strong> (final APIs and official Android 6.0 SDK, available).
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700168 </li>
169</ul>
170
171<p>
Dirk Dougherty49eeebb2015-08-16 12:55:29 -0700172 These updates culminate in the <strong>official Android 6.0 SDK</strong> (now available),
173 which lets you build with the final APIs for the new version of Android, as well as
174 near-final system images to let you test system behaviors and features.
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700175</p>
176
177<p>
178 As you test and develop on Android M, we strongly recommend <strong>keeping
179 your development environment up-to-date</strong> as Preview updates are released.
Dirk Doughertyae70b692015-05-27 16:58:46 -0700180 To make the process easier, we'll deliver <strong>updates over-the-air
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700181 (OTA)</strong> to devices already flashed to a Preview build, as well as
182 providing system images that you can download and flash manually.
183</p>
184<p class="note">
Dirk Dougherty2906bd52015-08-13 09:55:30 -0700185 <strong>Note:</strong> Developer Preview 3 includes final APIs and near-final
186 system images available by both download and OTA. At the full public release of
187 Android M later in Q3, final system images will be available by download only,
188 so you'll need to <strong>flash manually</strong> to
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700189 your test devices.</strong>
190</p>
191
192<p>
193 We’ll notify you when Preview updates are available via the <a href=
194 "http://android-developers.blogspot.com/">Android Developers Blog</a>, as
195 well as this site and the
196 <a href="http://g.co/dev/AndroidMDevPreview">Android M Developer Community</a>.
197</p>
198
199<h2 id="preview_tools">
200 What’s in the Preview?
201</h2>
202
203<p>
204 The M Developer Preview includes everything you need to test your existing
205 apps on a variety of screen sizes, network technologies, CPU/GPU chipsets,
206 and hardware architectures.
207</p>
208
209<h4>
210 SDK tools
211</h4>
212
213<p>
214 You can download these components through the SDK Manager in <a href=
215 "{@docRoot}sdk/installing/adding-packages.html">Android Studio</a>:
216</p>
217
218<ul>
Dirk Dougherty49eeebb2015-08-16 12:55:29 -0700219 <li><strong>Official Android 6.0 SDK and tools</strong>
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700220 </li>
221
222 <li>M Developer Preview <strong>emulator system image</strong> (32-bit &amp;
223 64-bit)
224 </li>
225
226 <li>M Developer Preview <strong>emulator system Image for Android TV</strong>
227 (32-bit)
228 </li>
229</ul>
230
231<h4>
232 Hardware system images
233</h4>
234
235<p>
236 You can download these hardware system images for Nexus devices from the
Luan Nguyen17e46062015-05-28 10:42:26 -0700237 <a href="download.html">Downloads page</a>:
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700238</p>
239
240<ul>
241 <li>
242 <strong>Nexus 5</strong> (GSM/LTE) “hammerhead” device system image
243 </li>
244
245 <li>
246 <strong>Nexus 6</strong> “shamu” device system image
247 </li>
248
249 <li>
250 <strong>Nexus 9</strong> (Wi-Fi) “volantis” device system image
251 </li>
252
253 <li>
254 <strong>Nexus Player</strong> (Android TV) “fugu” device system image
255 </li>
256</ul>
257
258<h4>
259 Documentation and sample code
260</h4>
261
262<p>
263 These documentation resources help you learn about the Preview:
264</p>
265
266<ul>
267 <li>
268 <a href="setup-sdk.html">Set Up the SDK</a> has step-by-step instructions
269 for getting started.
270 </li>
271
272 <li>
Luan Nguyen17e46062015-05-28 10:42:26 -0700273 <a href="{@docRoot}preview/testing/guide.html">Testing Guide</a> and <a href=
274 "behavior-changes.html">Behavior Changes</a> point you to key areas to test.
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700275 </li>
276
277 <li>Documentation of new APIs, including an <a href="api-overview.html">API Overview</a>,
Luan Nguyen17e46062015-05-28 10:42:26 -0700278 downloadable <a href="{@docRoot}preview/download.html#docs">API Reference</a>, and detailed developer guides on
279 key features such as
280 <a href="{@docRoot}preview/features/runtime-permissions.html">permissions</a>,
281 <a href="{@docRoot}preview/backup/index.html">app backup</a>, and others.
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700282 </li>
283
284 <li>
Luan Nguyen17e46062015-05-28 10:42:26 -0700285 <a href="{@docRoot}preview/samples.html">Sample code</a> that demonstrates how to support
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700286 permissions and other new features.
287 </li>
288
289 <li>
Luan Nguyen17e46062015-05-28 10:42:26 -0700290 <a href="{@docRoot}preview/support.html#release-notes">Release notes</a> for the current version
291 of the M Developer Preview, including change notes and diff reports.
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700292 </li>
293</ul>
294
295<h4>
296 Support resources
297</h4>
298
299<p>
300 Use these support resources as you test and develop on the M
301 Developer Preview:
302</p>
303
304<ul>
305 <li><a href="https://code.google.com/p/android-developer-preview/">M
306 Developer Preview Issue Tracker</a> is your <strong>primary feedback
307 channel.</strong> You can report bugs, performance issues, and general
Dirk Doughertyae70b692015-05-27 16:58:46 -0700308 feedback through the issue tracker. You can also check for <a
309 href="https://code.google.com/p/android-developer-preview/wiki/KnownIssues">known issues</a>
310 and find workaround steps.
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700311 </li>
312
313 <li>The <a href="http://g.co/dev/AndroidMDevPreview">Android M Developer
314 Community</a> is a Google+ community where you can <strong>connect with
315 other developers</strong> working with Android M. You can share
316 observations or ideas or find answers to questions about Android M.
317 </li>
318</ul>
319
320
321<h2 id="preview_apis_and_publishing">
Dirk Dougherty2906bd52015-08-13 09:55:30 -0700322 Final SDK, targeting, and publishing
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700323</h2>
324
325<p>
Dirk Dougherty2906bd52015-08-13 09:55:30 -0700326 <p>With Developer Preview 3, the platform APIs are now official (API level 23) and the
Dirk Dougherty49eeebb2015-08-16 12:55:29 -0700327 <strong>official Android 6.0 SDK is now available</strong>. We recommend updating your environment
Dirk Dougherty2906bd52015-08-13 09:55:30 -0700328 right away through Android Studio. Once you've updated your environment, you can target
329 the new API level, compile against the new platform, and publish at your convenience
330 to Google Play (including alpha, beta, or release channels).
331
332 <p>If you want to opt out
Dirk Dougherty49eeebb2015-08-16 12:55:29 -0700333 of compatibility behaviors (which is strongly recommended),
334 you can target the Android 6.0 platform by setting your app's <code><a href=
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700335 "/guide/topics/manifest/uses-sdk-element.html">targetSdkVersion</a></code>
Dirk Dougherty49eeebb2015-08-16 12:55:29 -0700336 to <code>“23”</code>.
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700337</p>
338
Dirk Dougherty49eeebb2015-08-16 12:55:29 -0700339 <p>Before releasing your app targeting API level 23, we strongly
340 recommend distributing it to a group of testers through the new <a
Dirk Dougherty2906bd52015-08-13 09:55:30 -0700341 href="http://android-developers.blogspot.com/2015/07/iterate-faster-on-google-play-with.html">
342 beta testing features available in the Google Play Developer Console. See the
343 <a href="https://support.google.com/googleplay/android-developer/answer/3131213">Help
344 Center article</a> for more information.
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700345</p>
346
347<h2 id="get_started">
Dirk Dougherty8c110252015-05-29 16:45:15 -0700348 How to get started
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700349</h2>
350
Joe Fernandezd575b1c2015-05-08 17:16:27 -0700351<p>
Dirk Dougherty2906bd52015-08-13 09:55:30 -0700352 To get started testing your app with Android M:
Joe Fernandezd575b1c2015-05-08 17:16:27 -0700353</p>
354
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700355<ol>
356 <li>Review the <a href="{@docRoot}preview/api-overview.html">API Overview</a>
Luan Nguyen17e46062015-05-28 10:42:26 -0700357 and <a href="{@docRoot}preview/behavior-changes.html">Behavior Changes</a> to get an
Dirk Dougherty8c110252015-05-29 16:45:15 -0700358 idea of what's new and how it affects your apps. In particular, learn about
359 the new <a href="{@docRoot}preview/features/runtime-permissions.html">runtime
360 permissions</a> model, power-saving features, and auto backup.
Joe Fernandezd575b1c2015-05-08 17:16:27 -0700361 </li>
362
Dirk Dougherty8c110252015-05-29 16:45:15 -0700363 <li>Set up your environment by following the instructions for
Joe Fernandezee143ce2015-05-21 21:08:41 -0700364 <a href="{@docRoot}preview/setup-sdk.html">Setting up the Preview SDK</a>
365 and configuring test devices.
Joe Fernandezd575b1c2015-05-08 17:16:27 -0700366 </li>
367
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700368 <li>Follow the <a href="https://developers.google.com/android/nexus/images">
369 flashing instructions</a> to flash the latest M developer preview system image
370 for Nexus 5, 6, 9, and Player. Once you've flashed your development device,
371 Preview updates will be delivered through over-the-air (OTA) updates.</a>
Joe Fernandezd575b1c2015-05-08 17:16:27 -0700372 </li>
373
Dirk Dougherty2906bd52015-08-13 09:55:30 -0700374 <li>Review the <a href="{@docRoot}reference/packages.html">API
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700375 Reference</a> and <a href="{@docRoot}preview/samples.html">M Preview
376 samples</a> to gain more insight into new API features and how to use them in
377 your app.
Joe Fernandezee143ce2015-05-21 21:08:41 -0700378 </li>
379
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700380 <li>Join the <a href="http://g.co/dev/AndroidMDevPreview">Android M
381 Developer Community</a> to get the latest news and connect with other
382 developers working with the new platform.
Joe Fernandezd575b1c2015-05-08 17:16:27 -0700383 </li>
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700384</ol>
Joe Fernandezd575b1c2015-05-08 17:16:27 -0700385
386<p>
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700387 Thank you for your participation in the Android M Developer Preview program!
Rich Slogar962146f2015-05-27 17:43:50 -0700388</p>