docs: Preview 3 - Support page updates

- Add Key changes
- Add Known issues

Change-Id: I080b191a6609a4216e7521afa951b53f33609b90
This commit is contained in:
Joe Fernandez
2015-08-16 16:56:02 -07:00
parent 42c22d04d9
commit bd4ed32ffa
5 changed files with 59 additions and 76 deletions

View File

@@ -45,7 +45,7 @@ page.image=images/cards/card-api-overview_16-9_2x.png
<h2>API Differences</h2>
<ol>
<li><a href="{@docRoot}preview/download.html">API level 22 to M Preview &raquo;</a> </li>
<li><a href="{@docRoot}sdk/api_diff/23/changes.html">API level 22 to 23 (Preview 3) &raquo;</a> </li>
</ol>
</div>
@@ -55,21 +55,27 @@ page.image=images/cards/card-api-overview_16-9_2x.png
for the Android platform, which offers new features for users and app
developers. This document provides an introduction to the most notable APIs.</p>
<p>The M Developer Preview is intended for <strong>developer early
adopters</strong> and <strong>testers</strong>. If you are interested in
influencing the direction of the Android framework,
<a href="{@docRoot}preview/setup-sdk.html">give the M Developer Preview a
try</a> and send us your feedback!</p>
<p>
The M Developer Preview 3 release includes the <strong>final APIs for Android 6.0 (API level
23)</strong>. If you are preparing an app for use on Android 6.0,
<a href="{@docRoot}preview/setup-sdk.html">download the latest SDK</a> and to complete your
final updates and release testing. You can review the final APIs in the
<a href="{@docRoot}reference/packages.html">API Reference</a> and see the API differences in
the <a href="{@docRoot}sdk/api_diff/23/changes.html">Android API Differences Report</a>.
</p>
<p class="caution"><strong>Caution:</strong> Do not publish apps
that use the M Developer Preview to the Google Play store.</p>
</p>
<p class="note"><strong>Note:</strong> This document often refers to classes and
methods that do not yet have reference material available on <a
href="{@docRoot}">developer.android.com</a>. These API elements are
formatted in {@code code style} in this document (without hyperlinks). For the
preliminary API documentation for these elements, download the <a
href="{@docRoot}preview/download.html#docs"> preview reference</a>.</p>
<p class="caution"><strong>Important:</strong>
You may now publish apps that target Android 6.0 (API level 23) to the Google Play store.
</p>
<p class="note"><strong>Note:</strong>
If you have been working with previous preview releases and want to see the differences
between the final API and previous preview versions, download the additional difference
reports included in the <a href="{@docRoot}preview/download.html#docs">preview docs
reference</a>.
</p>
<h3>Important behavior changes</h3>

View File

@@ -1,4 +1,4 @@
page.title=Developer Preview Archive
page.title=Developer Preview 1 Archive
page.image=images/cards/card-download_16-9_2x.png
@jd:body

View File

@@ -1,4 +1,4 @@
page.title=Downloads
page.title=Developer Preview 2 Archive
page.image=images/cards/card-download_16-9_2x.png
@jd:body

View File

