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

Commit 1d34b1ec authored by Dirk Dougherty's avatar Dirk Dougherty Committed by Android Git Automerger
Browse files

am f125efa4: am d9f16aea: am af3c755c: am bc243440: am 590a25a3: am 70f1aadd:... 

am f125efa4: am d9f16aea: am af3c755c: am bc243440: am 590a25a3: am 70f1aadd: Doc change: add version notes for preview 2.

* commit 'f125efa4':
  Doc change: add version notes for preview 2.
parents 1d475de2 f125efa4

docs/html/design/index.jd

+1 −1
Original line number Diff line number Diff line
@@ -17,7 +17,7 @@ footer.hide=1 
        <h1 class="dac-hero-title">Up and running with material design</h1>

        <p class="dac-hero-description">

        Android uses a new design metaphor inspired by paper and ink that provides a reassuring

        sense of tactility. Visit the <a href="http://www.google.com/design/spec/material-design/introduction">material design</a> site for more resources. 

        sense of tactility. Visit the <a href="https://www.google.com/design/spec/material-design/introduction.html">material design</a> site for more resources. 

        </p>

        <a class="dac-hero-cta" href="https://www.google.com/design/spec/material-design/introduction.html">

          <span class="dac-sprite dac-auto-chevron"></span>

docs/html/preview/behavior-changes.jd

+27 −9
Original line number Diff line number Diff line
@@ -396,12 +396,14 @@ outside of a managed context, the add account flow now prompts the user to insta 
appropriate WPC. This behavior also applies to accounts added via

<strong>Settings > Accounts</strong> in the initial device setup wizard.</li>

<li><strong>Changes to specific DevicePolicyManager API behaviors:</strong>

