docs: Preview 3 - Support page updates
- Add Key changes
- Add Known issues
Change-Id: I080b191a6609a4216e7521afa951b53f33609b90
diff --git a/docs/html/preview/api-overview.jd b/docs/html/preview/api-overview.jd
index e15a657..55829d3 100644
--- a/docs/html/preview/api-overview.jd
+++ b/docs/html/preview/api-overview.jd
@@ -45,7 +45,7 @@
<h2>API Differences</h2>
<ol>
-<li><a href="{@docRoot}preview/download.html">API level 22 to M Preview »</a> </li>
+<li><a href="{@docRoot}sdk/api_diff/23/changes.html">API level 22 to 23 (Preview 3) »</a> </li>
</ol>
</div>
@@ -55,21 +55,27 @@
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>
diff --git a/docs/html/preview/download_mp1.jd b/docs/html/preview/download_mp1.jd
index cb4d300..5838f20 100644
--- a/docs/html/preview/download_mp1.jd
+++ b/docs/html/preview/download_mp1.jd
@@ -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
diff --git a/docs/html/preview/download_mp2.jd b/docs/html/preview/download_mp2.jd
index 0dfabef..0208b5e 100644
--- a/docs/html/preview/download_mp2.jd
+++ b/docs/html/preview/download_mp2.jd
@@ -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
diff --git a/docs/html/preview/setup-sdk.jd b/docs/html/preview/setup-sdk.jd
index d3327e8..a4d9418 100644
--- a/docs/html/preview/setup-sdk.jd
+++ b/docs/html/preview/setup-sdk.jd
@@ -16,56 +16,30 @@
</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 > Settings</strong>). Choose the
- <strong>Appearance & Behavior > System
- Settings > Updates</strong> panel.
-
- <p class="aside">On OSX, you can find the <strong>Appearance &
- 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 @@
<strong>Appearance & Behavior > System
Settings > Updates</strong> panel.
- <p class="aside">On OSX, you can find the <strong>Appearance &
+ <p class="aside">On Mac OS X, you can find the <strong>Appearance &
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 @@
<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 @@
</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>
diff --git a/docs/html/preview/support.jd b/docs/html/preview/support.jd
index a3bfe7e..49d4906 100644
--- a/docs/html/preview/support.jd
+++ b/docs/html/preview/support.jd
@@ -57,7 +57,7 @@
<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 & ARM 32/64-bit<br>
Google Play services: 7.8</em>
@@ -70,7 +70,7 @@
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 @@
</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 @@
<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 @@
</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 @@
<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 @@
</li>
</ul>
-<h3 id="changes">
+<h3 id="changes-p2">
Key changes
</h3>
@@ -405,7 +410,7 @@
"{@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 @@
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>
