am 1824ea1b: am ce26f291: am 5980ae8f: Merge "docs: Update JavaDoc reference links for Create Wearable Apps class" into mnc-preview-docs
* commit '1824ea1b1c60f27cbc49ed086cd6198641f6c74f':
docs: Update JavaDoc reference links for Create Wearable Apps class
diff --git a/docs/html/training/wearables/apps/creating.jd b/docs/html/training/wearables/apps/creating.jd
index a8b5ec6..f1491e4 100644
--- a/docs/html/training/wearables/apps/creating.jd
+++ b/docs/html/training/wearables/apps/creating.jd
@@ -9,9 +9,9 @@
<h2>This lesson teaches you to</h2>
<ol>
<li><a href="#UpdateSDK">Update Your SDK</a></li>
- <li><a href="#SetupEmulator">Set Up an Android Wear Emulator</a></li>
- <li><a href="#SetupDevice">Set Up an Android Wear Device</a></li>
+ <li><a href="#SetupEmulator">Set Up an Android Wear Emulator or Device</a></li>
<li><a href="#CreateProject">Create a Project</a></li>
+ <li><a href="#Install">Install the Wearable App</a></li>
<li><a href="#Libraries">Include the Correct Libraries</a></li>
</ol>
</div>
@@ -112,18 +112,20 @@
<li>Tap <strong>ADB Debugging</strong> to enable adb.</li>
</ol>
<li>Connect the wearable to your machine through USB, so you can install apps directly to it
- as you develop. A message appears on both the wearable and the Android Wear app prompting you to allow debugging.</li>
- <p class="note"><strong>Note:</strong> If you can not connect your wearable to your machine via USB,
- follow the directions on
- <a href="{@docRoot}training/wearables/apps/bt-debugging.html">Debugging over
- Bluetooth</a>.
+ as you develop. A message appears on both the wearable and the Android Wear app prompting you to
+ allow debugging.</li>
+
+ <p class="note"><strong>Note:</strong> If you can not connect your wearable
+ to your machine via USB, you can try
+ <a href="{@docRoot}training/wearables/apps/bt-debugging.html">connecting over Bluetooth</a>.
</p>
+
<li>On the Android Wear app, check <strong>Always allow from this computer</strong> and tap
<strong>OK</strong>.</li>
</ol>
-<p>The <strong>Android</strong> tool window on Android Studio shows the system log from the wearable.
-The wearable should also be listed when you run the <code>adb devices</code> command.</p>
+<p>The <i>Android</i> tool window on Android Studio shows the system log from the
+wearable. The wearable should also be listed when you run the <code>adb devices</code> command.</p>
<h2 id="CreateProject">Create a Project</h2>
@@ -147,18 +149,23 @@
<li>In the first <b>Add an Activity</b> window, add a blank activity for mobile.</li>
<li>In the second <b>Add an Activity</b> window, add a blank activity for Wear.</li>
</ol>
- <p>When the wizard completes, Android Studio creates a new project with two modules, <b>mobile</b> and
- <b>wear</b>. You now have a project for both your handheld and wearable apps that you can create activities,
- services, custom layouts, and much more in. On the handheld app, you do most of the heavy lifting,
- such as network communications, intensive processing, or tasks that require long
- amounts of user interaction. When these are done,
- you usually notify the wearable of the results through notifications or by syncing and sending
- data to the wearable.</p>
+ <p>When the wizard completes, Android Studio creates a new project with two modules, <b>mobile</b>
+ and <b>wear</b>. You now have a project for both your handheld and wearable apps for which you can
+ create activities, services, and custom layouts. The handheld app does most of
+ the heavy lifting, such as network communications, intensive processing, or tasks that require
+ long amounts of user interaction. When the app completes these operations, your app should
+ notify the wearable of the results through notifications or by syncing and sending data to
+ the wearable.</p>
- <p class="note"><b>Note:</b> The <b>wear</b> module also contains a "Hello World" activity that uses a
- <code>WatchViewStub</code> that inflates a layout based on whether the device's screen
- is round or square. The <code>WatchViewStub</code> class is one of the UI widgets that's provided
- by the <a href="{@docRoot}training/wearables/apps/layouts.html#UiLibrary">wearable support library</a>.</p>
+ <p class="note"><b>Note:</b> The <b>wear</b> module also contains a "Hello World" activity that
+ uses a
+ <a href="{@docRoot}reference/android/support/wearable/view/WatchViewStub.html"><code>WatchViewStub</code></a>.
+ This class inflates a layout based on whether the device's screen is round or square. The
+ <a href="{@docRoot}reference/android/support/wearable/view/WatchViewStub.html"><code>WatchViewStub</code></a>
+ class is one of the UI widgets that the
+ <a href="{@docRoot}training/wearables/apps/layouts.html#UiLibrary">wearable support library</a>
+ provides.
+ </p>
</li>
<h2 id="Install">Install the Wearable App</h2>
@@ -167,8 +174,8 @@
either <code>adb install</code> or the <b>Play</b> button on Android Studio.</p>
<p>When you're ready to publish your app to users, you embed the wearable app inside of the
-handheld app. When users install the handheld app from Google Play, a connected wearable automatically
-receives the wearable app.</p>
+handheld app. When a user installs the handheld app from Google Play, a connected wearable
+automatically receives the wearable app.</p>
<p class="note"><b>Note:</b> The automatic installation of wearable apps
does not work when you are signing apps with a debug key and only works with release keys. See
@@ -184,7 +191,8 @@
<p>As part of the Project Wizard, the correct
dependencies are imported for you in the appropriate module's <code>build.gradle</code> file.
-However, these dependencies are not required, so read the following descriptions to find out if you need them or not:</p>
+However, these dependencies are not required, so read the following descriptions to find out if you
+need them or not:</p>
<b>Notifications</b>
<p>The <a href="{@docRoot}tools/support-library/features.html#v4">Android
diff --git a/docs/html/training/wearables/apps/layouts.jd b/docs/html/training/wearables/apps/layouts.jd
index 1d0e49b..197b94b0c 100644
--- a/docs/html/training/wearables/apps/layouts.jd
+++ b/docs/html/training/wearables/apps/layouts.jd
@@ -10,7 +10,7 @@
<h2>This lesson teaches you to</h2>
<ol>
<li><a href="#CustomNotifications">Create custom notifications</a></li>
- <li><a href="#UiLibrary">Create Layouts with the Wearable UI Library</li>
+ <li><a href="#UiLibrary">Create Layouts with the Wearable UI Library</a></li>
</ol>
<h2>You should also read</h2>
@@ -73,8 +73,8 @@
For example:
<pre>
Intent notificationIntent = new Intent(this, NotificationActivity.class);
-PendingIntent notificationPendingIntent = PendingIntent.getActivity(this, 0, notificationIntent,
- PendingIntent.FLAG_UPDATE_CURRENT);
+PendingIntent notificationPendingIntent = PendingIntent.getActivity(
+ this, 0, notificationIntent, PendingIntent.FLAG_UPDATE_CURRENT);
</pre>
</li>
<li>Build a {@link android.app.Notification} and call
@@ -110,35 +110,88 @@
<p>Here are some of the major classes in the Wearable UI Library:</p>
-<ul>
- <li><code>BoxInsetLayout</code> - A FrameLayout that's aware of screen shape and can box its
- children in the center square of a round screen.</li>
- <li><code>CardFragment</code> - A fragment that presents content within an expandable,
- vertically scrollable card.</li>
- <li><code>CircledImageView</code> - An image view surrounded by a circle.</li>
- <li><code>ConfirmationActivity</code> - An activity that displays confirmation animations after the user
- completes an action.</li>
- <li><code>CrossFadeDrawable</code> - A drawable that contains two child drawables and provides
- methods to directly adjust the blend between the two.</li>
- <li><code>DelayedConfirmationView</code> - A view that provides a circular countdown timer,
- typically used to automatically confirm an operation after a short delay has elapsed.</li>
- <li><code>DismissOverlayView</code> - A view for implementing long-press-to-dismiss.</li>
- <li><code>DotsPageIndicator</code> - A page indicator for GridViewPager that identifies the
- current page in relation to all available pages on the current row.</li>
- <li><code>GridViewPager</code> - A layout manager that allows the user to both vertically and
- horizontally through pages of data. You supply an implementation of a GridPagerAdapter to
- generate the pages that the view shows.</li>
- <li><code>GridPagerAdapter</code> - An adapter that supplies pages to a GridViewPager.</li>
- <li><code>FragmentGridPagerAdapter</code> - An implementation of GridPagerAdapter that
- represents each page as a fragment.</li>
- </li>
- <li><code>WatchViewStub</code> - A class that can inflate a specific layout,
- depending on the shape of the device's screen.</li>
- <li><code>WearableListView</code> - An alternative version of ListView that is optimized for
- ease of use on small screen wearable devices. It displays a vertically scrollable list of items,
- and automatically snaps to the nearest item when the user stops scrolling.
- </li>
-</ul>
+<dl>
+ <dt><a href="{@docRoot}reference/android/support/wearable/view/BoxInsetLayout.html"><code>BoxInsetLayout</code></a>
+ </dt>
+ <dd>A {@link android.widget.FrameLayout} object
+ that's aware of screen shape and can box its children in the center square of a round screen.
+ </dd>
+
+ <dt><a href="{@docRoot}reference/android/support/wearable/view/CardFragment.html"><code>CardFragment</code></a>
+ </dt>
+ <dd>A fragment that presents content within an expandable, vertically scrollable card.
+ </dd>
+
+ <dt><a href="{@docRoot}reference/android/support/wearable/view/CircledImageView.html"><code>CircledImageView</code></a>
+ </dt>
+ <dd>An image view surrounded by a circle.
+ </dd>
+
+ <dt><a href="{@docRoot}reference/android/support/wearable/activity/ConfirmationActivity.html"><code>ConfirmationActivity</code></a>
+ </dt>
+ <dd>An activity that displays confirmation animations after the user completes an action.
+ </dd>
+
+ <dt><a href="{@docRoot}reference/android/support/wearable/view/CrossfadeDrawable.html"><code>CrossFadeDrawable</code></a>
+ </dt>
+ <dd>A drawable that contains two child drawables and provides methods to directly adjust the blend
+ between the two.
+ </dd>
+
+ <dt><a href="{@docRoot}reference/android/support/wearable/view/DelayedConfirmationView.html"><code>DelayedConfirmationView</code></a>
+ </dt>
+ <dd>A view that provides a circular countdown timer, typically used to automatically confirm an
+ operation after a short delay has elapsed.
+ </dd>
+
+ <dt><a href="{@docRoot}reference/android/support/wearable/view/DismissOverlayView.html"><code>DismissOverlayView</code></a>
+ </dt>
+ <dd>A view for implementing long-press-to-dismiss.
+ </dd>
+
+ <dt><a href="{@docRoot}reference/android/support/wearable/view/GridViewPager.html"><code>GridViewPager</code></a>
+ </dt>
+ <dd>A layout manager that allows the user to navigate both vertically and
+ horizontally through pages of data. You supply an implementation of a
+ <a href="{@docRoot}reference/android/support/wearable/view/GridPagerAdapter.html"><code>GridPagerAdapter</code></a>
+ instance to generate the pages that the view shows.
+ </dd>
+
+ <dt><a href="{@docRoot}reference/android/support/wearable/view/GridPagerAdapter.html"><code>GridPagerAdapter</code></a>
+ </dt>
+ <dd>An adapter that supplies pages to a
+ <a href="{@docRoot}reference/android/support/wearable/view/GridViewPager.html"><code>GridViewPager</code></a>
+ object.
+ </dd>
+
+ <dt><a href="{@docRoot}reference/android/support/wearable/view/FragmentGridPagerAdapter.html"><code>FragmentGridPagerAdapter</code></a>
+ </dt>
+ <dd>An implementation of a
+ <a href="{@docRoot}reference/android/support/wearable/view/GridPagerAdapter.html"><code>GridPagerAdapter</code></a>
+ instance that represents each page as a fragment.
+ </dd>
+
+ <dt><a href="{@docRoot}reference/android/support/wearable/view/DotsPageIndicator.html"><code>DotsPageIndicator</code></a>
+ </dt>
+ <dd>A page indicator for a
+ <a href="{@docRoot}reference/android/support/wearable/view/GridViewPager.html"><code>GridViewPager</code></a>
+ implementation that identifies the current page in relation to all available pages on the current
+ row.
+ </dd>
+
+ <dt><a href="{@docRoot}reference/android/support/wearable/view/WatchViewStub.html"><code>WatchViewStub</code></a>
+ </dt>
+ <dd>A class that can inflate a specific layout, depending on the shape of the device's screen.
+ </dd>
+
+ <dt><a href="{@docRoot}reference/android/support/wearable/view/WearableListView.html"><code>WearableListView</code></a>
+ </dt>
+ <dd>An alternative version of a {@link android.widget.ListView}
+ object that is optimized for ease of use on small screen wearable devices. It displays a
+ vertically scrollable list of items, and automatically snaps to the nearest item when the user
+ stops scrolling.
+ </dd>
+</dl>
<h3 id="UiLibReference">Wear UI library API reference</h3>