Calling the {@link android.app.admin.DevicePolicyManager#setCameraDisabled(android.content.ComponentName,boolean) setCameraDisabled()}

  <ul>

  <li>Calling the {@link android.app.admin.DevicePolicyManager#setCameraDisabled(android.content.ComponentName,boolean) setCameraDisabled()}

method affects the camera for the calling user only; calling it from the managed profile doesn’t

affect camera apps running on the primary user. In addition, the

affect camera apps running on the primary user. </li>

  <li>In addition, the

{@link android.app.admin.DevicePolicyManager#setKeyguardDisabledFeatures(android.content.ComponentName,int) setKeyguardDisabledFeatures()}

method is now available for Profile Owners, in addition to Device Owners. A Profile Owner can set

these keyguard restrictions:

    method is now available for Profile Owners, in addition to Device Owners. </li>

  <li>A Profile Owner can set these keyguard restrictions:

    <ul>

    <li>{@link android.app.admin.DevicePolicyManager#KEYGUARD_DISABLE_TRUST_AGENTS} and

    {@link android.app.admin.DevicePolicyManager#KEYGUARD_DISABLE_FINGERPRINT}, which affect the
@@ -410,4 +412,20 @@ these keyguard restrictions: 
    only affects notifications generated by applications in the managed profile.</li>

    </ul>

  </li>

  <li>The {@link android.app.admin.DevicePolicyManager#createAndInitializeUser(android.content.ComponentName, java.lang.String, java.lang.String, android.content.ComponentName, android.os.Bundle)} and {@link android.app.admin.DevicePolicyManager#createUser(android.content.ComponentName, java.lang.String) methods createAndInitializeUser have been deprecated.</li>

    <li>Android for Work APIs are optimized for M runtime permssions, including Work profiles, assist layer, and others. DevicePolicyManager APIs support runtime permissions without affecting pre-M apps. </li>

    </ul>

    <li><strong>Changes to global settings</strong> &mdash; the settings below can no longer be set via <code>setGlobalSettings</code>:

<ul>

    <li><code>BLUETOOTH_ON</code></li>

    <li><code>DEVELOPMENT_SETTINGS_ENABLED</code></li>

    <li><code>MODE_RINGER</code></li>

    <li><code>NETWORK_PREFERENCE</code></li>

    <li><code>WIFI_ON</code></li> 

</ul>

    </li>





    </ul>

docs/html/preview/index.jd

+4 −0
Original line number Diff line number Diff line
@@ -28,6 +28,10 @@ footer.hide=1 
          <span class="dac-sprite dac-auto-chevron"></span>

          Get started

        </a><br>

        <a class="dac-hero-cta" href="{@docRoot}preview/support.html">

          <span class="dac-sprite dac-auto-chevron"></span>

          Update to Developer Preview 2

        </a><br>

      </div>

    </div>

    <div class="dac-section dac-small">

docs/html/preview/support.jd

+314 −52
Original line number Diff line number Diff line 
page.title=Support

page.tags="preview", "developer preview"

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



@jd:body



<div class="cols" style=

"background-color:#ffebc3; padding: 5px 0;margin-bottom:1em; text-align:center;">

<h3>

    Developer Preview 2 is now available

  </h3>



 <ul class="dac-section-links">

    <li class="dac-section-link">

      <a href="#preview2-notes">

      <span class="dac-sprite dac-auto-chevron"></span>

      Release notes</a>

    </li>



    <li class="dac-section-link">

      <a href="#preview2-get">

      <span class="dac-sprite dac-auto-chevron"></span>

      Get the Update</a>

    </li>



    <li class="dac-section-link">

      <a href="https://code.google.com/p/android-developer-preview/">

      <span class="dac-sprite dac-auto-chevron"></span>

      Report Issues</a>

    </li>

  </ul>

</div>



<p>

  If you've encountered bugs or have feedback about the M Developer Preview,

  <a href="https://code.google.com/p/android-developer-preview/">create an issue</a>

  on our issue tracker.

  Two primary support channels are available to you when developing and testing

  with the Android M Developer Preview. If you've encountered bugs or have

  feedback about the M Developer Preview, you can <a href=

  "https://code.google.com/p/android-developer-preview/">create an issue</a> on

  our issue tracker. We'll triage the issue for further review and provide

  updates as needed.

</p>



<p>

  For more support, join the

  <a href="http://g.co/dev/AndroidMDevPreview">M Developer

  Preview Google+ community</a> to discuss your development experiences.

  To discuss issues or ideas with other developers working with Android M, join

  the <a href="http://g.co/dev/AndroidMDevPreview">M Developer Preview Google+

  community</a>.

</p>



<h2 id="preview2-notes">

  Developer Preview 2

</h2>



<div class="wrap">

  <div class="cols">

    <div class="col-5of12">

      <p>

        <em>Date: July 2015<br>

        Build: MPZ79M<br>

        Hardware support: Nexus 5,6,9, Player<br>

        Emulator support: ARM 32/64-bit<br>

        Google Play services: 7.5</em>

      </p>

    </div>

  </div>

</div>



<h2 id="release-notes">Release Notes</h2>

<p>

  Android M Developer Preview 2 is an <strong>incremental update</strong> to

  the Android M preview platform that was originally released in May 2015. The

  update includes a variety of enhancements and bug fixes made across the

  system, including those related to issues reported by developers through the

  external issue tracker.

</p>



<div class="toggle-content opened">

  <p><a href="#" onclick="return toggleContent(this)">

    <img src="{@docRoot}assets/images/triangle-opened.png" class="toggle-content-img"

      alt=""/>M Developer Preview 2</a> <em>(July 2015)</em>

<p>

  If you are currently developing or testing on Android M, you should

  <strong>update your environment</strong> to Developer Preview 2 as soon as

  possible. This ensures that you are building with the latest platform APIs

  and testing against the latest behaviors. If you are just getting started

  with the Android M Developer Preview SDK, follow the instructions in <a href=

  "/preview/setup-sdk.html">Set up the Preview SDK</a>, then update your

  environment for Developer Preview 2.

</p>



  <div class="toggle-content-toggleme">

<h3>

  What's included

</h3>



    <dl>

<p>

  Developer Preview 2 includes an updated SDK with system images,

  documentation, and samples for developing against the latest Android M

  platform.

</p>



    <dt>API Name Changes:</dt>

    <dd>

<ul>

        <li>Moved the {@code android.app.AssistContent} class into the new package,

          {@code android.app.assist} in the Assist API. The full class

          name is now {@code android.app.assist.AssistContent}.</li>

        <li>Moved the {@code android.app.AssistStructure} class to the new package,

          {@code android.app.assist} in the Assist API. The full class name

          is now {@code android.app.assist.AssistStructure}.</li>

        <li>Replaced the {@code ScanResult.PasspointNetwork} property with the

          {@code ScanResult.isPasspointNetwork()} method for HotSpot 2.0 support.</li>

        <li>Replaced the {@code InputDevice.hasMic()} method with {@code InputDevice.hasMicrophone()}

          for the Audio API.</li>

        <li>Renamed the {@code View.OnStylusButtonPressListener} class to

          {@code View.OnContextClickListener} for Bluetooth Stylus support.</li>

        <li>Renamed the {@code GestureDetector.OnStylusButtonPressListener} class to

          {@code GestureDetector.OnContextClickListener} for Bluetooth Stylus support.</li>

        <li>Renamed the {@code android.app.usage.NetworkUsageStats} class to

          {@code android.app.usage.NetworkStats}.</li>

        <li>Renamed the {@code android.app.usage.NetworkUsageStats.Bucket} class to

          {@code android.app.usage.NetworkStats.Bucket}.</li>

  <li>

    <strong>SDK platform</strong> and <strong>system images</strong> (Nexus and

    emulator) for building and testing. You can download the updated tools from

    the SDK Manager, and the system images are available by over-the-air (OTA)

    update or download (see below).

  </li>



  <li>

    <strong>Updated documentation</strong>. The <a href=

    "/preview/behavior-changes.html">Behavior Changes</a>, <a href=

    "/preview/api-overview.html">API Overview</a>, and <a href=

    "/preview/features/runtime-permissions.html">Permissions</a> documents have

    been updated to reflect the latest changes in the platform. An updated

    <a href="/preview/download.html">Developer Documentation download

    package</a> is available, including full reference docs and API diff

    reports.

  </li>



  <li>

    <strong>Translations</strong> of the documentation are now available. Use

    the language selector at the bottom right corner of any page to switch

    languages. Note that some of the translated docs are not yet updated for

    Developer Preview 2 (coming soon).

  </li>



  <li>The <a href="/preview/samples.html">Android M code samples</a> are also

  updated to account for API and behavior changes:

    <ul>

      <li>

        <a href=

        "https://github.com/googlesamples/android-RuntimePermissions">RuntimePermissions</a>

        / <a href=

        "https://github.com/googlesamples/android-RuntimePermissionsBasic">RuntimePermissionsBasic</a>

        are updated to reflect latest permissions API changes, including

        <code>shouldShowRequestPermissionRationale()</code>.

      </li>



      <li>

        <a href=

        "https://github.com/googlesamples/android-FingerprintDialog">FingerprintDialog</a>

        adds a flow to ask for passwords when new fingerprints are added as

        well as a preference if the app will use fingerprints as a method of

        authentication.

      </li>



      <li>The Android Wear samples (<a href=

      "https://github.com/googlesamples/android-AgendaData">AgendaData</a> /

      <a href=

      "https://github.com/googlesamples/android-DataLayer">DataLayer</a> /

      <a href="https://github.com/googlesamples/android-Quiz">Quiz</a> /

      <a href="https://github.com/googlesamples/android-XYZTouristAttractions">

        XYZTouristAttractions</a>) show a simplified usage of Data Items.

      </li>

    </ul>

  </li>

</ul>

    </dd>



    </dl>

  </div>

</div>

<h3 id="changes">

  Key changes

</h3>



<ul>

  <li>Permissions changes

    <ul>

      <li>The <code>android.permission.USE_FINGERPRINT</code> permission now

      has "normal" protection level, so it is no longer necessary to request

      this permission directly from the user. The <code>USE_FINGERPRINT</code>

      permission enables fingerprints to be enabled for authentication, but

      does not give the requesting app access to the enrollment/fingerprint

      administration flow.

      </li>



      <li>The <code>android.permission.WRITE_EXTERNAL_STORAGE</code> permission

      has protection level "dangerous", meaning that apps wanting to write to

      external storage will need to request permission from the user at

      runtime. Both <code>WRITE_EXTERNAL_STORAGE</code> and

      <code>WRITE_EXTERNAL_STORAGE</code> are members of the

      <code>STORAGE</code> permission group.

      </li>



      <li>Remote Bluetooth/Wi-Fi MAC's now require either the

      <code>android.permission.LOCATION_FINE</code> or

      <code>android.permission.LOCATION_COURSE</code> permission.

      </li>



      <li>Some accounts and identity permissions are moved to

      <code>CONTACTS</code> permissions group and others are removed or granted

      based on account type. In particular,

      <code>android.permission.USE_CREDENTIALS</code>,

      <code>android.permission.MANAGE_ACCOUNTS</code>, and

      <code>android.permission.AUTHENTICATE_ACCOUNTS</code> are ungrouped

      pending further changes in a later release.

      </li>



      <li>The Wi-Fi permissions

      <code>android.permission.CHANGE_WIFI_STATE</code>,

      <code>android.permission.CHANGE_WIMAX_STATE</code>, and

      <code>android.permission.CHANGE_WIFI_MULTICAST_STATE</code> now have

      protection level "normal".

      </li>



      <li>The Bluetooth permissions <code>android.permission.BLUETOOTH</code>

      and <code>android.permission.BLUETOOTH_ADMIN</code> now have protection

      level "normal".

      </li>



      <li>Bookmarks and subscribed feeds permissions are removed.

      </li>



      <li>Apps included in the system image are no longer granted dangerous

      permissions automatically. All apps should check for and request

      permissions at runtime.

      </li>



      <li>Introduces the utility method

      <code>Activity.shouldShowRequestPermissionRationale(String)</code>, which

      lets your app see whether users have previously rejected a permission

      request. This lets you know that your app should explain the the user why

      it needs that permission. For more information see the <a href=

      "/preview/features/runtime-permissions.html#explain-need">Permissions</a>

      developer guide.

      </li>

    </ul>

  </li>



<div class="toggle-content closed">

  <p><a href="#" onclick="return toggleContent(this)">

    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"

      alt=""/>M Developer Preview 1</a> <em>(May 2015)</em>

  <li>Other changes

    <ul>

      <li>The <code>android.app.AssistContent</code> and

      <code>android.app.AssistStructure</code> classes are moved into a new

      package, <code>android.app.assist</code>.

      </li>



      <li>Bluetooth Stylus APIs are updated and include new callback events.

      The <code>View.OnStylusButtonPressListener</code> class is renamed to

      <code>View.OnContextClickListener</code> and

      <code>GestureDetector.OnStylusButtonPressListener</code> class to <code>

        GestureDetector.OnContextClickListener</code>.

      </li>

    </ul>

  </li>

</ul>



<p>

  For a complete list of changes, including renamed and removed APIs, please

  refer to the API Diff Reports included in the <a href=

  "/preview/download.html#docs">Developer Documentation download package</a>.

</p>



<h3 id="ki">

  Known issues

</h3>



<ul>

  <li>The system Messenger app crashes on the 64-bit emulator.

  </li>



  <li>After updating to Developer Preview 2, Contacts sync experiences

  intermittent issues. The workaround is to clear and re-sync Contact Storage

  data after update. To clear data, go to <strong>Settings &gt; Apps &gt; Show

  system &gt; Contacts Storage</strong>. Select "Storage" and then

  <strong>Clear data</strong>.

  </li>



  <li>In YouTube app, it's not possible to share a video. The share window is

  blank.

  </li>



  <li>Android For Work Profile setup is not working properly, so you won't be

  able to create a new Work Profile after you update. As a workaround, make

  sure to create the Work Profiles you need in Developer Preview 1 before

  updating to Developer Preview 2.

  </li>

</ul>



<p>

  For a complete list of reported issues, please refer to the <a href=

  "https://code.google.com/p/android/issues/list">open issues list</a> on the

  Developer Preview <a href=

  "https://code.google.com/p/android-developer-preview/">issue tracker</a>.

</p>



<h3 id="preview2-get">

  Get Developer Preview 2

</h3>



<p>

  You can download the Developer Preview 2 platform and emulator images from

  the SDK Manager.

</p>



<p>

  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

  the OTA update within a few days of availability.

</p>



<p>

  If you are just getting started with Android M Developer Preview you want to

  receive Developer Preview 2 by OTA, first download Developer Preview 1 and

  flash it to your device. Leave the device powered on for several hours until

  the device is registered and receives the update.

</p>



  <div class="toggle-content-toggleme">

<p>

  For instructions on how to download and flash your device to the Developer

  Preview, see the links and instructions on the <a href=

  "/preview/download.html">Downloads</a> page.

</p>



    <dl>

    <dt>Initial release.</dt>

    </dl>

<p>

  For instructions on how to start developing and testing with Android M, read

  <a href="/preview/setup-sdk.html">Setting up the SDK</a>

</p>



<h2 id="preview1-notes">

  Developer Preview 1

</h2>



<div class="wrap">

  <div class="cols">

    <div class="col-5of12">

      <p>

        <em>Date: May 2015<br>

        Build: MPZ44Q<br>

        Hardware support: Nexus 5,6,9, Player<br>

        Emulator support: x86 & ARM (32/64-bit)<br>

        Google Play services: 7.5</em>

      </p>

    </div>

  </div>

</div>



<p>

  Initial release.

</p>