Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit bd4ed32f authored by Joe Fernandez's avatar Joe Fernandez
Browse files

docs: Preview 3 - Support page updates 

- Add Key changes
- Add Known issues

Change-Id: I080b191a6609a4216e7521afa951b53f33609b90
parent 42c22d04

docs/html/preview/api-overview.jd

+22 −16
Original line number Diff line number Diff line
@@ -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 class="caution"><strong>Caution:</strong> Do not publish apps

that use the M Developer Preview to the Google Play store.</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>

  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>



<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>

docs/html/preview/download_mp1.jd

+1 −1
Original line number Diff line number Diff line 
page.title=Developer Preview Archive

page.title=Developer Preview 1 Archive

page.image=images/cards/card-download_16-9_2x.png



@jd:body

docs/html/preview/download_mp2.jd

+1 −1
Original line number Diff line number Diff line 
page.title=Downloads

page.title=Developer Preview 2 Archive

page.image=images/cards/card-download_16-9_2x.png



@jd:body

docs/html/preview/setup-sdk.jd

+17 −45
Original line number Diff line number Diff line
@@ -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 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>

<h2 id="get-as13">Get Android Studio 1.3</h2>



  <li> On the <strong>Updates</strong> panel, choose the option

  <strong>Automatically check updates for: Canary Channel</strong>.

  </li>

<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>



  <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>

docs/html/preview/support.jd

+20 −15
Original line number Diff line number Diff line
@@ -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.
@@ -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>

    </ul>

      <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>



  <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>