@@ -16,56 +16,30 @@ page.image=images/cards/card-set-up_16-9_2x.png
</div>
</div>
<p>The M Developer Preview SDK is available from the Android SDK Manager.
This document assumes that you are familiar with Android app development, such
<p>With Developer Preview 3, the official Android 6.0 SDK is now available from the Android SDK
Manager. This document assumes that you are familiar with Android app development, such
as using the Android SDK Manager and creating projects. If you are new to
Android, see <a href="{@docRoot}training/basics/firstapp/index.html">Building Your First
App</a> training lesson first.</a></p>
App</a> training lesson first.</p>
<h2 id="get-as13">Get Android Studio 1.3</h2>
<p>The Developer Preview is best used with Android Studio 1.3, which is in
preview status. It is highly recommended that you install the preview version of
Android Studio 1.3 to work with the Preview SDK.</p>
<p>
The Developer Preview is best used with Android Studio 1.3. It is highly recommended that
you install the Android Studio 1.3 to work with the Preview SDK and the final Android 6.0 SDK
provided with Preview 3. Please update your Android Studio installation to version 1.3 or
higher, or follow the instructions for
<a href="{@docRoot}sdk/installing/index.html?pkg=studio">Installing Android Studio</a>.
</p>
<p class="caution"><strong>Caution:</strong> The canary preview of Android
Studio 1.3 is still in active development. If you are using your primary development
machine to test the developer preview, you can create a second installation
of Android Studio to use for testing.</p>
<p>To install the Android Studio 1.3 preview:</p>
<ol>
<li>Download and launch <a href="{@docRoot}tools/studio/index.html">Android
Studio</a>.
</li>
<li>Open the <strong>Settings</strong> window (on Windows, you can do this
by choosing <strong>File &gt; Settings</strong>). Choose the
<strong>Appearance &amp; Behavior &gt; System
Settings &gt; Updates</strong> panel.
<p class="aside">On OSX, you can find the <strong>Appearance &amp;
Behavior</strong> panel
in Android Studio's <strong>Preferences</strong> window.</p>
</li>
<li> On the <strong>Updates</strong> panel, choose the option
<strong>Automatically check updates for: Canary Channel</strong>.
</li>
<li>On the <strong>Updates</strong> panel, select <strong>Check Now</strong>
to check for the latest canary build. Download and install the build when you
are prompted.
</li>
</ol>
<h2 id="get-sdk">Get the Preview SDK</h2>
<p>To add the Preview SDK components to your development environment:</p>
<ol>
<li>Launch the Android Studio 1.3 preview.
<li>Launch Android Studio 1.3 or higher.
</li>
<li>Open the <strong>Settings</strong> window (on Windows, you can do this
@@ -73,13 +47,12 @@ of Android Studio to use for testing.</p>
<strong>Appearance &amp; Behavior &gt; System
Settings &gt; Updates</strong> panel.
<p class="aside">On OSX, you can find the <strong>Appearance &amp;
<p class="aside">On Mac OS X, you can find the <strong>Appearance &amp;
Behavior</strong> panel
in Android Studio's <strong>Preferences</strong> window.</p>
</li>
<li>On the <strong>Updates</strong> panel, choose the options
<strong>Automatically check updates for: Canary Channel</strong> and
<li>On the <strong>Updates</strong> panel, choose the option for
<strong>Automatically check updates for Android SDK: Preview Channel</strong>.
</li>
@@ -135,7 +108,7 @@ of Android Studio to use for testing.</p>
<ul>
<li>Check <strong>Phone and Tablet</strong>.</li>
<li>Select <strong>MNC: Android M (Preview)</strong> in <strong>Minimum
<li>Select <strong>API 23: Android 6.0 (Marshmallow)</strong> in <strong>Minimum
SDK</strong>.</li>
</ul>
@@ -149,9 +122,8 @@ of Android Studio to use for testing.</p>
</p>
<ul>
<li><code>compileSdkVersion</code> is set to <code>'android-MNC'</code></li>
<li><code>minSdkVersion</code> is set to <code>'MNC'</code></li>
<li><code>targetSdkVersion</code> is set to <code>'MNC'</code></li>
<li><code>compileSdkVersion</code> is set to <code>'23'</code></li>
<li><code>targetSdkVersion</code> is set to <code>'23'</code></li>
</ul>

View File

@@ -57,7 +57,7 @@ page.image=images/cards/card-support_16-9_2x.png
<div class="col-9of16">
<p>
<em>Date: August 2015<br>
Builds: XXXXXX (Nexus 5, 6, 9), XXXXXX (Nexus Player)<br>
Build: MPA44G<br>
Hardware support: Nexus 5, 6, 9, Player<br>
Emulator support: x86 &amp; ARM 32/64-bit<br>
Google Play services: 7.8</em>
@@ -70,7 +70,7 @@ page.image=images/cards/card-support_16-9_2x.png
Developer Preview 3 is the <strong>final incremental update</strong>
to the Android M preview platform that was originally released in May 2015.
The update includes <strong>final APIs and the official Android 6.0 SDK</strong>,
as well as <strong>near-final system images</strong> for testing your apps. The
as well as near-final system images for testing your apps. The
updated system images bring a variety of fixes and enhancements across
the system, including those related to issues reported by developers
through the external issue tracker.
@@ -95,7 +95,7 @@ page.image=images/cards/card-support_16-9_2x.png
</h3>
<p>
Developer Preview 3 includes the official Android 6.0
Developer Preview 3 includes the official Android 6.0
SDK as well as updated preview system images, documentation,
and samples for developing against the Android 6.0
development platform.
@@ -134,7 +134,7 @@ page.image=images/cards/card-support_16-9_2x.png
<li>
<a href=
"https://github.com/googlesamples/android-RuntimePermissions">RuntimePermissions</a>
/ <a href=
and <a href=
"https://github.com/googlesamples/android-RuntimePermissionsBasic">RuntimePermissionsBasic</a>
are updated to reflect latest permissions API changes, including
<code>shouldShowRequestPermissionRationale()</code>.
@@ -151,16 +151,18 @@ page.image=images/cards/card-support_16-9_2x.png
</h3>
<ul>
<li>Add here
<li>Permission changes
<ul>
<li>
<li>The {@link android.Manifest.permission#GET_ACCOUNTS} permission is now a member of the
{@link android.Manifest.permission_group#CONTACTS} permission group and it has a
{@code android:protectionLevel} of {@code dangerous}. This change means that when
targeting Android 6.0 (API level 23), you must check for and request this permission if
your app requires it.
</li>
</ul>
</li>
<li>Other changes
<ul>
<li>
<li>The {@code android.permission.READ_PROFILE} and {@code android.permission.WRITE_PROFILE}
permissions have been removed from the {@link android.Manifest.permission_group#CONTACTS}
permission group.
</li>
</ul>
</li>
@@ -178,7 +180,10 @@ page.image=images/cards/card-support_16-9_2x.png
<ul>
<li>General issues:
<ul>
<li>Add
<li>On LTE devices, including volantis, GPS is not functioning properly, which may
interfere with navigation services.
</li>
<li>During Hangouts calls, users may experience distorted or low audio on some devices.
</li>
</ul>
</li>
@@ -314,7 +319,7 @@ page.image=images/cards/card-support_16-9_2x.png
</li>
</ul>
<h3 id="changes">
<h3 id="changes-p2">
Key changes
</h3>
@@ -405,7 +410,7 @@ page.image=images/cards/card-support_16-9_2x.png
"{@docRoot}preview/download.html#docs">Developer Documentation download package</a>.
</p>
<h3 id="ki">
<h3 id="ki-p2">
Known issues
</h3>
@@ -463,7 +468,7 @@ page.image=images/cards/card-support_16-9_2x.png
Developer Preview 2 system images for supported Nexus devices are available
by download and by over-the-air (OTA) update. The OTA update is available
only to supported devices that are currently running Developer Preview 1. If
your devices is running Developer Preview 1, you should automatically receive
your devices are running Developer Preview 1, you should automatically receive
the OTA update within a few days of availability.
</p>