blob: fb2e266fb0f7d44ad955b31fe8556ca013528c1c [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 Doughertybd58d6f2015-08-17 06:50:29 -0700167 <strong><a href="{@docRoot}preview/download.html">Preview&nbsp;3</a></strong>
168 (final APIs and official Android 6.0 SDK, available).
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700169 </li>
170</ul>
171
172<p>
Dirk Dougherty49eeebb2015-08-16 12:55:29 -0700173 These updates culminate in the <strong>official Android 6.0 SDK</strong> (now available),
174 which lets you build with the final APIs for the new version of Android, as well as
175 near-final system images to let you test system behaviors and features.
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700176</p>
177
178<p>
179 As you test and develop on Android M, we strongly recommend <strong>keeping
180 your development environment up-to-date</strong> as Preview updates are released.
Dirk Doughertyae70b692015-05-27 16:58:46 -0700181 To make the process easier, we'll deliver <strong>updates over-the-air
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700182 (OTA)</strong> to devices already flashed to a Preview build, as well as
183 providing system images that you can download and flash manually.
184</p>
185<p class="note">
Dirk Dougherty2906bd52015-08-13 09:55:30 -0700186 <strong>Note:</strong> Developer Preview 3 includes final APIs and near-final
187 system images available by both download and OTA. At the full public release of
188 Android M later in Q3, final system images will be available by download only,
189 so you'll need to <strong>flash manually</strong> to
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700190 your test devices.</strong>
191</p>
192
193<p>
194 We’ll notify you when Preview updates are available via the <a href=
195 "http://android-developers.blogspot.com/">Android Developers Blog</a>, as
196 well as this site and the
197 <a href="http://g.co/dev/AndroidMDevPreview">Android M Developer Community</a>.
198</p>
199
200<h2 id="preview_tools">
201 What’s in the Preview?
202</h2>
203
204<p>
205 The M Developer Preview includes everything you need to test your existing
206 apps on a variety of screen sizes, network technologies, CPU/GPU chipsets,
207 and hardware architectures.
208</p>
209
210<h4>
211 SDK tools
212</h4>
213
214<p>
215 You can download these components through the SDK Manager in <a href=
216 "{@docRoot}sdk/installing/adding-packages.html">Android Studio</a>:
217</p>
218
219<ul>
Dirk Dougherty49eeebb2015-08-16 12:55:29 -0700220 <li><strong>Official Android 6.0 SDK and tools</strong>
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700221 </li>
222
223 <li>M Developer Preview <strong>emulator system image</strong> (32-bit &amp;
224 64-bit)
225 </li>
226
227 <li>M Developer Preview <strong>emulator system Image for Android TV</strong>
228 (32-bit)
229 </li>
230</ul>
231
232<h4>
233 Hardware system images
234</h4>
235
236<p>
237 You can download these hardware system images for Nexus devices from the
Luan Nguyen17e46062015-05-28 10:42:26 -0700238 <a href="download.html">Downloads page</a>:
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700239</p>
240
241<ul>
242 <li>
243 <strong>Nexus 5</strong> (GSM/LTE) “hammerhead” device system image
244 </li>
245
246 <li>
247 <strong>Nexus 6</strong> “shamu” device system image
248 </li>
249
250 <li>
251 <strong>Nexus 9</strong> (Wi-Fi) “volantis” device system image
252 </li>
253
254 <li>
255 <strong>Nexus Player</strong> (Android TV) “fugu” device system image
256 </li>
257</ul>
258
259<h4>
260 Documentation and sample code
261</h4>
262
263<p>
264 These documentation resources help you learn about the Preview:
265</p>
266
267<ul>
268 <li>
269 <a href="setup-sdk.html">Set Up the SDK</a> has step-by-step instructions
270 for getting started.
271 </li>
272
273 <li>
Luan Nguyen17e46062015-05-28 10:42:26 -0700274 <a href="{@docRoot}preview/testing/guide.html">Testing Guide</a> and <a href=
275 "behavior-changes.html">Behavior Changes</a> point you to key areas to test.
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700276 </li>
277
278 <li>Documentation of new APIs, including an <a href="api-overview.html">API Overview</a>,
Luan Nguyen17e46062015-05-28 10:42:26 -0700279 downloadable <a href="{@docRoot}preview/download.html#docs">API Reference</a>, and detailed developer guides on
280 key features such as
281 <a href="{@docRoot}preview/features/runtime-permissions.html">permissions</a>,
282 <a href="{@docRoot}preview/backup/index.html">app backup</a>, and others.
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700283 </li>
284
285 <li>
Luan Nguyen17e46062015-05-28 10:42:26 -0700286 <a href="{@docRoot}preview/samples.html">Sample code</a> that demonstrates how to support
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700287 permissions and other new features.
288 </li>
289
290 <li>
Luan Nguyen17e46062015-05-28 10:42:26 -0700291 <a href="{@docRoot}preview/support.html#release-notes">Release notes</a> for the current version
292 of the M Developer Preview, including change notes and diff reports.
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700293 </li>
294</ul>
295
296<h4>
297 Support resources
298</h4>
299
300<p>
301 Use these support resources as you test and develop on the M
302 Developer Preview:
303</p>
304
305<ul>
306 <li><a href="https://code.google.com/p/android-developer-preview/">M
307 Developer Preview Issue Tracker</a> is your <strong>primary feedback
308 channel.</strong> You can report bugs, performance issues, and general
Dirk Doughertyae70b692015-05-27 16:58:46 -0700309 feedback through the issue tracker. You can also check for <a
310 href="https://code.google.com/p/android-developer-preview/wiki/KnownIssues">known issues</a>
311 and find workaround steps.
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700312 </li>
313
314 <li>The <a href="http://g.co/dev/AndroidMDevPreview">Android M Developer
315 Community</a> is a Google+ community where you can <strong>connect with
316 other developers</strong> working with Android M. You can share
317 observations or ideas or find answers to questions about Android M.
318 </li>
319</ul>
320
321
322<h2 id="preview_apis_and_publishing">
Dirk Dougherty2906bd52015-08-13 09:55:30 -0700323 Final SDK, targeting, and publishing
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700324</h2>
325
326<p>
Dirk Dougherty2906bd52015-08-13 09:55:30 -0700327 <p>With Developer Preview 3, the platform APIs are now official (API level 23) and the
Dirk Dougherty49eeebb2015-08-16 12:55:29 -0700328 <strong>official Android 6.0 SDK is now available</strong>. We recommend updating your environment
Dirk Dougherty2906bd52015-08-13 09:55:30 -0700329 right away through Android Studio. Once you've updated your environment, you can target
330 the new API level, compile against the new platform, and publish at your convenience
331 to Google Play (including alpha, beta, or release channels).
332
333 <p>If you want to opt out
Dirk Dougherty49eeebb2015-08-16 12:55:29 -0700334 of compatibility behaviors (which is strongly recommended),
335 you can target the Android 6.0 platform by setting your app's <code><a href=
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700336 "/guide/topics/manifest/uses-sdk-element.html">targetSdkVersion</a></code>
Dirk Dougherty49eeebb2015-08-16 12:55:29 -0700337 to <code>“23”</code>.
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700338</p>
339
Dirk Doughertybd58d6f2015-08-17 06:50:29 -0700340 <p>Before releasing an app that targets API level 23, we strongly
Dirk Dougherty49eeebb2015-08-16 12:55:29 -0700341 recommend distributing it to a group of testers through the new <a
Dirk Doughertybd58d6f2015-08-17 06:50:29 -0700342 href="http://android-developers.blogspot.com/2015/07/iterate-faster-on-google-play-with.html">
Dirk Dougherty2906bd52015-08-13 09:55:30 -0700343 beta testing features available in the Google Play Developer Console. See the
344 <a href="https://support.google.com/googleplay/android-developer/answer/3131213">Help
Dirk Doughertybd58d6f2015-08-17 06:50:29 -0700345 Center article</a> for more information.
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700346</p>
347
348<h2 id="get_started">
Dirk Dougherty8c110252015-05-29 16:45:15 -0700349 How to get started
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700350</h2>
351
Joe Fernandezd575b1c2015-05-08 17:16:27 -0700352<p>
Dirk Dougherty2906bd52015-08-13 09:55:30 -0700353 To get started testing your app with Android M:
Joe Fernandezd575b1c2015-05-08 17:16:27 -0700354</p>
355
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700356<ol>
357 <li>Review the <a href="{@docRoot}preview/api-overview.html">API Overview</a>
Luan Nguyen17e46062015-05-28 10:42:26 -0700358 and <a href="{@docRoot}preview/behavior-changes.html">Behavior Changes</a> to get an
Dirk Dougherty8c110252015-05-29 16:45:15 -0700359 idea of what's new and how it affects your apps. In particular, learn about
360 the new <a href="{@docRoot}preview/features/runtime-permissions.html">runtime
361 permissions</a> model, power-saving features, and auto backup.
Joe Fernandezd575b1c2015-05-08 17:16:27 -0700362 </li>
363
Dirk Dougherty8c110252015-05-29 16:45:15 -0700364 <li>Set up your environment by following the instructions for
Joe Fernandezee143ce2015-05-21 21:08:41 -0700365 <a href="{@docRoot}preview/setup-sdk.html">Setting up the Preview SDK</a>
366 and configuring test devices.
Joe Fernandezd575b1c2015-05-08 17:16:27 -0700367 </li>
368
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700369 <li>Follow the <a href="https://developers.google.com/android/nexus/images">
370 flashing instructions</a> to flash the latest M developer preview system image
371 for Nexus 5, 6, 9, and Player. Once you've flashed your development device,
372 Preview updates will be delivered through over-the-air (OTA) updates.</a>
Joe Fernandezd575b1c2015-05-08 17:16:27 -0700373 </li>
374
Dirk Dougherty2906bd52015-08-13 09:55:30 -0700375 <li>Review the <a href="{@docRoot}reference/packages.html">API
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700376 Reference</a> and <a href="{@docRoot}preview/samples.html">M Preview
377 samples</a> to gain more insight into new API features and how to use them in
378 your app.
Joe Fernandezee143ce2015-05-21 21:08:41 -0700379 </li>
380
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700381 <li>Join the <a href="http://g.co/dev/AndroidMDevPreview">Android M
382 Developer Community</a> to get the latest news and connect with other
383 developers working with the new platform.
Joe Fernandezd575b1c2015-05-08 17:16:27 -0700384 </li>
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700385</ol>
Joe Fernandezd575b1c2015-05-08 17:16:27 -0700386
387<p>
Dirk Doughertyc85bf852015-05-24 19:56:35 -0700388 Thank you for your participation in the Android M Developer Preview program!
Rich Slogar962146f2015-05-27 17:43:50 -0700389</p>