page.title=Support and Release Notes
meta.keywords="preview", "wear"
page.tags="preview", "developer preview"
@jd:body
<p>
If you experience problems when developing and testing with the
Wear 2.0 Developer Preview, please file bugs at
<a href="https://g.co/wearpreviewbug">https://g.co/wearpreviewbug</a>.
</p>
<p>
To discuss issues or ideas with other developers working with Android Wear,
join the <a href="https://plus.google.com/communities/113381227473021565406">
Wear Developer Google+ community</a>.
</p>
<div id="qv-wrapper">
<div id="qv">
<h2>In this document</h2>
<ul>
<li><a href="#general">General Advisories</a></li>
<li><a href="#platform-version">Platform API Version</a></li>
<li><a href="#deprecations">Deprecations</a></li>
<li><a href="#dp3">Developer Preview 3</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="platform-version">
Platform API Version
</h2>
<p>
The Android Platform API version is incremented to 24 to match Android 7.0.
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>
<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="dp3">Developer Preview 3</h2>
<div class="wrap">
<div class="cols">
<div class="col-6of12">
<p><em>Date: September 2016<br />
Builds: Wearable Support 2.0.0-alpha3, NVE68J<br/>
Emulator support: x86 & ARM (32-bit)<br/>
</em></p>
</div>
</div>
</div>
<h3 id="new-in-fdp3">
New in Preview 3
</h3>
<p>
For access to system images and the companion app for Preview 3, see
<a href="https://developer.android.com/wear/preview/downloads.html">
Download and Test with a Device</a>.
</p>
<h4>
Additions for standalone apps and the Play Store on Wear
</h4>
<p>
For information about planning your Wear 2.0 app, see <a href=
"https://developer.android.com/wear/preview/features/standalone-apps.html">
Standalone Apps</a>.
</p>
<p>
Generally, the minimum and target SDK level for Wear 2.0, and for a
standalone APK, is level 24. The minimum SDK level can be 23
only if you are using the same APK
for Wear 1.0 and 2.0 (and thus have an embedded Wear 1.0 APK).
</p>
<p>
Run-time permissions are required.
</p>
<p>
For information about distributing your Wear 2.0 app, see <a href=
"https://developer.android.com/wear/preview/features/app-distribution.html">
App Distribution</a>.
</p>
<h4 id="additions-to-the-complications-api">
Complications API additions
</h4>
<p>
For Preview 3, additions and changes have been made to the Complications
API. The <a href=
"https://developer.android.com/wear/preview/features/complications.html">documentation</a>
includes information about the following additions and changes:
</p>
<ul>
<li>To receive complication data and open the provider chooser, a watch
face must have the <code>RECEIVE_COMPLICATION_DATA</code> permission.
</li>
<li>To ease a request for the new permission and the starting of the
chooser, the <code>ComplicationHelperActivity</code> class is available
in the wearable support library. This class should be used instead of
<code>ProviderChooserIntent</code> to start the chooser in almost all
cases.
</li>
<li>Watch faces can specify default providers that are used until a user
selects a provider.
</li>
<li>The complication types used for "empty" data are changed.
</li>
<li>A new permission was added to ensure that only the Android Wear
system can bind to provider services.
</li>
</ul>
<p>
For changes related to the <code>ComplicationData</code> object, see
<a href=
"https://developer.android.com/wear/preview/behavior-changes.html">Behavior
Changes</a>.
</p>
<h4 id="wearable-recycler-view-api">
Curved Layout
</h4>
<p>
For information about creating a curved layout using
the <code>WearableRecyclerView</code> API in your Wear 2.0 app, see
<a href="https://developer.android.com/wear/preview/features/wearable-recycler-view.html">
Curved Layout</a>.
</p>
<h4 id="notifications-features-fdp3">
Notifications features
</h4>
<p>
To learn about adding an inline action to a notification,
see <a href="https://developer.android.com/wear/preview/notifications.html#inline">Inline
Action</a>.
</p>
<p>
To learn about adding images to a notification, see
<a href=
"https://developer.android.com/wear/preview/notifications.html#images">Adding
images to a notification</a>.
</p>
<p>
For additions related to the bridging of notifications from a companion
app to a watch, see <a href=
"https://developer.android.com/wear/preview/features/bridger.html">Bridging
Mode for Notifications</a>.
</p>
<h4 id="additions-for-smart-reply">
Smart Reply additions
</h4>
<p>
Smart Reply responses are generated by an entirely on-watch,
machine-learning model using the context provided by <a href=
"https://developer.android.com/wear/preview/features/notifications.html#messaging">
MessagingStyle</a> notifications. Use the <a href=
"https://developer.android.com/reference/android/support/v4/app/NotificationCompat.Action.Builder.html#setAllowGeneratedReplies(boolean)">
setAllowGeneratedReplies(boolean)</a> method to enable Smart Reply for
your <code>MessagingStyle</code> notification.
</p>
<h3 id="known-issues-3">
Known Issues
</h3>
<h4 id="notifications">
Notifications
</h4>
<ul>
<li>The <code>MessagingStyle</code> <a href=
"https://developer.android.com/wear/preview/features/notifications.html#images">
notifications with images</a> posted by standalone apps don't show
images in the notification (i.e., bridged notifications show images,
but standalone notifications don't).
</li>
<li>This preview release does not include support for notification
groups.
</li>
<li>With Wear 2.0, a watch can receive notifications directly from
Firebase Cloud Messaging (FCM), which replaces Google Cloud Messaging
(GCM). However, in Preview 3 of Wear 2.0, FCM does not function with
iOS-paired watches.
</li>
<li>Smart Reply responses are only shown in <code>RemoteInput</code> when
<code>RemoteInput</code> is called from a <code>MessagingStyle</code>
expanded notification. Smart Reply responses are not shown in
<code>RemoteInput</code> when <code>RemoteInput</code> is called from an
<a href=
"https://developer.android.com/wear/preview/features/notifications.html#inline">
inline action</a> within the stream—an action set with the <a href=
"https://developer.android.com/reference/android/support/v4/app/NotificationCompat.Action.WearableExtender.html#setHintDisplayActionInline(boolean)">
setHintDisplayActionInline(true)</a> method.
</li>
</ul>
<h4 id="companion-app">
Companion app
</h4>
<ul>
<li>The preview companion app is not compatible with Android 4.3
(Jelly Bean MR2), which has an SDK build version code of:
<code>JELLY_BEAN_MR2</code></li>
</ul>
<ul>
<li>In permission screens in the preview companion app:
If you deny a permission, you cannot
proceed. Instead of denying a permission, tap <strong>Skip</strong>.
</li>
</ul>
<h4 id="developer-console">
Developer Console
</h4>
<ul>
<li>If you set a minimum SDK version of 24, the Play Developer Console
states that there are few supported devices.
</li>
</ul>
<h4 id="system-user-interface">
System user interface and apps
</h4>
<ul>
<li>Dismissing multiple notifications can cause an app to forcibly close.
</li>
<li>The "Ok Google" detection and voice transcription may not work
reliably.
</li>
<li>Google Fit is not available with Preview 3.
</li>
<li>Syncing for embedded apps is not enabled for the preview. Therefore,
to test an app on a device, add it to the Play Store or side-load it
onto a watch. Some existing Wear apps, e.g. Google Maps, are only
using the embedded apps mechanism currently, and are therefore not
installable on the preview (and therefore do not appear on the watch).
</li>
<li>In Play Store search results on the watch,
results other than apps sometimes appear.
</li>
<li>Media controls/notifications are not bridged
to the watch from an Android KitKat phone.
</li>
</ul>
<h4 id="account">
Account sync
</h4>
<ul>
<li>Account sync initiated from watch settings may not work reliably.
Instead, add accounts from the setup flow of the Android Wear app, or using
the Accounts settings for a device from the Android Wear app.
</li>
<li>The list of accounts that can be synced is the same as the list of accounts
on the phone. So to add a new account, use the Android settings on the phone,
and then proceed to Android Wear app to sync that account.
</li>
</ul>
<h4 id="devices">
Devices
</h4>
<ul>
<li>In Android Wear emulators, the Play Store app requires that an
account is synced to the device before the app can be opened.
</li>
<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>
</ul>
<h4 id="smart-reply">
Smart Reply
</h4>
<ul>
<li>Smart Reply is only available if your watch's system language is
English.
</li>
<li>Smart Reply responses are not generated for all messages.
</li>
</ul>
<h2 id="dp2">Developer Preview 2</h2>
<div class="wrap">
<div class="cols">
<div class="col-6of12">
<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">
New in Preview 2
</h3>
<h4 id="wearable-drawers">
Wearable drawers
</h4>
<p>
The following are feature additions for <a href=
"{@docRoot}wear/preview/features/ui-nav-actions.html">
wearable drawers</a>:
</p>
<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>
<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>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>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>
<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>
<h3 id="known-issues-2">
Known Issues
</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>
<li>After music is played on a companion phone,
music card notifications are not mirrored to the watch.
</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,
but will be supported in a future release.
</li>
<li>Tapping on next and previous controls in a notification while playing
music does not work.
</li>
<li>Bottom drawer actions user interface overlaps with media card
notifications.
</li>
<li>The system does not generate Smart Reply responses even if
<code>setAllowGeneratedReplies(true)</code> is set.
</li>
</ul>
<h4 id="complications">Complications</h4>
<ul>
<li>Battery information is not synchronized between the
watch face and the drop-down Quick menu.
</li>
<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>
<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 force close.
</li>
<li>Turning screen lock to off (Enable and disable) functionality is not
reliable.
</li>
<li>Airplane mode does not work from quick settings.
</li>
<li>Tapping Google keyboard English (United States) displays a <em>Settings
under construction</em> 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 Wifi on wearable.
</li>
<li>Voice transcription may not work reliably at this time.
</li>
</ul>
<h4 id="companion_app">Companion App</h4>
<ul>
<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 2nd Edition, when
answering a call from the watch, the watch
does not provide audio from the caller.
</li>
</ul>