diff options
author | Luan Nguyen <luann@google.com> | 2015-06-17 15:14:27 +0000 |
---|---|---|
committer | Android Git Automerger <android-git-automerger@android.com> | 2015-06-17 15:14:27 +0000 |
commit | 1824ea1b1c60f27cbc49ed086cd6198641f6c74f (patch) | |
tree | 50fddb0334d78af7e3a531c447ecf2f2647dcc1a /docs | |
parent | 871c5cb52ddefa15296e4e59c592bef0abf297f9 (diff) | |
parent | ce26f2911361fe1da9d3f350e2785657d6d5e685 (diff) | |
download | frameworks_base-1824ea1b1c60f27cbc49ed086cd6198641f6c74f.zip frameworks_base-1824ea1b1c60f27cbc49ed086cd6198641f6c74f.tar.gz frameworks_base-1824ea1b1c60f27cbc49ed086cd6198641f6c74f.tar.bz2 |
am ce26f291: am 5980ae8f: Merge "docs: Update JavaDoc reference links for Create Wearable Apps class" into mnc-preview-docs
* commit 'ce26f2911361fe1da9d3f350e2785657d6d5e685':
docs: Update JavaDoc reference links for Create Wearable Apps class
Diffstat (limited to 'docs')
-rw-r--r-- | docs/html/training/wearables/apps/creating.jd | 56 | ||||
-rw-r--r-- | docs/html/training/wearables/apps/layouts.jd | 117 |
2 files changed, 117 insertions, 56 deletions
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 @@ helpoutsWidget=true <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 @@ types of screen shapes, which is useful for testing.</p> <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 @@ Project</a>. As you follow the wizard, enter the following information:</p> <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 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>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 + <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 @@ Project</a>. As you follow the wizard, enter the following information:</p> 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 @@ wearable and prints out "Hello world!" <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 @@ helpoutsWidget=true <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 @@ public void onCreate(Bundle bundle){ 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 @@ dependencies { <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> |