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

Commit bd382d76 authored by Bert McMeen's avatar Bert McMeen Committed by android-build-merger
Browse files

Merge \\\\"Docs: Release Notes for Dev Preview 2\\\\" into mnc-io-docs am:...

Merge \\\\"Docs: Release Notes for Dev Preview 2\\\\" into mnc-io-docs am: b039c753 am: 40df51ce am: 3ed7666f
am: 421f4d21

Change-Id: I5d6ad073619666748982961643501e378dee4e17
parents abc031af 421f4d21
Loading
Loading
Loading
Loading
+255 −29
Original line number Diff line number Diff line
@@ -16,48 +16,277 @@ page.tags="preview", "developer preview"
  Wear Developer Google+ community</a>.
</p>

<h2 id="dp">Developer Preview 1</h2>
<div id="qv-wrapper">
<div id="qv">

<h2>In this document</h2>

<ul>
  <li><a href="#general">General Advisories</a></li>
  <li><a href="#deprecations">Deprecations</a></li>
  <li><a href="#dp2">Developer Preview 2</a></li>
  <li><a href="#dp1">Developer Preview 1</a></li>
</ul>

</div>
</div>

<h2 id="general">General Advisories</h2>

<p>
  The developer preview is for <strong>app developers and other early
  adopters</strong> and is available for daily use, development, or
  compatibility testing. Please be aware of these general notes about the
  release:
</p>

<ul>
  <li>The developer preview may have various <strong>stability issues</strong> on
    supported devices. Users may encounter system instability, such as kernel
    panics and crashes.
  </li>
  <li>Some apps <strong>may not function as expected</strong> on the new
  platform version. This includes Google’s apps and other apps.
  </li>
</ul>

<h2 id="deprecations">Deprecations</h2>

<p>The following fields are deprecated in the preview:</p>

<ul>
  <li>The <code>Notification.WearableExtender#setCustomSizePreset(int)</code>
  method no longer accepts <code>SIZE_FULL_SCREEN</code> and this value is now
  undefined.
  </li>
  <li>The <code>Notification.WearableExtender#setContentIcon(int)</code> method
  is deprecated.
  </li>
</ul>

<h2 id="dp2">Developer Preview 2</h2>

<div class="wrap">
  <div class="cols">
    <div class="col-6of12">
      <p><em>Date: May 2016<br />
      Builds: Wearable Support 2.0.0-alpha1, NVD36I <br />
      <p><em>Date: July 2016<br />
      Builds: Wearable Support 2.0.0-alpha2, NVD83H<br/>
      Emulator support: x86 & ARM (32-bit)<br/>
      </em></p>
    </div>
  </div>
</div>

<h3 id="new-in-fdp2">
  <strong>New in Preview 2</strong>
</h3>

<h4 id="platform-version-24">
  Platform API Version
</h4>

<p>
  The Android Platform API version is incremented to 24 to match Android Nougat.
  You can update the following in your Android Wear 2.0 Preview project
  to <strong>24</strong>:
</p>

<ul>
  <li><code>compileSdkVersion</code></li>
  <li><code>targetSdkVersion</code></li>
</ul>

<h3 id="general_advisories">General advisories</h3>
<h4 id="wearable-drawers">
  Wearable drawers
</h4>

<p>
  This Developer Preview release is for app developers only and is designed for
  use in compatibility testing and early development only.
  The following are feature additions for <a href=
  "{@docRoot}wear/preview/features/ui-nav-actions.html">
  wearable drawers</a>:
</p>

<h4 id="deprecations">Deprecations</h4>
<ul>
  <li>Drawer peeking is now supported in the <code>onCreate()</code> method
  of your app's activity.
  </li>

  <li>The automatic drawer peeking behavior is
  inverted. Now the bottom drawer peeks when the user scrolls down the view
  and top drawer peeks when the user scrolls to the top of the view
  (previously scrolling down did not show peek view).
  </li>

<p>The following fields are deprecated in the Preview:</p>
  <li>Two new attributes, <code>peek_view</code> and
  <code>drawer_content</code>, are added to
  <code>WearableDrawerView</code> to specify contents of custom drawers and
  peek view in your XML layout (previously, custom drawer contents were
  specified only through Java code).
  </li>

  <li>The Navigation drawer now displays page indicator dots.
  </li>

  <li>Peek views now close automatically after one second.
  </li>

  <li>The <code>WearableNavigationDrawer</code> now automatically closes
  after five seconds or when an item is tapped.
  </li>

  <li>There is improved drawer handling (size and margins) for devices with chins:
    <ul>
  <li>The <code>Notification.WearableExtender#setCustomSizePreset(int)</code>
  method no longer accepts <code>SIZE_FULL_SCREEN</code> and this value is now
  undefined.
      <li>Size: The bottom drawer is slightly smaller when there is a
      chin.
      </li>
      <li>Margins: <code>WearableDrawerLayout</code> sets its bottom margin
      size equal to the size of the chin, so that the bottom drawer is
      fully visible.
      </li>
    </ul>
  <li>The navigation drawer contents are now updated when
        <code><a href="{@docRoot}reference/android/widget/ArrayAdapter.html#notifyDataSetChanged()">
        notifyDataSetChanged</a></code> is called on the adapter.
  </li>

  <li>The <code>Notification.WearableExtender#setContentIcon(int)</code> method
  is deprecated.
    <li>In your <code>WearableActionDrawer</code>, when there is only one
      action, its icon is shown in the peek view and the action is executed
      when the peek view is tapped.
    </li>

    <li>When the peek view of your <code>WearableActionDrawer</code> has
      more than one action, both the first action and the overflow icons are
      shown.
    </li>
</ul>

<h3 id="known_issues">Known Issues</h3>
<h4 id="gestures">
  Wrist gestures
</h4>

<p>
  Wrist gestures can enable quick, one-handed interactions with your app.
  For example, a user can
  scroll through notifications with one hand while holding a cup of water
  with the other. For more information, see <a href=
  "{@docRoot}wear/preview/features/gestures.html">
  Wrist Gestures</a>.
</p>

<h4 id="notifications">Notifications</h4>
<h3 id="known-issues-2">
  <strong>Known Issues</strong>
</h3>

<h4 id="notifications-2">
  Notifications
</h4>

<ul>
  <li>This preview release does not include support for notification
  groups.
  </li>

  <li>The user interface for the action drawer can sometimes have a
  transparent background.
  </li>

  <li>The system does not generate Smart Reply responses even if
  <code>setAllowGeneratedReplies(true)</code> is set.
  </li>
</ul>

<h4 id="complications-2">
  Complications
</h4>

<ul>
  <li>When tapping on the music complication on a watch face, Play Music
  crashes if the Apps launcher provider is used.
  </li>
</ul>

<h4 id="system-user-interface-2">
  System User Interface
</h4>

<ul>
  <li>Pressing the hardware button in ambient mode triggers active mode
  with the app launcher instead of active mode only.
  </li>

  <li>Double pressing the power hardware button while on the launcher
  causes the watch screen to turn black.
  </li>

  <li>Dismissing multiple notifications can cause app to forcibly close.
  </li>

  <li>Turning screen lock to off (Enable and disable) functionality is not
  reliable.
  </li>

  <li>The "Ok Google" detection and voice transcription may not work
  reliably. Additionally, Search does not retrieve results.
  </li>

  <li>Tapping Google keyboard English (United States) displays a "Settings
  under construction" message.
  </li>

  <li>First calendar event notification must be dismissed in order to show
  the rest of the event card.
  </li>

  <li>Unable to turn off the Wi-Fi on a wearable.
  </li>
</ul>

<h4 id="companion-app-2">
  Companion App
</h4>

<ul>
  <li>An actions card is shown in the Android Wear companion app, even
  though there are no actions.
  </li>
</ul>

<h4 id="devices-2">
  Devices
</h4>

<ul>
  <li>On the Huawei Watch, selecting the language, followed by multiple
  acknowledgement dialogues results in a black screen.
  </li>

  <li>On the LG Watch Urbane 2nd Edition, when answering a call from the watch, the
  watch does not provide audio from the caller.
  </li>

  <li>On the LG Watch Urbane 2nd Edition,
  please do the following to prevent battery drain:
  Turn on Airplane mode (to disable the cellular radio) and then
  turn on Bluetooth.
  </li>
</ul>

<h2 id="dp1">Developer Preview 1</h2>

<div class="wrap">
  <div class="cols">
    <div class="col-6of12">
      <p><em>Date: May 2016<br />
      Builds: Wearable Support 2.0.0-alpha1, NVD36I <br />
      Emulator support: x86 & ARM (32-bit)<br/>
      </em></p>
    </div>
  </div>
</div>

<h3 id="known_issues">Known Issues</h3>

<h4 id="notifications">Notifications</h4>

<ul>
  <li>This preview release does not include support for notification groups,
@@ -74,18 +303,17 @@ page.tags="preview", "developer preview"
  </li>
</ul>


<h4 id="complications">Complications</h4>

<ul>
  <li>Battery information is not synchronized between watch face and drop down
  quick menu.
  <li>Battery information is not synchronized between the
  watch face and the drop-down Quick menu.
  </li>
  <li>Play music crashes when tapping on music complication in watch face.
  <li>When tapping on the music complication on a watch face, Play Music
      crashes if the Apps launcher provider is used.
  </li>
</ul>


<h4 id="system_user_interface">System User Interface</h4>

<ul>
@@ -114,26 +342,24 @@ page.tags="preview", "developer preview"
  </li>
</ul>


<h4 id="companion_app">Companion App</h4>

<ul>
  <li>'More actions' via Companion app shows a blank screen on phone running
  nyc-release and watch running feldspar-release.
  </li>
  <li>Select watch face on companion wear app will not change watch face on
  wearable.
   <li>Selecting a watch face on the companion app will not change the watch face on
   wearable.</li>
   <li>An actions card is shown in the Android Wear companion app, even
   though there are no actions.
   </li>
</ul>


<h4 id="devices">Devices</h4>

<ul>
  <li>On the Huawei Watch, selecting the language, followed by multiple
  acknowledgement dialogues results in a black screen.
  </li>
  <li>On the LG Watch Urbane LTE, when answering call from the watch, the watch
  <li>On the LG Watch Urbane 2nd Edition, when
  answering a call from the watch, the watch
  does not provide audio from the caller.
  </li>
</ul>