Merge "Delete outdated sitemap file. Updated version now in Piper: https://critique.corp.google.com/#review/122362396" into mnc-mr-docs
am: b7f5631156
* commit 'b7f5631156158c83d1eaa2e323267435edb66bf3':
Delete outdated sitemap file. Updated version now in Piper: https://critique.corp.google.com/#review/122362396
Change-Id: I5314afc6a3a42f43bb2f0a1484712b170773db63
diff --git a/docs/html/_redirects.yaml b/docs/html/_redirects.yaml
index 6a68057..69e598a 100644
--- a/docs/html/_redirects.yaml
+++ b/docs/html/_redirects.yaml
@@ -1132,12 +1132,6 @@
- from: /tools/revisions/index.html
to: /studio/releases/index.html
-# Wear Preview related (remove in mnc-io-docs)
-- from: /wear/preview/start.html
- to: /training/building-wearables.html
-- from: /wear/preview/index.html
- to: /patience.html
-
# Just incase something was missed, go to intro page
- from: /tools/...
to: /studio/intro/index.html
diff --git a/docs/html/google/play/billing/billing_admin.jd b/docs/html/google/play/billing/billing_admin.jd
index ff7acc9..2203f71 100644
--- a/docs/html/google/play/billing/billing_admin.jd
+++ b/docs/html/google/play/billing/billing_admin.jd
@@ -8,10 +8,11 @@
<h2>In this document</h2>
<ol>
<li><a href="#billing-list-setup">Creating a Product List</a></li>
+ <li><a href="#pricing-template">Pricing Templates</a></li>
<li><a href="#billing-purchase-type">Choosing a Product Type</a></li>
- <li><a href="#billing-testing-setup">Setting up Test Accounts</a></li>
<li><a href="#billing-refunds">Handling Refunds</a></li>
<li><a href="#billing-refunds">Working with Order Numbers</a></li>
+ <li><a href="#billing-testing-setup">Setting up Test Accounts</a></li>
<li><a href="#billing-support">Where to Get Support</a></li>
</ol>
@@ -44,7 +45,19 @@
<p>The Google Play Developer Console provides a product list for each of your published
applications. You can sell an item using Google Play's in-app billing feature only if the item is
listed on an application's product list. Each application has its own product list; you cannot sell
-items that are listed in another application's product list.</p>
+items that appear on another application's product list.</p>
+
+<div class="figure-right">
+ <figure id="fig-iap">
+ <img src="{@docRoot}images/in-app-billing/in_app_products.png" width="700"
+ alt="The Mythical Journey app lists two in-app products, Invisibility Potion and Sleeping Potion.">
+ <figcaption>
+ <b>Figure 1. </b>You can access an application's product list by
+ selecting the <strong>In-app Products</strong> link in the main Apps
+ navigation.
+ </figcaption>
+ </figure>
+</div>
<p>You can access an application's product list by clicking the <strong>In-App Products</strong>
link in applications listed in your developer account (see
@@ -58,25 +71,17 @@
you are selling in your application. It does not store any digital content. You are responsible for
storing and delivering the digital content that you sell in your applications.</p>
-<div style="margin:1em;">
-<img style="border:1px solid #ddd;padding-bottom:.5em" src="{@docRoot}images/in-app-billing/billing_product_list.png" xheight="548" id="figure1" />
-<p class="img-caption" style="padding-left:.5em;">
- <strong>Figure 1.</strong> You can access an application's product list by clicking the
- <strong>In-App Products</strong> link in the main Apps navigation.
-</p>
-</div>
-
<p>You can create a product list for any published application, or any
application in the alpha or beta channels, that's been
uploaded and saved to the Developer Console. However, you must have a Google payments merchant
account and the application's manifest must include the <code>com.android.vending.BILLING</code>
permission. If an application's manifest does not include this permission, you will be able to edit
-existing items in the product list but you will not be able to add new items to the list. For more
+existing items in the product list, but you won't be able to add new items to the list. For more
information about this permission, see
<a href="{@docRoot}google/play/billing/billing_integrate.html#billing-permission">Updating Your
Application's Manifest</a>.</p>
-<p class="note"><strong>Note:</strong> Previously you could test an app by
+<p class="note"><strong>Note:</strong> Previously, you could test an app by
uploading an unpublished "draft" version. This functionality is no longer
supported; instead, you must publish it to the alpha or beta distribution
channel. For more information, see <a
@@ -97,7 +102,9 @@
product list for testing purposes. The CSV file method is useful if your application has a large
number of in-app items.</p>
-<p class="note"><strong>Note:</strong> Batch upload of product lists containing subscriptions is not yet supported.</p>
+<p class="note"><strong>Note:</strong> Batch upload of product lists containing subscriptions is not yet supported.
+Also, you cannot perform a batch upload containing changes to in-app products that are linked to a
+<a href="#pricing-template">pricing template</a>.</p>
<h3 id="billing-form-add">Adding items one at a time to a product list</h3>
@@ -107,39 +114,67 @@
<li><a href="http://play.google.com/apps/publish">Log in</a> to your publisher account.</li>
<li>In the <strong>All Applications</strong> panel, click on the
app name, then select <strong>In-app Products</strong>.</li>
- <li>Click <strong>Add new product</strong> (see figure 2) and provide details about the item you are
- selling and then click <strong>Save</strong> or <strong>Publish</strong>.</li>
+ <li>Click <strong>Add new product</strong> (see figure 2) and provide the product type and ID for the item you are
+ selling. Click <strong>Continue</strong>.</li>
+ <li>Enter additional information about the item, then click <strong>Save</strong> or <strong>Publish</strong>.
</ol>
-<div style="margin:1em;">
-<img style="border:1px solid #ddd;padding-bottom:.5em;" src="{@docRoot}images/in-app-billing/billing_add.png" height="300" id="figure2" />
-<p class="img-caption" style="padding-left:.5em;">
- <strong>Figure 2.</strong> The Add New Product page lets you add items to an
- application's product list.
-</p>
+<div class="figure-right">
+ <figure id="fig-anp">
+ <img src="{@docRoot}images/in-app-billing/add_new_product.png" width="300"
+ alt="Adding a managed product with a Product ID of basic_sleeping_potion.">
+ <figcaption>
+ <b>Figure 2. </b>The <em>Add New Product</em> page lets you
+ provide basic information about a paid app or in-app product.
+ </figcaption>
+ </figure>
</div>
-<p>You must enter the following information for each item in a product list:</p>
+<div class="figure-right">
+ <figure id="fig-nmp">
+ <img src="{@docRoot}images/in-app-billing/new_managed_product.png" width="700"
+ alt="">
+ <figcaption>
+ <b>Figure 3. </b>The <em>New Managed Product</em> page lets you finish
+ adding items to an app’s product list.
+ </figcaption>
+ </figure>
+</div>
+
+<div class="figure-right">
+ <figure id="fig-elp">
+ <img src="{@docRoot}images/in-app-billing/edit_local_prices.png" width="700"
+ alt="An item that costs 1.99 in USD usually costs a different amount in AUD,
+ EUR, or BOB. Some countries also add tax to the price.">
+ <figcaption>
+ <b>Figure 4. </b>Specifying additional currencies for an in-app product.
+ </figcaption>
+ </figure>
+</div>
+
+<p>You must enter the following information for each item in a product list (see
+ figures 2 and 3):</p>
<ul>
<li><strong>In-app Product ID</strong>
<p>Product IDs are unique across an application's namespace. A product ID must start with a
lowercase letter or a number, and must be composed using only lowercase letters (a-z), numbers
- (0-9), underlines (_), and dots (.). The product ID "android.test" is reserved, as are all
- product IDs that start with "android.test."</p>
- <p>In addition, you cannot modify an item's product ID after it is created, and you cannot reuse
+ (0-9), underscores (_), and dots (.). The product ID <code>"android.test"</code> is reserved, as are all
+ product IDs that start with <code>"android.test"</code>.</p>
+ <p class="note"><strong>Note: </strong>Be sure to plan your product ID namespace carefully. You
+ cannot modify an item's product ID after it is created, and you cannot reuse
a product ID.</p>
</li>
<li><strong>Product Type</strong>
- <p>The product type can be <strong>Managed per user account</strong>,
- <strong>Unmanaged</strong>, or <strong>Subscription</strong>. You can never
+ <p>The product type can be <strong>Managed product</strong> or <strong>Subscription</strong>. You cannot
change an item's product type after you set it. For more information, see
- <a href="#billing-purchase-type">Choosing a product type</a> later in this
- document.</p>
+ <a href="#billing-purchase-type">Choosing a product type</a>.</p>
+ <p class="note"><strong>Note: </strong>For subscription items, note that you cannot change the
+ item's price once you have published it.</p>
</li>
<li><strong>Publishing State</strong>
<p>An item's publishing state can be <strong>Published</strong> or <strong>Unpublished
</strong>. To be visible to a user during checkout, an item's publishing state must be set to
- <strong>Published</strong> and the item's application must be published on Google Play.</p>
+ <strong>Published</strong>, and the item's application must be published on Google Play.</p>
<p class="note"><strong>Note:</strong> This is not true for test accounts. An item is visible to
a test account if the application is not published and the item is published. See <a
href="{@docRoot}google/play/billing/billing_testing.html#billing-testing-real">Testing In-app
@@ -147,12 +182,12 @@
</li>
<li><strong>Languages and Translations</strong>
<p>You can provide localized titles and descriptions for your in-app
- products using the Add Translations button. If you want Google Play to translate
- your title and description for you, based on the title and description in the
- default language, just click the languages that you want to offer. If you want
- to provide custom translations in specific languages, you can also do that. By
- default, an in-app product inherits its default language from the parent
- application.</p>
+ products by selecting <strong>Add Translations</strong>. If you want Google
+ Play to translate your title and description for you, based on the title and
+ description in the default language, just choose the languages that you
+ want to offer. If you want to provide custom translations in specific
+ languages, you can also do that. By default, an in-app product inherits its
+ default language from the parent application.</p>
</li>
<li><strong>Title</strong>
<p>The title is a short descriptor for the item. For example, "Sleeping potion."
@@ -166,36 +201,19 @@
up to 80 characters in length.</p>
</li>
<li><strong>Price</strong>
- <p>You must provide a default price in your home currency. You can also provide prices in other
- currencies, but you can do this only if a currency's corresponding country is listed as a
- target country for your application. You can specify target countries on the Edit Application
- page in the Google Play developer console.</p>
- <p>To specify prices in other currencies, you can manually enter the price for each
- currency or you can click <strong>Auto Fill</strong> and let Google Play do a one-time
- conversion from your home currency to the currencies you are targeting (see figure 3).</p>
- <p>For subscription items, note that you can not change the item's price once you have published
- it.</p>
+ <p>Provide a price in your home currency, or link the price to an existing
+ pricing template (see figure 4). Based on the price you enter or the prices
+ from the pricing template, the system autofills country-specific prices for
+ different currencies. These generated prices use today's exchange rates and
+ locally-relevant pricing patterns.</p>
+ <p>You can also change prices for other currencies manually, but you can do
+ this only if a currency is used in one of the target countries for your
+ application. You can specify target countries for your app on the
+ <strong>Pricing & Distribution</strong> page in the Google Play
+ Developer Console.</p>
</li>
</ul>
-<div style="margin:1em;">
-<img style="border:1px solid #ddd;padding-bottom:.5em"
- src="{@docRoot}images/in-app-billing/billing_list_form_2.png"
- xheight="1226" id="figure3" />
-<p class="img-caption" style="padding-left:.5em;">
- <strong>Figure 3.</strong> Specifying additional currencies for an in-app product.
-</p>
-</div>
-
-<p>For more information about product IDs and product lists, see <a
-href="http://support.google.com/googleplay/android-developer/bin/answer.py?hl=en&answer=1072599">
-Creating In-App Product IDs</a>. For more information about pricing, see <a
-href="http://support.google.com/googleplay/android-developer/bin/answer.py?hl=en&answer=1153485">
-In-App Billing Pricing</a>.</p>
-
-<p class="note"><strong>Note</strong>: Be sure to plan your product ID namespace. You cannot reuse
-or modify product IDs after you save them.</p>
-
<h3 id="billing-bulk-add">Adding a batch of items to a product list</h3>
<p>To add a batch of items to a product list using a CSV file, you first need to create your CSV
@@ -203,17 +221,48 @@
manually through the In-app Products UI (see <a href="#billing-form-add">Adding items one at a time
to a product list</a>).
-<p>If you are importing and exporting CSV files with in-app products, please
-keep tax-inclusive pricing in mind. If you use auto-fill, you can provide a
-tax-exclusive default price and tax-inclusive prices will be auto-filled. If you
+<p>If you are importing and exporting CSV files with in-app products, keep
+country-specific pricing in mind. If you use auto-fill, you can provide a
+tax-exclusive default price, and tax-inclusive prices will be auto-filled. If you
do not use auto-fill, prices you provide must include tax.</p>
<p class="note"><strong>Note:</strong> Batch upload of product lists containing
-subscriptions is not yet supported.</p>
+subscriptions is not yet supported. Also, you cannot perform a batch upload
+containing changes to in-app products that are linked to a
+<a href="#pricing-template">pricing template</a>.</p>
-The CSV file uses commas (,) and semi-colons (;) to separate data values.
-Commas are used to separate primary data values, and semi-colons are used to separate subvalues. For
-example, the syntax for the CSV file is as follows:</p>
+
+
+<p>To import the items that are specified in your CSV file, do the following:</p>
+
+<ol>
+ <li><a href="http://play.google.com/apps/publish">Log in</a> to your publisher account.</li>
+ <li>In the <strong>All Applications</strong> panel, click on the app
+ name, then select <strong>In-app Products</strong>.</li>
+ <li>On the In-app Products List page, click <strong>Import/Export</strong>
+ > <strong>Import in-app products from CSV file</strong>, then select your
+ CSV file.
+ <p>The CSV file must be on your local computer or on a local disk that is connected to your
+ computer.</p>
+ </li>
+ <li>Select the <strong>Overwrite</strong> checkbox if you want to overwrite existing items in
+ your product list.
+ <p>This option overwrites values of existing items only if the value of the <em>product_id</em>
+ in the CSV file matches the In-app Product ID for an existing item in the product list.
+ Overwriting doesn't delete items that are on a product list but not present in the CSV
+ file.</p>
+ </li>
+</ol>
+
+<p>You can also export an existing product list to a CSV file by clicking <strong>Export to CSV
+</strong> on the In-app Product List page. This is useful if you have manually added items to
+a product list and you want to start managing the product list through a CSV file.</p>
+
+<h4 id="billing-bulk-format">Formatting batches of items</h4>
+
+<p>The CSV file uses commas (,) and semi-colons (;) to separate data values.
+Commas are used to separate primary data values, and semi-colons are used to
+separate subvalues. For example, the syntax for the CSV file is as follows:</p>
<p>"<em>product_id</em>","<em>publish_state</em>","<em>purchase_type</em>","<em>autotranslate</em>
","<em>locale</em>; <em>title</em>; <em>description</em>","<em>autofill</em>","<em>country</em>;
@@ -266,36 +315,39 @@
<li><em>title</em>
<p>This is equivalent to the Title setting in the In-app Products UI. If the <em>title</em>
contains a semicolon, it must be escaped with a backslash (for example, "\;"). A backslash
- should also be escaped with a backslash (for example, "\\">.</p>
+ should also be escaped with a backslash (for example, "\\").</p>
</li>
<li><em>description</em>
<p>This is equivalent to the Description in the In-app Products UI. If the <em>description</em>
contains a semicolon, it must be escaped with a backslash (for example, "\;"). A backslash
- should also be escaped with a backslash (for example, "\\">.</p>
+ should also be escaped with a backslash (for example, "\\").</p>
</li>
<li><em>autofill</em>
<p>This is equivalent to clicking <strong>Auto Fill</strong> in the In-app Products UI. Can be
<code>true</code> or <code>false</code>. The syntax for specifying the <em>country</em>
and <em>price</em> varies depending on which <em>autofill</em> setting you use.</p>
<p>If <em>autofill</em> is set to <code>true</code>, you need to specify only the default
- price in your home currency and you must use this syntax:</p>
+ price in your home currency, and you must use this syntax:</p>
<p>"true","<em>default_price_in_home_currency</em>"
<p>If <em>autofill</em> is set to <code>false</code>, you need to specify a <em>country</em>
- and a <em>price</em> for each currency and you must use the following syntax:</p>
+ and a <em>price</em> for each currency, and you must use the following syntax:</p>
<p>"false", "<em>home_country</em>; <em>default_price_in_home_currency</em>; <em>country_2</em>;
<em>country_2_price</em>; <em>country_3</em>; <em>country_3_price</em>; ..."</p>
+ <p class="note"><strong>Note: </strong>If you use an <em>autofill</em> value of <code>false</code>
+ and set country prices manually, you must incorporate country-specific
+ pricing patterns, including tax rates, into the prices you provide.</p>
</li>
<li><em>country</em>
<p>The country for which you are specifying a price. You can only list countries that your
application is targeting. The country codes are two-letter uppercase
- ISO country codes (such as "US") as defined by
+ ISO country codes (such as "US"), as defined by
<a href="http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2">ISO 3166-2</a>.</p>
</li>
<li><em>price</em>
<p>This is equivalent to the Price in the In-app Products UI. The price must be specified in
micro-units. To convert a currency value to micro-units, you multiply the real value by
1,000,000.
- For example, if you want to sell an in-app item for $1.99 you specify 1990000 in the
+ For example, if you want to sell an in-app item for $1.99, you specify <code>1990000</code> in the
<em>price</em> field.</p>
</li>
</ul>
@@ -373,32 +425,352 @@
</tr>
</table>
-<p>To import the items that are specified in your CSV file, do the following:</p>
+<h2 id="pricing-template">
+ Pricing Templates
+</h2>
+
+<p>
+ If you sell multiple apps at the same price—or multiple in-app products at
+ the same price across one or more apps—you can add <em>pricing
+ templates</em>. These templates make it easier to manage shared prices.
+</p>
+
+<h3 id="add-pricing-template">
+ Adding a pricing template
+</h3>
+
+<p>
+ When creating a template, you can provide new pricing information, or you can
+ apply pricing information from an existing paid app or in-app product.
+</p>
+
+<div class="figure-right">
+ <figure id="fig-npt">
+ <img src="{@docRoot}images/in-app-billing/new_pricing_template.png"
+ srcset="{@docRoot}images/in-app-billing/new_pricing_template.png 1x, {@docRoot}images/in-app-billing/new_pricing_template_2x.png 2x"
+ width="400" alt="A template with the name Basic inventory uses a price of
+ USD 0.99.">
+ <figcaption>
+ <b>Figure 5. </b>The <em>Pricing template</em> page, where you add pricing
+ details for the new template you're creating.
+ </figcaption>
+ </figure>
+</div>
+
+<p>
+ To add a pricing template, do the following:
+</p>
<ol>
- <li><a href="http://play.google.com/apps/publish">Log in</a> to your publisher account.</li>
- <li>In the <strong>All Applications</strong> panel, click on the app
- name, then select <strong>In-app Products</strong>.</li>
- <li>On the In-app Products List page, click <strong>Import/Export</strong>
- > <strong>Import in-app products from CSV file</strong>, then select your
- CSV file.
- <p>The CSV file must be on your local computer or on a local disk that is connected to your
- computer.</p>
+ <li>
+ <a href="http://play.google.com/apps/publish">Log in</a> to your publisher
+ account.
</li>
- <li>Select the <strong>Overwrite</strong> checkbox if you want to overwrite existing items in
- your product list.
- <p>This option overwrites values of existing items only if the value of the <em>product_id</em>
- in the CSV file matches the In-app Product ID for an existing item in the product list.
- Overwriting does not delete items that are on a product list but not present in the CSV
- file.</p>
+
+ <li>In the <strong>Settings</strong> panel, select <strong>Pricing
+ template</strong>.
+ </li>
+
+ <li>
+ <p>
+ If you are adding your first pricing template, the <strong>Add a Pricing
+ Template</strong> banner appears. Select <strong>Add template</strong> to
+ create a new template. The <strong>Pricing Template</strong> page
+ appears.
+ </p>
+
+ <p>
+ Otherwise, you see a list of your pricing templates. Select <strong>New
+ pricing template</strong>. The <strong>Pricing Template</strong> page
+ appears.
+ </p>
+ </li>
+
+ <li>
+ <p>
+ Provide details about the template. These details include the name, the
+ price, and whether to include tax as part of your country-specific
+ prices.
+ </p>
+ <p>
+ Based on the price and tax option you provide, the Developer Console
+ generates prices for international currencies using today's exchange
+ rates and country-specific pricing patterns.
+ </p>
+ </li>
+ <li>Select <strong>Create template</strong> to finish adding the template.
</li>
</ol>
-<p>You can also export an existing product list to a CSV file by clicking <strong>Export to CSV
-</strong> on the In-app Product List page. This is useful if you have manually added items to
-a product list and you want to start managing the product list through a CSV file.</p>
+<h3 id="link-pricing-template">
+ Linking a pricing template
+</h3>
-<h3 id="billing-purchase-type">Choosing a Product Type</h3>
+<p>
+ You can link shared prices across paid apps or in-app products to a pricing
+ template. To complete the linking process, use either the template's
+ <em>Linked Items</em> tab or the Price section within a paid app or in-app
+ product's pricing page.
+</p>
+
+<p class="note">
+ <strong>Note:</strong> Since a subscription within your app has a constant
+ price, you cannot link a subscription with a pricing template. You can,
+ however, import the prices from a template and apply them to a new
+ subscription.
+</p>
+
+<h4>
+ Linking a pricing template or paid app to an in-app product
+</h4>
+
+<p>
+ After you create a pricing template, you can link the prices of in-app
+ products and paid apps to that template. After completing this linking
+ process, any changes you make to the pricing template are applied to the
+ prices of items that you've linked to the template.
+</p>
+
+<div class="figure-right">
+ <figure id="fig-lpt">
+ <img src="{@docRoot}images/in-app-billing/link_pricing_template.png"
+ width="700" alt="The Sleeping Potion in-app product is linked to the Basic
+ Inventory item, but the Invisibility Potion is not.">
+ <figcaption>
+ <b>Figure 6. </b>Use the Linked Items tab of the
+ <em>Pricing Template</em> page to change which in-app products and paid
+ apps are linked to a pricing template.
+ </figcaption>
+ </figure>
+</div>
+
+<p>
+ To link a pricing template to an in-app product, do the following:
+</p>
+
+<ol>
+ <li>
+ <a href="http://play.google.com/apps/publish">Log in</a> to your publisher
+ account.
+ </li>
+
+ <li>In the <strong>Settings</strong> panel, select <strong>Pricing
+ template</strong>. The <strong>Pricing Template</strong> page appears,
+ showing the list of pricing templates you have created for your account.
+ </li>
+
+ <li>Choose the pricing template that you want to link to an in-app product,
+ then select the <em>Linked Items</em> tab. A page appears, showing options to
+ link your pricing template to in-app products and paid apps.
+ </li>
+
+ <li>In the Link In-App Products section of the page, enter or choose the name
+ of an app. This app should contain the in-app product that you want to link
+ to your pricing template.
+ </li>
+
+ <li>Based on the app that you selected, you see a list of in-app products
+ that are active and are not yet linked to a pricing template. Select the
+ in-app product that you want to link to the pricing template by selecting the
+ <strong>Link</strong> button that appears in the same row as the in-app
+ product.
+ </li>
+
+ <li>The price of the in-app product is now linked to your pricing template.
+ Any changes you make to the prices within your pricing template affect the
+ prices of the linked in-app product.
+ </li>
+</ol>
+
+<p>
+ To link a pricing template to the price of a paid app, you follow a similar
+ process. On the pricing template's <em>Linked Items</em> tab, choose a paid
+ app in the Link Paid Apps section.
+</p>
+
+<h4>
+ Linking an in-app product or paid app with a pricing template
+</h4>
+
+<p>
+ After you create a paid app or in-app product, you can link its pricing
+ information to a pricing template.
+</p>
+
+<div class="figure-right">
+ <figure id="fig-spt">
+ <img src="{@docRoot}images/in-app-billing/select_pricing_template.png"
+ width="700" alt="">
+ <figcaption>
+ <b>Figure 7. </b>Choosing a pricing template to link to a particular
+ in-app product or paid app.
+ </figcaption>
+ </figure>
+</div>
+
+<p>
+ To link an in-app product to a pricing template, do the following:
+</p>
+
+<ol>
+ <li>
+ <a href="http://play.google.com/apps/publish">Log in</a> to your publisher
+ account.
+ </li>
+
+ <li>In the <strong>All Applications</strong> panel, choose the app that
+ contains the in-app product that you want to link to a pricing template.
+ </li>
+
+ <li>Within the app's panel, choose the <strong>In-app Products</strong>
+ sub-panel.
+ </li>
+
+ <li>Choose the in-app product that you want to link to a pricing template.
+ The <em>Managed Product Details</em> page appears.
+ </li>
+
+ <li>In the Pricing section, choose the pricing template that you want to link
+ to the price of this in-app product (see figure 7).
+ </li>
+
+ <li>The price of the in-app product is now linked to the pricing template you
+ selected. Any changes you make to the prices within your pricing template
+ affect the prices of this in-app product.
+ </li>
+</ol>
+
+<p>
+ To link the price of a paid app to a pricing template, you follow a similar
+ process within the app's <strong>Pricing & Distribution</strong>
+ sub-panel.
+</p>
+
+<h3 id="delete-linked-item">
+ Deleting an item that is linked to a pricing template
+</h3>
+
+<p>
+ As your app evolves, you may find it useful to remove older versions of
+ in-app products or apps, some of which may be linked to pricing templates. To
+ delete an in-app product or app that is linked to a pricing template, simply
+ remove it by completing the following steps. You don't need to unlink the
+ in-app product or app from the pricing template beforehand.
+</p>
+
+<h4>
+ Deleting an in-app product that is linked to a template
+</h4>
+
+<div class="figure-right">
+ <figure id="fig-diap">
+ <img src="{@docRoot}images/in-app-billing/delete_iap.png"
+ width="700" alt="">
+ <figcaption>
+ <b>Figure 8. </b>Deleting an in-app product that is linked to a pricing
+ template.
+ </figcaption>
+ </figure>
+</div>
+
+<p>
+ To delete an in-app product that is linked to a template, do the following:
+</p>
+
+<ol>
+ <li>
+ <a href="http://play.google.com/apps/publish">Log in</a> to your publisher
+ account.
+ </li>
+
+ <li>In the Google Play Developer Console, navigate to the app that contains
+ the in-app product you want to delete.
+ </li>
+
+ <li>Open the app's <strong>In-app Products</strong> page.
+ </li>
+
+ <li>Choose the in-app product that you want to delete.
+ </li>
+
+ <li>Select the button that indicates whether the in-app product is active or
+ inactive (enclosed in a box within figure 8). The drop-down menu includes a
+ <strong>Delete</strong> option.
+ </li>
+ <li>Select <strong>Delete</strong>, then select <strong>Yes</strong> in the
+ confirmation dialog that appears.
+ </li>
+</ol>
+
+<h4>
+ Deleting a paid app that is linked to a template
+</h4>
+
+<div class="figure-right">
+ <figure id="fig-upa">
+ <img src="{@docRoot}images/in-app-billing/unpublish_paid_app.png"
+ width="700" alt="">
+ <figcaption>
+ <b>Figure 9. </b>Unpublishing an app that has already been published and is
+ linked to a pricing template.
+ </figcaption>
+ </figure>
+</div>
+
+<p>
+ To delete a paid app that is linked to a template, do the following:
+</p>
+
+<ol>
+ <li>
+ <a href="http://play.google.com/apps/publish">Log in</a> to your publisher
+ account.
+ </li>
+
+ <li>In the Google Play Developer Console, choose the app that you want to
+ delete.
+ </li>
+
+ <li>Choose either <strong>Unpublish app</strong> (enclosed in a box within
+ figure 9) if you have already published the app, or
+ <strong>Delete app</strong> if your app is still in the "draft" state.
+ </li>
+ <li>Confirm your choice in the dialog that appears.
+ </li>
+</ol>
+
+<h3 id="delete-pricing-template">
+ Deleting a pricing template
+</h3>
+
+<p>
+ If you no longer need a pricing template, you can delete it by completing the
+ following steps:
+</p>
+
+<ol>
+ <li>
+ <a href="http://play.google.com/apps/publish">Log in</a> to your publisher
+ account.
+ </li>
+
+ <li>In the <strong>Settings</strong> panel, select <strong>Pricing
+ template</strong>. The <strong>Pricing Template</strong> page appears,
+ showing the list of pricing templates you have created for your account.
+ </li>
+
+ <li>Select the pricing template that you wish to delete.
+ </li>
+
+ <li>In the <em>Linked Items</em> tab on the pricing template details page,
+ unlink the pricing template from all in-app products and paid apps.
+ </li>
+
+ <li>Select <strong>Delete template</strong>.
+ </li>
+</ol>
+
+<h2 id="billing-purchase-type">Choosing a Product Type</h3>
<p>An item's product type controls how Google Play manages the purchase of the item. There are
several product types, including "managed per user account", "unmanaged," and "subscription." However,
@@ -408,8 +780,7 @@
<p>For details, refer to the documentation for <a
href="{@docRoot}google/play/billing/api.html#producttype">In-app Billing Version
-3</a> or <a href="{@docRoot}google/play/billing/v2/api.html#producttype">In-app
-Billing Version 2</a>.
+3</a>.
<h2 id="billing-refunds">Handling Refunds</h2>
@@ -496,26 +867,31 @@
<h3 id="license_key">Getting an app's license key</h3>
<p>The Google Play Developer Console provides a public licensing key for each
-app. To get the key for an app, follow these steps:</p>
+app.</p>
+
+<div class="figure-right">
+ <figure id="fig-bak">
+ <img src="{@docRoot}images/in-app-billing/billing_app_key.png"
+ width="700" alt="">
+ <figcaption>
+ <b>Figure 10. </b>You can find the license key for each app in the
+ <strong>Services & APIs</strong> panel.
+ </figcaption>
+ </figure>
+</div>
+
+<p>To get the key for an app, follow these steps:</p>
<ol>
<li>Open the <strong>All Applications</strong> panel.</li>
<li>Click on the app name, then select <strong>Services & APIs</strong>.</li>
<li>Scroll down to the <strong>Your License Key for this Application</strong>
-field to locate the key for the app, as shown in the figure below.</li>
+field to locate the key for the app, as shown in figure 10.</li>
</ol>
<p>Previously, the Developer Console provided a single public key per developer
account. To transition apps to the new per-app public key, the Developer Console
set the app-specific key as the former developer key. This ensures compatibility
for apps that depend on the (former) developer key. </p>
-<div style="margin:1em;">
-<img style="border:1px solid #ddd;padding-bottom:.5em" src="{@docRoot}images/in-app-billing/billing_app_key.png" xheight="510" id="figure4" />
-<p class="img-caption" style="padding-left:.5em;">
- <strong>Figure 4.</strong> You can find the license key for each app in the
- <strong>Services & APIs</strong> panel.
-</p>
-</div>
-
<h2 id="billing-support">Where to Get Support</h2>
<p>If you have questions or encounter problems while implementing In-app Billing, contact the
diff --git a/docs/html/google/play/billing/billing_overview.jd b/docs/html/google/play/billing/billing_overview.jd
index cc56468..2954a83 100644
--- a/docs/html/google/play/billing/billing_overview.jd
+++ b/docs/html/google/play/billing/billing_overview.jd
@@ -122,7 +122,7 @@
<h2 id="console">Google Play Developer Console</h2>
<p>The Developer Console is where you can publish your
-In-app Billing application, and manage the various in-app products that are
+In-app Billing application and manage the various in-app products that are
available for purchase from your application.</p>
<p>You can create a product list of
digital goods that are associated with your application, including items for
@@ -130,6 +130,14 @@
information such as the item’s unique product ID (also called its SKU), product
type, pricing, description, and how Google Play should handle and track
purchases for that product.</p>
+<p>If you sell several of your apps or in-app products at the same price, you
+can add <em>pricing templates</em> to manage these price points from a
+centralized location. When using pricing templates, you can include the local
+tax within the prices you provide, or you can provide prices and have the system
+add local taxes to these prices. You can make changes to the prices in your
+templates—such as refreshing the exchange rates for certain
+countries—and your changes are applied to the apps and in-app products
+that you link to the template.</p>
<p>You can also create test accounts to authorize
access for testing applications that are unpublished.</p>
<p>To learn how to use the Developer Console to configure your in-app
diff --git a/docs/html/google/play/billing/billing_reference.jd b/docs/html/google/play/billing/billing_reference.jd
index 45ec785..95ab8e5 100644
--- a/docs/html/google/play/billing/billing_reference.jd
+++ b/docs/html/google/play/billing/billing_reference.jd
@@ -139,7 +139,8 @@
<td>{@code price_amount_micros}</td>
<td>Price in micro-units, where 1,000,000 micro-units equal one unit of the
currency. For example, if {@code price} is {@code "€7.99"}, {@code
- price_amount_micros} is {@code "7990000"}.</td>
+ price_amount_micros} is {@code "7990000"}. This value represents the
+ localized, rounded price for a particular currency.</td>
</tr>
<tr>
<td>{@code price_currency_code}</td>
diff --git a/docs/html/google/play/billing/index.jd b/docs/html/google/play/billing/index.jd
index b2e9fe4..795aceb 100644
--- a/docs/html/google/play/billing/index.jd
+++ b/docs/html/google/play/billing/index.jd
@@ -14,6 +14,16 @@
<div class="sidebox">
<h2><strong>New in In-App Billing</strong></h2>
<ul>
+ <li><strong>Rounded Pricing</strong>—After developers set prices for the
+ apps and in-app products that they distribute to multiple countries, the
+ system automatically sets local prices for different currencies using
+ today’s exchange rates and country-specific pricing patterns. To satisfy
+ specific pricing needs, developers can also adjust these prices manually.</li>
+ <li><strong>Pricing Templates</strong>—Developers can add pricing
+ templates and link these templates to app prices or in-app product prices.
+ These templates include local prices across all markets. By using a
+ template, developers can apply price changes in bulk to all items linked to
+ that template.</li>
<li><strong>In-app Promotions</strong>—Developers can create promo codes
which users can redeem for content or features.</li>
<li><strong>Prorated Subscription Prices</strong>—Content providers can
@@ -29,33 +39,13 @@
<li><strong>Subscription Upgrade/Downgrade</strong>—A user can
subscribe to a higher or lower tier of subscription while their current
subscription is active. The old subscription is canceled, and the unused
- portion is applied on a pro-rated basis to the new subscription.</li>
+ portion is applied on a prorated basis to the new subscription.</li>
<li><strong>Manual Subscription Renewal</strong>—A user can purchase
a subscription at the current rate while their existing subscription is
still active. The existing subscription is extended by the appropriate
period.</li>
<li><strong>IAB Sandbox</strong>—The In-app Billing Sandbox now supports
testing subscription purchases.</li>
- <li><strong>As of January 2015, the In-App Billing v2 API is shut down.
- If your app is still using In-app Billing
- v2, please migrate to the v3 API as soon as possible.</strong></li>
- <li><strong>Seasonal subscriptions</strong>—You can now set up a
- recurring <a href="billing_subscriptions.html#user-billing">seasonal
- subscription</a> that starts and ends on the same date each year (for
- example, a sports subscription that starts every September 1 and ends every
- April 10).</li>
- <li><strong>Deferred subscription billing</strong>—You can
- <a href="billing_subscriptions.html#deferred-billing">defer</a> a
- subscriber's next billing date until the date you choose. The user still has
- access to the content but is not charged during the deferral period.</li>
- <li><strong>Weekly subscriptions</strong>—You can now set up a
- recurring <a href="billing_subscriptions.html#user-billing">subscription</a>
- that bills the user every week.</li>
- <li><strong>Payment grace period</strong>—If a subscriber misses a
- subscription payment due to an expired credit card, you can define a
- <a href="billing_subscriptions.html#grace-period">grace period</a>
- to the continue the subscription until payment is successful.</li>
-
</ul>
</div>
</div>
@@ -101,5 +91,5 @@
implementation.</dd>
<dt><strong><a href="{@docRoot}google/play/billing/billing_admin.html">Administering
In-app Billing</a></strong></dt>
- <dd>Learn how to set up your product list, register test accounts, and handle refunds.</dd>
+ <dd>Learn how to set up your product list, add pricing templates, register test accounts, and handle refunds.</dd>
</dl>
diff --git a/docs/html/images/in-app-billing/add_new_product.png b/docs/html/images/in-app-billing/add_new_product.png
new file mode 100644
index 0000000..2281ec0
--- /dev/null
+++ b/docs/html/images/in-app-billing/add_new_product.png
Binary files differ
diff --git a/docs/html/images/in-app-billing/billing_add.png b/docs/html/images/in-app-billing/billing_add.png
deleted file mode 100644
index 1ca448d..0000000
--- a/docs/html/images/in-app-billing/billing_add.png
+++ /dev/null
Binary files differ
diff --git a/docs/html/images/in-app-billing/billing_app_key.png b/docs/html/images/in-app-billing/billing_app_key.png
index bff8500..4c5300e 100644
--- a/docs/html/images/in-app-billing/billing_app_key.png
+++ b/docs/html/images/in-app-billing/billing_app_key.png
Binary files differ
diff --git a/docs/html/images/in-app-billing/billing_list_form_2.png b/docs/html/images/in-app-billing/billing_list_form_2.png
deleted file mode 100644
index 33f17c9..0000000
--- a/docs/html/images/in-app-billing/billing_list_form_2.png
+++ /dev/null
Binary files differ
diff --git a/docs/html/images/in-app-billing/billing_product_list.png b/docs/html/images/in-app-billing/billing_product_list.png
deleted file mode 100644
index dabdcb9..0000000
--- a/docs/html/images/in-app-billing/billing_product_list.png
+++ /dev/null
Binary files differ
diff --git a/docs/html/images/in-app-billing/delete_iap.png b/docs/html/images/in-app-billing/delete_iap.png
new file mode 100644
index 0000000..bbaea9e
--- /dev/null
+++ b/docs/html/images/in-app-billing/delete_iap.png
Binary files differ
diff --git a/docs/html/images/in-app-billing/edit_local_prices.png b/docs/html/images/in-app-billing/edit_local_prices.png
new file mode 100644
index 0000000..2b76548
--- /dev/null
+++ b/docs/html/images/in-app-billing/edit_local_prices.png
Binary files differ
diff --git a/docs/html/images/in-app-billing/in_app_products.png b/docs/html/images/in-app-billing/in_app_products.png
new file mode 100644
index 0000000..04031cc
--- /dev/null
+++ b/docs/html/images/in-app-billing/in_app_products.png
Binary files differ
diff --git a/docs/html/images/in-app-billing/link_pricing_template.png b/docs/html/images/in-app-billing/link_pricing_template.png
new file mode 100644
index 0000000..cf762a8
--- /dev/null
+++ b/docs/html/images/in-app-billing/link_pricing_template.png
Binary files differ
diff --git a/docs/html/images/in-app-billing/new_managed_product.png b/docs/html/images/in-app-billing/new_managed_product.png
new file mode 100644
index 0000000..bdccc96
--- /dev/null
+++ b/docs/html/images/in-app-billing/new_managed_product.png
Binary files differ
diff --git a/docs/html/images/in-app-billing/new_pricing_template.png b/docs/html/images/in-app-billing/new_pricing_template.png
new file mode 100644
index 0000000..8525787
--- /dev/null
+++ b/docs/html/images/in-app-billing/new_pricing_template.png
Binary files differ
diff --git a/docs/html/images/in-app-billing/new_pricing_template_2x.png b/docs/html/images/in-app-billing/new_pricing_template_2x.png
new file mode 100644
index 0000000..ce4094b
--- /dev/null
+++ b/docs/html/images/in-app-billing/new_pricing_template_2x.png
Binary files differ
diff --git a/docs/html/images/in-app-billing/select_pricing_template.png b/docs/html/images/in-app-billing/select_pricing_template.png
new file mode 100644
index 0000000..fa8c7b6
--- /dev/null
+++ b/docs/html/images/in-app-billing/select_pricing_template.png
Binary files differ
diff --git a/docs/html/images/in-app-billing/unpublish_paid_app.png b/docs/html/images/in-app-billing/unpublish_paid_app.png
new file mode 100644
index 0000000..a36d8ce
--- /dev/null
+++ b/docs/html/images/in-app-billing/unpublish_paid_app.png
Binary files differ
diff --git a/docs/html/jd_collections.js b/docs/html/jd_collections.js
index 96a210c..824cbd3 100644
--- a/docs/html/jd_collections.js
+++ b/docs/html/jd_collections.js
@@ -169,6 +169,22 @@
"preview/features/tv-recording-api.html"
]
},
+ "wear/preview/landing": {
+ "title": "",
+ "resources": [
+ "wear/preview/api-overview.html",
+ "wear/preview/downloads.html",
+ "wear/preview/start.html"
+ ]
+ },
+ "wear/preview/landing/resources": {
+ "title": "",
+ "resources": [
+ "wear/preview/features/complications.html",
+ "wear/preview/features/notifications.html",
+ "wear/preview/features/ui-nav-actions.html"
+ ]
+ },
"google/landing/services": {
"title": "",
"resources": [
diff --git a/docs/html/jd_extras_en.js b/docs/html/jd_extras_en.js
index 7ad755c..fb85f9d 100644
--- a/docs/html/jd_extras_en.js
+++ b/docs/html/jd_extras_en.js
@@ -4933,6 +4933,22 @@
"training/wearables/ui/index.html"
]
},
+ "wear/preview/landing": {
+ "title": "",
+ "resources": [
+ "wear/preview/api-overview.html",
+ "wear/preview/downloads.html",
+ "wear/preview/start.html"
+ ]
+ },
+ "wear/preview/landing/resources": {
+ "title": "",
+ "resources": [
+ "wear/preview/features/complications.html",
+ "wear/preview/features/notifications.html",
+ "wear/preview/features/ui-nav-actions.html"
+ ]
+ },
"design/auto/auto_ui_guidelines": {
"title": "",
"resources": [
diff --git a/docs/html/patience.jd b/docs/html/patience.jd
deleted file mode 100644
index e6ead5a..0000000
--- a/docs/html/patience.jd
+++ /dev/null
@@ -1,26 +0,0 @@
-page.title=Patience
-fullpage=true
-page.type=about
-nonavpage=true
-@jd:body
-
-
-<div class="landing-body-content">
-
- <div class="landing-rest-of-page">
- <div class="landing-section landing-white-background">
- <div class="wrap">
-
- <div class="landing-section-header">
- <div class="landing-h1">Patience...</div>
- <div class="landing-subhead">
- This information is not yet available. Please check back later.
- </div>
- </div>
-
- </div> <!-- end .wrap -->
- </div> <!-- end .landing-section -->
- </div> <!-- end .landing-rest-of-page -->
-
-</div> <!-- end landing-body-content -->
-
diff --git a/docs/html/preview/api-overview.jd b/docs/html/preview/api-overview.jd
index 4a7b879..09227f2 100644
--- a/docs/html/preview/api-overview.jd
+++ b/docs/html/preview/api-overview.jd
@@ -24,6 +24,7 @@
<li><a href="#number-blocking">Number-blocking</a></li>
<li><a href="#call_screening">Call screening</a></li>
<li><a href="#multi-locale_languages">Locales and languages</a></li>
+ <li><a href="#emoji">New Emojis</a></li>
<li><a href="#icu4">ICU4J APIs in Android</a></li>
<li><a href="#gles_32">OpenGL ES 3.2 API</a></li>
<li><a href="#android_tv_recording">Android TV recording</a></li>
@@ -35,9 +36,11 @@
<li><a href="#default_trusted_ca">Default Trusted CA</a></li>
<li><a href="#apk_signature_v2">APK signature scheme v2</a></li>
<li><a href="#scoped_directory_access">Scoped directory access</a></li>
- <li><a href="#launcher_shortcuts">Launcher shortcuts</a></li>
+ <li><a href="#keyboard_shortcuts_helper">Keyboard Shortcuts Helper</a></li>
+ <li><a href="#sustained_performance_api">Sustained Performance API</a></li>
<li><a href="#print_svc">Print service enhancements</a></li>
<li><a href="#virtual_files">Virtual Files</a></li>
+ <li><a href="#framemetrics_api">FrameMetricsListener API</a></li>
</ol>
</div>
</div>
@@ -114,6 +117,13 @@
</li>
<li>
+ <strong>Message style customization</strong>: You can customize more of the
+ user interface labels associated with your notifications using the
+ <code>MessageStyle</code> class. You can configure the message, conversation
+ title, and content view.
+ </li>
+
+ <li>
<strong>Bundled notifications</strong>: The system can group messages
together, for example by message topic, and display the group. A user can
take actions, such as Dismiss or Archive, on them in place. If you’ve
@@ -347,7 +357,7 @@
<p>
Vulkan is only available to apps on devices with Vulkan-capable hardware,
- such as Nexus 5X and Nexus 6P. We're working closely with our
+ such as Nexus 5X, Nexus 6P, and Nexus Player. We're working closely with our
partners to bring Vulkan to more devices as soon as possible.
</p>
@@ -472,6 +482,49 @@
should follow, see <a href="{@docRoot}preview/features/multilingual-support.html"
>Multilingual Support</a>.</p>
+
+<h2 id="emoji">New Emojis</h2>
+
+<p>
+ Android N introduces additional emojis and emoji-related features including
+ skin tone emojis and support for variation
+ selectors. If your app supports emojis,
+ follow the guidelines below to take advantage of these emoji-related features.
+</p>
+
+<ul>
+ <li>
+ <strong>Check that a device contains an emoji before inserting it.</strong>
+ To check which emojis are present in the
+ system font, use the {@link android.graphics.Paint#hasGlyph(String)} method.
+ </li>
+ <li>
+ <strong>Check that an emoji supports variation selectors.</strong>
+ Variation selectors allow you to
+ present certain emojis in color or in black-and-white.
+ On mobile devices, apps should represent emojis in color rather than black-and-white. However,
+ if your app displays emojis inline with text, then it should use the black-and-white variation.
+ To determine whether an emoji has a variation, use the variation selector.
+ For a complete list of characters with variations, review the
+ <em>emoji variation sequences</em> section of the
+ <a class="external-link"
+ href="http://www.unicode.org/Public/9.0.0/ucd/StandardizedVariants-9.0.0d1.txt">
+ Unicode documentation on variations</a>.
+ </li>
+ <li>
+ <strong>Check that an emoji supports skin tone.</strong> Android N allows users to modify the
+ rendered skin tone of emojis to their preference. Keyboard apps should provide visual
+ indications for emojis that have multiple skin tones and should allow users to
+ select the skin tone that they prefer. To determine which system emojis have
+ skin tone modifiers, use the {@link android.graphics.Paint#hasGlyph(String)}
+ method. You can determine which emojis use skin tones by reading the
+ <a class="external-link"
+ href="http://unicode.org/emoji/charts/full-emoji-list.html">
+ Unicode documentation</a>.
+ </li>
+</ul>
+
+
<h2 id="icu4">ICU4J APIs in Android</h2>
<p>
@@ -614,7 +667,7 @@
meet the needs of those users.</p>
<p>For more information, see <code>android.accessibilityservice.GestureDescription</code>
- in the downloadable <a href="{@docRoot}preview/setup-sdk.html#docs-dl">API Reference</a>.</p>
+ in the downloadable <a href="{@docRoot}preview/setup-sdk.html#docs-dl">API Reference</a>.</p>
<h2 id="direct_boot">Direct boot</h2>
@@ -622,7 +675,7 @@
<p>Direct boot improves device startup times and lets registered
apps have limited functionality even after an unexpected reboot.
For example, if an encrypted device reboots while the user is sleeping,
-registered alarms, messages and incoming calls can now continue notify
+registered alarms, messages and incoming calls can now continue to notify
the user as normal. This also means accessibility services can also be
available immediately after a restart.</p>
@@ -724,18 +777,54 @@
<h2 id="apk_signature_v2">APK signature scheme v2</h2>
-<p>The PackageManager class now supports verifying apps using the APK
-signature scheme v2. The APK signature scheme v2 is a whole-file signature scheme
-that significantly improves verification speed and strengthens integrity
- guarantees by detecting any unauthorized changes to APK files.</p>
+<p>
+ Android N introduces APK Signature Scheme v2, a new app-signing scheme that
+ offers faster app install times and more protection against unauthorized
+ alterations to APK files. By default, Android Studio 2.2 and the Android
+ Plugin for Gradle 2.2 sign your app using both APK Signature Scheme v2 and
+ the traditional signing scheme, which uses JAR signing.
+</p>
-<p>To maintain backward-compatibility, an APK must be signed with the v1 signature
-scheme (JAR signature scheme) before being signed with the v2 signature scheme.
-With the v2 signature scheme, verification fails if you sign the APK with an
- additional certificate after signing with the v2 scheme. </p>
+<p>
+ Although we recommend applying APK Signature Scheme v2 to your app, this new
+ scheme is not mandatory. If your app doesn't build properly when using APK
+ Signature Scheme v2, you can disable the new scheme. The disabling process
+ causes Android Studio 2.2 and the Android Plugin for Gradle 2.2 to sign your
+ app using only the traditional signing scheme. To sign with only the
+ traditional scheme, open the module-level <code>build.gradle</code> file, then
+ add the line <code>v2SigningEnabled false</code> to your release signing
+ configuration:
+</p>
-<p>APK signature scheme v2 support will be available later in the N Developer
-Preview.</p>
+<pre>
+ android {
+ ...
+ defaultConfig { ... }
+ signingConfigs {
+ release {
+ storeFile file("myreleasekey.keystore")
+ storePassword "password"
+ keyAlias "MyReleaseKey"
+ keyPassword "password"
+ <strong>v2SigningEnabled false</strong>
+ }
+ }
+ }
+</pre>
+
+<p class="caution"><strong>Caution: </strong> If you sign your app using APK
+ Signature Scheme v2 and make further changes to the app, the app's signature
+ is invalidated. For this reason, use tools such as <code>zipalign</code>
+ before signing your app using APK Signature Scheme v2, not after.
+</p>
+
+<p>
+ For more information, read the Android Studio documents that describe how to
+ <a href="{@docRoot}studio/tools/publishing/app-signing.html#release-mode">
+ sign an app</a> in Android Studio and how to <a href=
+ "{@docRoot}studio/tools/building/configuring-gradle.html#signing"> configure
+ the build file for signing apps</a> using the Android Plugin for Gradle.
+</p>
<h2 id="scoped_directory_access">Scoped directory access</h2>
@@ -758,60 +847,51 @@
<a href="{@docRoot}preview/features/scoped-folder-access.html">Scoped
Directory Access</a> developer documentation.</p>
-<h2 id="launcher_shortcuts">
- Launcher shortcuts
-</h2>
+<h2 id="keyboard_shortcuts_helper">Keyboard Shortcuts Helper</h2>
<p>
- Android N allows apps to define action-specific shortcuts which can be
- displayed in the launcher. These <em>launcher shortcuts</em> let your users
- quickly start common or recommended tasks within your app. Each shortcut
- contains an <a href=
- "{@docRoot}guide/components/intents-filters.html">intent</a>, which links the
- shortcut to a specific action in your app. Examples of these actions include:
+In Android N, the user can press Meta+/ to trigger a Keyboard Shortcuts
+screen that displays all shortcuts available both from the system and from
+the app in focus. These are retrieved automatically from the app’s menu if
+available, but developers can provide their own fine-tuned shortcuts lists
+for the screen. This is done simply by overriding the following method
+in {@code Activity.java}:
</p>
-<ul>
- <li>Navigating users to a particular location in a mapping app.
- </li>
-
- <li>Sending messages to a friend in a communication app.
- </li>
-
- <li>Playing the next episode of a TV show in a media app.
- </li>
-
- <li>Loading the last save point in a gaming app.
- </li>
-</ul>
-
-<p>
- Your app can create up to five <em>dynamic shortcuts</em>. When users perform
- a gesture over your app's launcher icon, these shortcuts appear. By dragging
- the shortcuts onto the launcher, users can make persistent copies of the
- shortcuts, called <em>pinned shortcuts</em>. Users can create an unlimited
- number of pinned shortcuts for each app.
-</p>
-
-<p class="note">
- <strong>Note:</strong> Although other apps can't access your shortcut data,
- the launcher <strong>does</strong> have access to this data. Therefore, the
- shortcuts you create should conceal sensitive user information.
-</p>
-
-<p>
- You can use this command to view your app's shortcuts:
-</p>
-
-<pre class="no-pretty-print">
-$ adb shell dumpsys shortcut
+<pre>
+public void onProvideKeyboardShortcuts(
+ List<KeyboardShortcutGroup> data, Menu menu, int deviceId)
</pre>
<p>
- To update all shortcuts and to delete dynamic shortcuts, use the appropriate
- methods that the Launcher Shortcut API provides. For more details about this
- API, see <code>android.content.pm.ShortcutManager</code> in the downloadable
- <a href="{@docRoot}preview/setup-sdk.html#docs-dl">API Reference</a>.
+To trigger the Keyboard Shortcuts Helper from anywhere in your app,
+call {@code requestKeyboardShortcutsHelper} for the relevant activity.
+</p>
+
+<h2 id="sustained_performance_api">Sustained Performance API</h2>
+
+<p>
+Performance can fluctuate dramatically for long-running apps, because the
+system throttles system-on-chip engines as device components reach their
+temperature limits. This fluctuation presents a moving target for app
+developers creating high-performance, long-running apps.
+</p>
+
+<p>
+To address these limitations, Android N includes support for
+<em>sustained performance mode</em>, enabling OEMs to provide hints on
+device-performance capabilities for long-running applications. App developers
+can use these hints to tune applications for a predictable,
+consistent level of device performance over long periods of time.
+</p>
+
+<p>
+App developers can try out this new API in the N Developer Preview on
+Nexus 6P devices only. To use this feature,
+set the sustained performance window flag for the window
+you want to run in sustained performance mode. Set this flag using the
+{@code setSustainedPerformanceMode(boolean)} method. The system automatically
+disables this mode when the window is no longer in focus.
</p>
<h2 id="print_svc">Print Service Enhancements</h2>
@@ -855,6 +935,51 @@
"{@docRoot}preview/setup-sdk.html#docs-dl">API Reference</a>.
</p>
+<h2 id="framemetrics_api">FrameMetricsListener API</h2>
+
+<p>
+The FrameMetricsListener API allows an app to monitor its UI rendering
+performance by exposing a streaming pubsub API to transfer frame
+timing info for the app's current window. The data returned is
+equivalent to that displayed by {@code adb shell dumpsys gfxinfo framestats},
+but is not limited to the past 120 frames.
+</p>
+
+<p>
+You can use FrameMetricsListener to measure interaction-level UI
+performance in production, without a USB connection. This API
+allows collection of data at a much higher granularity than does
+{@code adb shell dumpsys gfxinfo}. This higher granularity is possible because
+the system can collect data for particular interactions in the app; the system
+need not capture a global summary of the entire app’s
+performance, or clear any global state. You can use this
+capability to gather performance data and catch regressions in UI performance
+for real use cases within an app.
+</p>
+
+<p>
+The API provides a callback interface to be implemented and
+registered on the window that you wish to monitor:
+</p>
+
+<pre>
+ public interface FrameMetricsListener {
+ void onMetricsAvailable(Window window, FrameMetrics frameMetrics,
+ int dropCountSinceLastInvocation);
+ }
+</pre>
+
+<p>
+The API returns a FrameMetrics object, which contains timing data that
+the rendering subsystem reports for various milestones in a frame lifecycle.
+The supported metrics are: {@code UNKNOWN_DELAY_DURATION},
+{@code INPUT_HANDLING_DURATION}, {@code ANIMATION_DURATION},
+{@code LAYOUT_MEASURE_DURATION}, {@code DRAW_DURATION}, {@code SYNC_DURATION},
+{@code COMMAND_ISSUE_DURATION}, {@code SWAP_BUFFERS_DURATION},
+{@code TOTAL_DURATION}, and {@code FIRST_DRAW_FRAME}
+</p>
+
+
<h2 id="virtual_files">Virtual Files</h2>
<p>
@@ -936,4 +1061,4 @@
For more information about accessing user files, see the
<a href="{@docRoot}guide/topics/providers/document-provider.html">Storage
Access Frameworks guide</a>.
-</p>
\ No newline at end of file
+</p>
diff --git a/docs/html/preview/features/data-saver.jd b/docs/html/preview/features/data-saver.jd
index ba8f165..c4cab18 100644
--- a/docs/html/preview/features/data-saver.jd
+++ b/docs/html/preview/features/data-saver.jd
@@ -12,10 +12,16 @@
<ol>
<li>
<a href="#status">Checking Data Saver Preferences</a>
+ <ol>
+ <li>
+ <a href="#request-whitelist">Requesting whitelist permissions</a>
+ </li>
+ </ol>
</li>
<li>
- <a href="#monitor-changes">Monitoring Changes to Data Saver Preferences</a>
+ <a href="#monitor-changes">Monitoring Changes to Data Saver
+ Preferences</a>
</li>
<li>
@@ -124,6 +130,27 @@
}
</pre>
+<h3 id="request-whitelist">
+ Requesting whitelist permissions
+</h3>
+
+<p>
+ If your app needs to use data in the background, it can request whitelist
+ permissions by sending a
+ <code>Settings.ACTION_IGNORE_BACKGROUND_DATA_RESTRICTIONS_SETTINGS</code>
+ intent containing a URI of your app's package name: for example,
+ <code>package:MY_APP_ID</code>.
+</p>
+
+<p>
+ Sending the intent and URI launches the <strong>Settings</strong> app and
+ displays data usage settings for your app. The user can then decide whether
+ to enable background data for your app. Before you send this intent, it is
+ good practice to first ask the user if they want to launch the
+ <strong>Settings</strong> app for the purpose of enabling background data
+ usage.
+</p>
+
<h2 id="monitor-changes">
Monitoring Changes to Data Saver Preferences
</h2>
@@ -131,9 +158,8 @@
<p>
Apps can monitor changes to Data Saver preferences by creating a {@link
android.content.BroadcastReceiver} to listen for {@code
- ConnectivityManager.ACTION_RESTRICT_BACKGROUND_CHANGED} ({@code
- "android.net.conn.RESTRICT_BACKGROUND_CHANGED"}) and dynamically registering
- the receiver with {@link android.content.Context#registerReceiver
+ ConnectivityManager.ACTION_RESTRICT_BACKGROUND_CHANGED} and dynamically
+ registering the receiver with {@link android.content.Context#registerReceiver
Context.registerReceiver()}. When an app receives this broadcast, it should
<a href="#status">check if the new Data Saver preferences affect its
permissions</a> by calling {@code
diff --git a/docs/html/preview/features/notification-updates.jd b/docs/html/preview/features/notification-updates.jd
index 7ee0954..c405360 100644
--- a/docs/html/preview/features/notification-updates.jd
+++ b/docs/html/preview/features/notification-updates.jd
@@ -16,6 +16,7 @@
<li><a href="#direct">Direct Reply</a></li>
<li><a href="#bundle">Bundled Notifications</a></li>
<li><a href="#custom">Custom Views</a></li>
+ <li><a href="#style">Message Style</a></li>
</ol>
</div>
@@ -203,6 +204,16 @@
android.support.v4.app.RemoteInput}, you can update the reply history
using the {@code setRemoteInputHistory()} method.
</p>
+
+<p>
+ The notification must be either updated or cancelled after the app has
+ received remote input. When the user replies to a remote update
+ using Direct Reply,
+ do not cancel the notification. Instead, update the notification to display the user's reply. You can update the notification using a
+ <code>MessagingStyle</code>, or you can append the user's reply to the remote
+ input history.
+</p>
+
<h2 id="bundle">Bundled Notifications</h2>
<p>Android N provides developers with a new way to represent
@@ -233,6 +244,12 @@
group.
</p>
+<p class="note">
+ <strong>Note:</strong> If the same app sends four or more notifications
+ and does not specify a grouping, the
+ system automatically groups them together.
+</p>
+
<p>To learn how to add notifications to a group, see
<a href="{@docRoot}training/wearables/notifications/stacks.html#AddGroup">Add
Each Notification to a Group</a>.</p>
@@ -348,7 +365,7 @@
{@code DecoratedCustomViewStyle()} method.</p>
<pre>
-Notification noti = new Notification.Builder()
+Notification notification = new Notification.Builder()
.setSmallIcon(R.drawable.ic_stat_player)
.setLargeIcon(albumArtBitmap))
.setCustomContentView(contentView);
@@ -356,3 +373,26 @@
.build();
</pre>
+
+<h2 id="style">Messaging Style</h2>
+<p>
+ Android N introduces a new API for customizing the style of a notification.
+ Using the <code>MessageStyle</code> class, you can change several of the
+ labels displayed on the notification, including the conversation title,
+ additional messages, and the content view for the notification.
+</p>
+
+<p>
+ The following code snippet demonstrates how to customize a notification's
+ style using the <code>MessageStyle</code> class.
+</p>
+
+<pre>
+ Notification notification = new Notification.Builder()
+ .setStyle(new Notification.MessagingStyle("Me")
+ .setConversationTitle("Team lunch")
+ .addMessage("Hi", timestamp1, null) // Pass in null for user.
+ .addMessage("What's up?", timestamp2, "Coworker")
+ .addMessage("Not much", timestamp3, null)
+ .addMessage("How about lunch?", timestamp4, "Coworker"));
+</pre>
\ No newline at end of file
diff --git a/docs/html/preview/features/scoped-folder-access.jd b/docs/html/preview/features/scoped-folder-access.jd
index 814692d..06dd665 100644
--- a/docs/html/preview/features/scoped-folder-access.jd
+++ b/docs/html/preview/features/scoped-folder-access.jd
@@ -44,6 +44,12 @@
all available volumes, including removable media volumes, use
<code>StorageManager.getVolumesList()</code>.</p>
+<p>If you have information about a specific file, use
+<code>StorageManager.getStorageVolume(File)</code> to get the
+<code>StorageVolume</code> that contains the file. Call
+<code>createAccessIntent()</code> on this <code>StorageVolume</code> to access
+the external storage directory for the file.</p>
+
<p>
On secondary volumes, such as external SD cards, pass in null when calling
<code>StorageVolume.createAccessIntent()</code> to request access to the entire
diff --git a/docs/html/preview/features/tv-recording-api.jd b/docs/html/preview/features/tv-recording-api.jd
index b62dd46..65ab340 100644
--- a/docs/html/preview/features/tv-recording-api.jd
+++ b/docs/html/preview/features/tv-recording-api.jd
@@ -37,7 +37,23 @@
<h2 id="supporting">Indicating Support for Recording</h2>
-<p>To tell the system that your TV input service supports recording, follow
+<p>To tell the system that your TV input service supports recording, set
+the <code>android:canRecord</code> attribute in your service metadata XML file
+to <code>true</code>:
+</p>
+
+<pre>
+<tv-input xmlns:android="http://schemas.android.com/apk/res/android"
+ <b>android:canRecord="true"</b>
+ android:setupActivity="com.example.sampletvinput.SampleTvInputSetupActivity" />
+</pre>
+
+<p>For more information on the service metadata file, see
+<a href="{@docRoot}training/tv/tif/tvinput.html#manifest">Declare Your TV Input
+Service in the Manifest</a>.
+</p>
+
+<p>Alternatively, you can indicate recording support in your code using
these steps:</p>
<ol>
@@ -48,7 +64,7 @@
<code>setCanRecord(true)</code> before calling <code>build()</code> to
indicate your service supports recording.</li>
<li>Register your <code>TvInputInfo</code> object with the system by calling
-<code>TvInputService.updateTvInputInfo()</code>.</li>
+<code>TvInputManager.updateTvInputInfo()</code>.</li>
</ol>
<h2 id="recording">Recording a Session</h2>
diff --git a/docs/html/preview/support.jd b/docs/html/preview/support.jd
index f0da709..83ecde2 100644
--- a/docs/html/preview/support.jd
+++ b/docs/html/preview/support.jd
@@ -8,7 +8,8 @@
<p>
Two primary support channels are available to you when developing and testing
with the Android N Developer Preview: Please file bugs at <a href=
- "https://developer.android.com/preview/bug">https://developer.android.com/preview/bug</a> for
+ "https://developer.android.com/preview/bug"
+ >https://developer.android.com/preview/bug</a> for
device-specific, system, and Google App bugs. For issues in other apps,
please contact the developer directly.
</p>
@@ -16,6 +17,90 @@
<p>To discuss issues or ideas with other developers working with Android N, join the
<a href="{@docRoot}preview/dev-community">Developer Preview Google+ community</a>.</p>
+<h2 id="dp3">Developer Preview 3</h2>
+
+<div class="wrap">
+ <div class="cols">
+ <div class="col-6of12">
+ <p>
+ <em>Date: April 2016<br>
+ Builds: TODO<br>
+ Emulator support: x86 & ARM (32/64-bit)<br>
+ Google Play services: TODO</em>
+ </p>
+ </div>
+ </div>
+</div>
+
+<h3 id="new">New in DP3</h3>
+
+
+<h4 id="api-changes">API changes</h4>
+
+<dl>
+ <dt><a href="{@docRoot}preview/api-overview.html#number-blocking"
+ >Number-blocking</a></dt>
+ <dd>If an unauthorized user attempts to block or unblock a number, the operation
+ now fails with {@link java.lang.SecurityException}. (Previously, the
+ operation threw {@link java.lang.UnsupportedOperationException}.)</dd>
+
+ <dt><a href="{@docRoot}preview/api-overview.html#tile_api">Quick
+ Settings Tile API</a></dt>
+ <dd>The system now uses the activity's metadata to decide on the tile mode.
+ (Previously, tile mode was determined by the return value of
+ <code>TileService.onTileAdded()</code>.) For more information, see
+ <code>TileService.META_DATA_ACTIVE_TILE</code> in the downloadable
+ <a href="{@docRoot}preview/setup-sdk.html#docs-dl">API Reference</a>.
+ </dd>
+</dl>
+
+<h4 id="dp2-fixes">Fixes for issues reported by developers</h4>
+
+<p>
+ A number of issues reported by developers have been fixed, including:
+</p>
+
+<ul>
+ <li>TODO</li>
+</ul>
+
+<h3 id="general">General advisories</h3>
+
+<p>
+ This Developer Preview release is for <strong>app developers only</strong>
+ and is designed for use in compatibility testing and early development only.
+ Please be aware of these general notes about the release:
+</p>
+
+<ul>
+
+ <li>TODO</li>
+</ul>
+
+<h3 id="ki">Known Issues</h3>
+
+<p>TODO</p>
+
+<h4>Device-specific issues</h4>
+
+<p>TODO</p>
+
+<dl>
+ <dt>
+ <strong>Device Name</strong>
+ </dt>
+
+ <dd>
+ Issue 1
+ </dd>
+
+ <dd>
+ Issue 2
+ </dd>
+</dl>
+
+<!-- DP2 Release Notes Archive -->
+
<h2 id="dp2">Developer Preview 2</h2>
<div class="wrap">
@@ -31,7 +116,7 @@
</div>
</div>
-<h3 id="new">New in DP2</h3>
+<h3 id="dp2-new">New in DP2</h3>
<ul>
<li>Platform support for Vulkan, a new 3D rendering API that provides
@@ -87,7 +172,7 @@
</li>
</ul>
-<h3 id="general">General advisories</h3>
+<h3 id="dp2-general">General advisories</h3>
<p>
This Developer Preview release is for <strong>app developers only</strong>
@@ -145,7 +230,7 @@
</li>
</ul>
-<h3 id="ki">Known Issues</h3>
+<h3 id="dp2-ki">Known Issues</h3>
<h4>Performance and battery</h4>
@@ -393,7 +478,7 @@
<h3 id="dp1-platform">Platform Issues</h3>
-<h4 id="performance">Performance and battery</h4>
+<h4>Performance and battery</h4>
<ul>
<li>System and app performance is known to be <strong>periodically slow /
@@ -416,7 +501,7 @@
</li>
</ul>
-<h4 id="microphone">Microphone</h4>
+<h4>Microphone</h4>
<ul>
<li>The system may incorrect persists the microphone mute state across apps and reboots. If you mute the microphone in an app and the state is persisted, open any app that has microphone mute controls and unmute the microphone.</li>
@@ -552,19 +637,20 @@
</li>
</ul>
-<h4 id="keyboard">Keyboard</h4>
+<h4 >Keyboard</h4>
<ul>
-<li>Bluetooth pairing between keyboards and Android devices may be unstable. </li>
+ <li>Bluetooth pairing between keyboards and Android devices may be unstable.
+ </li>
</ul>
-<h4 id="video">Video</h4>
+<h4 >Video</h4>
<ul>
<li>Video playback may lag and show interruptions.</li>
</ul>
-<h4 id="wifi">Wi-Fi</h4>
+<h4>Wi-Fi</h4>
<ul>
<li>Wi-Fi has undergone some refactoring which may change API corner case
@@ -577,7 +663,7 @@
</li>
</ul>
-<h4 id="direct">Direct boot</h4>
+<h4>Direct boot</h4>
<ul>
<li>NFC doesn't function until first unlock.
@@ -607,7 +693,7 @@
</li>
</ul>
-<h4 id="pip">Picture-in-picture for Android TV</h4>
+<h4>Picture-in-picture for Android TV</h4>
<ul>
<li>The PIP integration in the Recents UI is not finalized, and is subject to
@@ -624,7 +710,7 @@
</li>
</ul>
-<h4 id="bugs">Bug reports</h4>
+<h4>Bug reports</h4>
<ul>
<li>Bug reports do not always complete successfully (as a workaround,
@@ -633,7 +719,7 @@
</li>
</ul>
-<h4 id="split">Split-screen Multi-window</h4>
+<h4>Split-screen Multi-window</h4>
<ul>
<li>Apps may experience crashes and unexpected UI behavior when put into
@@ -656,7 +742,7 @@
</li>
</ul>
-<h4 id="ime">Input method</h4>
+<h4>Input method</h4>
<ul>
<li>Google Keyboard unexpectedly falls back to the generic Google keyboard
@@ -670,26 +756,31 @@
</li>
</ul>
-
-<h4 id="accessibility">Accessibility</h4>
+<h4>Accessibility</h4>
<ul>
- <li>TalkBack exhibits issues with features including Notifications, Quick Settings Tiles and Multi-window display that may cause system crashing or lack of spoken feedback from TalkBack. Future releases of the preview will address these issues.</li>
+ <li>TalkBack exhibits issues with features including Notifications, Quick
+ Settings Tiles and Multi-window display that may cause system crashing or
+ lack of spoken feedback from TalkBack. Future releases of the preview will
+ address these issues.
+ </li>
</ul>
-<h3 id="device-sp">Device-Specific Notes and Issues</h3>
+<h3 id="dp1-device-sp">Device-Specific Notes and Issues</h3>
-<h4 id="player">Nexus Player</h4>
+<h4>Nexus Player</h4>
<ul>
-<li>Video playback, app compatibility and stability issues are expected on Nexus Player in this release of the Preview.</li>
+ <li>Video playback, app compatibility and stability issues are expected on
+ Nexus Player in this release of the Preview.
+ </li>
</ul>
-<h4 id="pixelc">Pixel C</h4>
+<h4>Pixel C</h4>
<ul>
<li>Multi-window resizing may cause crashing.</li>
</ul>
-<h4 id="n9">Nexus 9</h4>
+<h4>Nexus 9</h4>
<ul>
<li>Nexus 9 devices may not start after receiving an over-the-air (OTA) update
via the Android Beta Program. To recover from this issue, you can try
diff --git a/docs/html/wear/preview/_book.yaml b/docs/html/wear/preview/_book.yaml
new file mode 100644
index 0000000..a687294
--- /dev/null
+++ b/docs/html/wear/preview/_book.yaml
@@ -0,0 +1,32 @@
+toc:
+- title: Wear Developer Preview
+ path: /wear/preview/index.html
+
+- title: Program Overview
+ path: /wear/preview/program.html
+
+- title: API Overview
+ path: /wear/preview/api-overview.html
+ section:
+ - title: Notification Improvements
+ path: /wear/preview/features/notifications.html
+ - title: Input Method Framework
+ path: /wear/preview/features/ime.html
+ - title: Complications
+ path: /wear/preview/features/complications.html
+ - title: Wear Navigation and Actions
+ path: /wear/preview/features/ui-nav-actions.html
+ - title: Bridging for Notifications
+ path: /wear/preview/features/bridger.html
+
+- title: Downloads
+ path: /wear/preview/downloads.html
+
+- title: Get Started
+ path: /wear/preview/start.html
+
+- title: License Agreement
+ path: /wear/preview/license.html
+
+- title: Support and Release Notes
+ path: /wear/preview/support.html
diff --git a/docs/html/wear/preview/api-overview.jd b/docs/html/wear/preview/api-overview.jd
new file mode 100644
index 0000000..bf18c16
--- /dev/null
+++ b/docs/html/wear/preview/api-overview.jd
@@ -0,0 +1,124 @@
+page.title=Preview API Overview
+meta.tags="wear", "wear-preview"
+page.tags="wear"
+page.image=images/cards/card-n-apis_2x.png
+@jd:body
+
+
+
+
+<div id="qv-wrapper">
+<div id="qv">
+ <h2>Key developer features</h2>
+ <ol>
+ <ul style="list-style-type:none;">
+ <li><a href="#stand-alone">Stand Alone Devices</a>
+ <ol>
+ <li><a href="#wear-apk">Wear-Specific APKs</a></li>
+ <li><a href="#network">Network Access</a></li>
+ <li><a href="#auth">Authentication</a></li>
+ </ol>
+ </li>
+ <li><a href="#notify">Notifications and Interactions</a>
+ <ol>
+ <li><a href="#appoid">Appoids with Chat Templates</a></li>
+ <li><a href="#smart-replies">Smart Replies</a></li>
+ <li><a href="#remote-input">Remote Input</a></li>
+ <li><a href="#imf">Input Method Framework</a></li>
+ </ol>
+ </li>
+ <li><a href="#ui">User Interface Improvements</a>
+ <ol>
+ <li><a href="#complicatiosn">Complications</a></li>
+ <li><a href="#drawers">Navigation and Action Drawers</a></li>
+ <li><a href="#button-loc">Button Locations</a></li>
+ </ol>
+ </li>
+ </ol>
+</div>
+</div>
+
+
+
+<p>
+ The Android Wear Preview API is still in active development, but you can try
+ it now as part of the Wear 2.0 Developer Preview. The sections below
+ highlight some of the new features for Wear developers.
+</p>
+
+
+<h2 id="stand-alone">Stand Alone Devices</h2>
+
+<p>Description of developer theme</p>
+
+<h3 id="wear-apk">Wear-Specific APKs</h3>
+
+<p>Description of feature</p>
+
+<p>Sample implementation of feature</p>
+
+<h3 id="network">Network Access</h3>
+
+<p>Description of feature</p>
+
+<p>Sample implementation of feature</p>
+
+<h3 id="auth">Authentication</h3>
+
+<p>Description of feature</p>
+
+<p>Sample implementation of feature</p>
+
+
+
+<h2 id="notify">Notifications and Interactions</h2>
+
+<p>Description of developer theme</p>
+
+<h3 id="appoid">Appoids with Chat Templates</h3>
+
+<p>Description of feature</p>
+
+<p>Sample implementation of feature</p>
+
+<h3 id="smart-replies">Smart Replies</h3>
+
+<p>Description of feature</p>
+
+<p>Sample implementation of feature</p>
+
+<h3 id="remote-input">Remote Input</h3>
+
+<p>Description of feature</p>
+
+<p>Sample implementation of feature</p>
+
+<h3 id="imf">Input Method Framework</h3>
+
+<p>Description of feature</p>
+
+<p>Sample implementation of feature</p>
+
+
+
+<h2 id="ui">User Interface Improvements</h2>
+
+<p>Description of developer theme</p>
+
+<h3 id="complicatiosn">Complications</h3>
+
+<p>Description of feature</p>
+
+<p>Sample implementation of feature</p>
+
+<h3 id="drawers">Navigation and Action Drawers</h3>
+
+<p>Description of feature</p>
+
+<p>Sample implementation of feature</p>
+
+<h3 id="button-loc">Button Locations</h3>
+
+<p>Description of feature</p>
+
+<p>Sample implementation of feature</p>
diff --git a/docs/html/wear/preview/downloads.jd b/docs/html/wear/preview/downloads.jd
new file mode 100644
index 0000000..eea4f11
--- /dev/null
+++ b/docs/html/wear/preview/downloads.jd
@@ -0,0 +1,604 @@
+page.title=Download and Test with a Device
+meta.keywords="wear-preview"
+page.tags="wear-preview"
+page.image=images/cards/card-n-sdk_2x.png
+
+@jd:body
+<div style="position:relative; min-height:600px">
+
+ <div class="wrap" id="tos" style="position:absolute;display:none;width:inherit;">
+
+ <p class="sdk-terms-intro">Before downloading and installing components of
+ the Android Wear Preview SDK, you must agree to the following terms and
+ conditions.</p>
+
+ <h2 class="norule">Terms and Conditions</h2>
+
+ <div class="sdk-terms" onfocus="this.blur()" style="width:678px">
+This is the Android Wear SDK Preview License Agreement (the “License Agreement”).
+
+1. Introduction
+
+1.1 The Android Wear SDK Preview (referred to in the License Agreement as the “Preview” and specifically including the Android system files, packaged APIs, and Preview library files, if and when they are made available) is licensed to you subject to the terms of the License Agreement. The License Agreement forms a legally binding contract between you and Google in relation to your use of the Preview.
+
+1.2 "Android" means the Android software stack for devices, as made available under the Android Open Source Project, which is located at the following URL: http://source.android.com/, as updated from time to time.
+
+1.3 “Android-compatible” means any Android implemation that (i) complies with the Android Compatibility Definition document, which can be found at the Android compatibility website (http://source.android.com/compatibility) and which may be updated from time to time; and (ii) successfully passes the Android Compatibility Test Suite (CTS).
+
+1.4 "Google" means Google Inc., a Delaware corporation with principal place of business at 1600 Amphitheatre Parkway, Mountain View, CA 94043, United States.
+
+2. Accepting the License Agreement
+
+2.1 In order to use the Preview, you must first agree to the License Agreement. You may not use the Preview if you do not accept the License Agreement.
+
+2.2 By clicking to accept and/or using the Preview, you hereby agree to the terms of the License Agreement.
+
+2.3 You may not use the Preview and may not accept the License Agreement if you are a person barred from receiving the Preview under the laws of the United States or other countries including the country in which you are resident or from which you use the Preview.
+
+2.4 If you will use the Preview internally within your company or organization you agree to be bound by the License Agreement on behalf of your employer or other entity, and you represent and warrant that you have full legal authority to bind your employer or such entity to the License Agreement. If you do not have the requisite authority, you may not accept the License Agreement or use the Preview on behalf of your employer or other entity.
+
+3. Preview License from Google
+
+3.1 Subject to the terms of this License Agreement, Google grants you a limited, worldwide, royalty-free, non-assignable, non-exclusive, and non-sublicensable license to use the Preview solely to develop applications for compatible implementations of Android.
+
+3.2 You may not use this Preview to develop applications for other platforms (including non-compatible implementations of Android) or to develop another SDK. You are of course free to develop applications for other platforms, including non-compatible implementations of Android, provided that this Preview is not used for that purpose.
+
+3.3 You agree that Google or third parties owns all legal right, title and interest in and to the Preview, including any Intellectual Property Rights that subsist in the Preview. "Intellectual Property Rights" means any and all rights under patent law, copyright law, trade secret law, trademark law, and any and all other proprietary rights. Google reserves all rights not expressly granted to you.
+
+3.4 You may not use the Preview for any purpose not expressly permitted by the License Agreement. Except to the extent required by applicable third party licenses, you may not: (a) copy (except for backup purposes), modify, adapt, redistribute, decompile, reverse engineer, disassemble, or create derivative works of the Preview or any part of the Preview; or (b) load any part of the Preview onto a mobile handset or any other hardware device except a personal computer, combine any part of the Preview with other software, or distribute any software or device incorporating a part of the Preview.
+
+3.5 Use, reproduction and distribution of components of the Preview licensed under an open source software license are governed solely by the terms of that open source software license and not the License Agreement. You agree to remain a licensee in good standing in regard to such open source software licenses under all the rights granted and to refrain from any actions that may terminate, suspend, or breach such rights.
+
+3.6 You agree that the form and nature of the Preview that Google provides may change without prior notice to you and that future versions of the Preview may be incompatible with applications developed on previous versions of the Preview. You agree that Google may stop (permanently or temporarily) providing the Preview (or any features within the Preview) to you or to users generally at Google's sole discretion, without prior notice to you.
+
+3.7 Nothing in the License Agreement gives you a right to use any of Google's trade names, trademarks, service marks, logos, domain names, or other distinctive brand features.
+
+3.8 You agree that you will not remove, obscure, or alter any proprietary rights notices (including copyright and trademark notices) that may be affixed to or contained within the Preview.
+
+4. Use of the Preview by You
+
+4.1 Google agrees that nothing in the License Agreement gives Google any right, title or interest from you (or your licensors) under the License Agreement in or to any software applications that you develop using the Preview, including any intellectual property rights that subsist in those applications.
+
+4.2 You agree to use the Preview and write applications only for purposes that are permitted by (a) the License Agreement, and (b) any applicable law, regulation or generally accepted practices or guidelines in the relevant jurisdictions (including any laws regarding the export of data or software to and from the United States or other relevant countries).
+
+4.3 You agree that if you use the Preview to develop applications, you will protect the privacy and legal rights of users. If users provide you with user names, passwords, or other login information or personal information, you must make the users aware that the information will be available to your application, and you must provide legally adequate privacy notice and protection for those users. If your application stores personal or sensitive information provided by users, it must do so securely. If users provide you with Google Account information, your application may only use that information to access the user's Google Account when, and for the limited purposes for which, each user has given you permission to do so.
+
+4.4 You agree that you will not engage in any activity with the Preview, including the development or distribution of an application, that interferes with, disrupts, damages, or accesses in an unauthorized manner the servers, networks, or other properties or services of Google or any third party.
+
+4.5 You agree that you are solely responsible for (and that Google has no responsibility to you or to any third party for) any data, content, or resources that you create, transmit or display through Android and/or applications for Android, and for the consequences of your actions (including any loss or damage which Google may suffer) by doing so.
+
+4.6 You agree that you are solely responsible for (and that Google has no responsibility to you or to any third party for) any breach of your obligations under the License Agreement, any applicable third party contract or Terms of Service, or any applicable law or regulation, and for the consequences (including any loss or damage which Google or any third party may suffer) of any such breach.
+
+4.7 The Preview is in development, and your testing and feedback are an important part of the development process. By using the Preview, you acknowledge that implementation of some features are still under development and that you should not rely on the Preview having the full functionality of a stable release. You agree not to publicly distribute or ship any application using this Preview as this Preview will no longer be supported after the official Android SDK is released.
+
+5. Your Developer Credentials
+
+5.1 You agree that you are responsible for maintaining the confidentiality of any developer credentials that may be issued to you by Google or which you may choose yourself and that you will be solely responsible for all applications that are developed under your developer credentials.
+
+6. Privacy and Information
+
+6.1 In order to continually innovate and improve the Preview, Google may collect certain usage statistics from the software including but not limited to a unique identifier, associated IP address, version number of the software, and information on which tools and/or services in the Preview are being used and how they are being used. Before any of this information is collected, the Preview will notify you and seek your consent. If you withhold consent, the information will not be collected.
+
+6.2 The data collected is examined in the aggregate to improve the Preview and is maintained in accordance with Google's Privacy Policy located at http://www.google.com/policies/privacy/.
+
+7. Third Party Applications
+
+7.1 If you use the Preview to run applications developed by a third party or that access data, content or resources provided by a third party, you agree that Google is not responsible for those applications, data, content, or resources. You understand that all data, content or resources which you may access through such third party applications are the sole responsibility of the person from which they originated and that Google is not liable for any loss or damage that you may experience as a result of the use or access of any of those third party applications, data, content, or resources.
+
+7.2 You should be aware the data, content, and resources presented to you through such a third party application may be protected by intellectual property rights which are owned by the providers (or by other persons or companies on their behalf). You may not modify, rent, lease, loan, sell, distribute or create derivative works based on these data, content, or resources (either in whole or in part) unless you have been specifically given permission to do so by the relevant owners.
+
+7.3 You acknowledge that your use of such third party applications, data, content, or resources may be subject to separate terms between you and the relevant third party.
+
+8. Using Google APIs
+
+8.1 Google APIs
+
+8.1.1 If you use any API to retrieve data from Google, you acknowledge that the data may be protected by intellectual property rights which are owned by Google or those parties that provide the data (or by other persons or companies on their behalf). Your use of any such API may be subject to additional Terms of Service. You may not modify, rent, lease, loan, sell, distribute or create derivative works based on this data (either in whole or in part) unless allowed by the relevant Terms of Service.
+
+8.1.2 If you use any API to retrieve a user's data from Google, you acknowledge and agree that you shall retrieve data only with the user's explicit consent and only when, and for the limited purposes for which, the user has given you permission to do so.
+
+9. Terminating the License Agreement
+
+9.1 the License Agreement will continue to apply until terminated by either you or Google as set out below.
+
+9.2 If you want to terminate the License Agreement, you may do so by ceasing your use of the Preview and any relevant developer credentials.
+
+9.3 Google may at any time, terminate the License Agreement, with or without cause, upon notice to you.
+
+9.4 The License Agreement will automatically terminate without notice or other action upon the earlier of:
+(A) when Google ceases to provide the Preview or certain parts of the Preview to users in the country in which you are resident or from which you use the service; and
+(B) Google issues a final release version of the Android SDK.
+
+9.5 When the License Agreement is terminated, the license granted to you in the License Agreement will terminate, you will immediately cease all use of the Preview, and the provisions of paragraphs 10, 11, 12 and 14 shall survive indefinitely.
+
+10. DISCLAIMERS
+
+10.1 YOU EXPRESSLY UNDERSTAND AND AGREE THAT YOUR USE OF THE PREVIEW IS AT YOUR SOLE RISK AND THAT THE PREVIEW IS PROVIDED "AS IS" AND "AS AVAILABLE" WITHOUT WARRANTY OF ANY KIND FROM GOOGLE.
+
+10.2 YOUR USE OF THE PREVIEW AND ANY MATERIAL DOWNLOADED OR OTHERWISE OBTAINED THROUGH THE USE OF THE PREVIEW IS AT YOUR OWN DISCRETION AND RISK AND YOU ARE SOLELY RESPONSIBLE FOR ANY DAMAGE TO YOUR COMPUTER SYSTEM OR OTHER DEVICE OR LOSS OF DATA THAT RESULTS FROM SUCH USE. WITHOUT LIMITING THE FOREGOING, YOU UNDERSTAND THAT THE PREVIEW IS NOT A STABLE RELEASE AND MAY CONTAIN ERRORS, DEFECTS AND SECURITY VULNERABILITIES THAT CAN RESULT IN SIGNIFICANT DAMAGE, INCLUDING THE COMPLETE, IRRECOVERABLE LOSS OF USE OF YOUR COMPUTER SYSTEM OR OTHER DEVICE.
+
+10.3 GOOGLE FURTHER EXPRESSLY DISCLAIMS ALL WARRANTIES AND CONDITIONS OF ANY KIND, WHETHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO THE IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
+
+11. LIMITATION OF LIABILITY
+
+11.1 YOU EXPRESSLY UNDERSTAND AND AGREE THAT GOOGLE, ITS SUBSIDIARIES AND AFFILIATES, AND ITS LICENSORS SHALL NOT BE LIABLE TO YOU UNDER ANY THEORY OF LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL OR EXEMPLARY DAMAGES THAT MAY BE INCURRED BY YOU, INCLUDING ANY LOSS OF DATA, WHETHER OR NOT GOOGLE OR ITS REPRESENTATIVES HAVE BEEN ADVISED OF OR SHOULD HAVE BEEN AWARE OF THE POSSIBILITY OF ANY SUCH LOSSES ARISING.
+
+12. Indemnification
+
+12.1 To the maximum extent permitted by law, you agree to defend, indemnify and hold harmless Google, its affiliates and their respective directors, officers, employees and agents from and against any and all claims, actions, suits or proceedings, as well as any and all losses, liabilities, damages, costs and expenses (including reasonable attorneys’ fees) arising out of or accruing from (a) your use of the Preview, (b) any application you develop on the Preview that infringes any Intellectual Property Rights of any person or defames any person or violates their rights of publicity or privacy, and (c) any non-compliance by you of the License Agreement.
+
+13. Changes to the License Agreement
+
+13.1 Google may make changes to the License Agreement as it distributes new versions of the Preview. When these changes are made, Google will make a new version of the License Agreement available on the website where the Preview is made available.
+
+14. General Legal Terms
+
+14.1 the License Agreement constitutes the whole legal agreement between you and Google and governs your use of the Preview (excluding any services which Google may provide to you under a separate written agreement), and completely replaces any prior agreements between you and Google in relation to the Preview.
+
+14.2 You agree that if Google does not exercise or enforce any legal right or remedy which is contained in the License Agreement (or which Google has the benefit of under any applicable law), this will not be taken to be a formal waiver of Google's rights and that those rights or remedies will still be available to Google.
+
+14.3 If any court of law, having the jurisdiction to decide on this matter, rules that any provision of the License Agreement is invalid, then that provision will be removed from the License Agreement without affecting the rest of the License Agreement. The remaining provisions of the License Agreement will continue to be valid and enforceable.
+
+14.4 You acknowledge and agree that each member of the group of companies of which Google is the parent shall be third party beneficiaries to the License Agreement and that such other companies shall be entitled to directly enforce, and rely upon, any provision of the License Agreement that confers a benefit on (or rights in favor of) them. Other than this, no other person or company shall be third party beneficiaries to the License Agreement.
+
+14.5 EXPORT RESTRICTIONS. THE PREVIEW IS SUBJECT TO UNITED STATES EXPORT LAWS AND REGULATIONS. YOU MUST COMPLY WITH ALL DOMESTIC AND INTERNATIONAL EXPORT LAWS AND REGULATIONS THAT APPLY TO THE PREVIEW. THESE LAWS INCLUDE RESTRICTIONS ON DESTINATIONS, END USERS AND END USE.
+
+14.6 The License Agreement may not be assigned or transferred by you without the prior written approval of Google, and any attempted assignment without such approval will be void. You shall not delegate your responsibilities or obligations under the License Agreement without the prior written approval of Google.
+
+14.7 The License Agreement, and your relationship with Google under the License Agreement, shall be governed by the laws of the State of California without regard to its conflict of laws provisions. You and Google agree to submit to the exclusive jurisdiction of the courts located within the county of Santa Clara, California to resolve any legal matter arising from the License Agreement. Notwithstanding this, you agree that Google shall still be allowed to apply for injunctive remedies (or an equivalent type of urgent legal relief) in any jurisdiction.
+ </div><!-- sdk terms -->
+
+
+
+ <div id="sdk-terms-form">
+ <p>
+ <input id="agree" type="checkbox" name="agree" value="1" onclick="onAgreeChecked()" />
+ <label id="agreeLabel" for="agree">I have read and agree with the above terms and conditions</label>
+ </p>
+ <p><a href="" class="button disabled" id="downloadForRealz" onclick="return onDownloadForRealz(this);"></a></p>
+ </div>
+
+
+ </div><!-- end TOS -->
+
+
+ <div id="landing">
+
+ <div id="qv-wrapper">
+ <div id="qv">
+ <ol>
+ <li>
+ <a href="#set_up_a_watch">Set Up a Watch</a>
+ </li>
+
+ <li>
+ <a href="#set_up_an_emulator">Set Up an Emulator</a>
+ </li>
+ </ol>
+ </div>
+ </div>
+
+ <p>
+ You can run and test your app with the Android Wear 2.0 Developer Preview
+ in either of these ways:
+ </p>
+
+ <ul>
+ <li>Install Android Wear 2.0 on a supported watch, or
+ </li>
+
+ <li>Set up an emulator that is running Android Wear 2.0
+ </li>
+ </ul>
+
+ <p>
+ If you want an environment for basic <strong>compatibility
+ testing</strong> of your app, you can use your current APK and a
+ supported watch or an emulator. As described below, you don't necessarily
+ need to update your full development environment to do basic testing.
+ </p>
+
+ <p>
+ However, if you want to <strong>modify</strong> your app to target
+ Android Wear 2.0 or use new APIs, you need to update your development
+ environment. See <a href="{@docRoot}wear/preview/start.html">Get Started
+ with the Android Wear 2.0 Preview</a>.
+ </p>
+
+ <h2 id="set_up_a_watch">
+ Set Up a Watch
+ </h2>
+
+ <p>
+ You can download a system image and manually flash it to a matching
+ watch. See the table below to download the system image for your test
+ watch.
+ </p>
+
+ <p>
+ Manually flashing a watch is useful if you need precise control over the
+ test environment or need to reinstall frequently, such as for automated
+ testing.
+ </p>
+
+ <p>
+ Installing a system image on a watch <strong>removes all data from the
+ watch</strong>, so you should back up your data first.
+ </p>
+
+ <h3 id="preview_system_images">
+ Preview system images
+ </h3>
+
+ <p>
+ The preview includes system images for testing your app. Based on your
+ device, you can download a preview system image from the following tables
+ and flash it to the corresponding device.
+ </p>
+
+ <h4 id="preview_image_for_lge_watch_urbane_2nd_edition">
+ Preview image for LGE Watch Urbane 2nd Edition
+ </h4>
+
+ <p>
+ <strong>Please note the following:</strong>
+ Flashing your device will
+ require unlocking the bootloader which may
+ void the device's warranty--proceed at your own risk.
+ </p>
+
+ <table>
+ <tr>
+ <th scope="col">
+ Type of LGE Watch Urbane 2nd Edition image
+ </th>
+ <th scope="col">
+ Download/Checksums
+ </th>
+ </tr>
+ <tr id="download-3-placeholder">
+ <td>
+ Preview image for testing
+ </td>
+ <td><a href="#top" onclick="onDownload(this)">download-3-placeholder.tgz</a><br>
+ MD5: [string]<br>
+ SHA-1: [string]
+ </td>
+ </tr>
+ <tr id="download-4-placeholder">
+ <td>
+ Non-preview image (for after testing)
+ </td>
+ <td><a href="#top" onclick="onDownload(this)">download-4-placeholder.tgz</a><br>
+ MD5: [string]<br>
+ SHA-1: [string]
+ </td>
+ </tr>
+ </table>
+
+ <h4 id="preview_image_for_huawei_watch">
+ Preview image for Huawei Watch
+ </h4>
+
+ <p>
+ <strong>Please note the following:</strong>
+ Flashing your device will require unlocking
+ the bootloader which
+ shall void the device's warranty--proceed at your own risk.
+ </p>
+
+ <table>
+ <tr>
+ <th scope="col">
+ Type of Huawei Watch image
+ </th>
+ <th scope="col">
+ Download/Checksums
+ </th>
+ </tr>
+ <tr id="download-1-placeholder">
+ <td>
+ Preview image for testing
+ </td>
+ <td><a href="#top" onclick="onDownload(this)">download-1-placeholder.tgz</a><br>
+ MD5: [string]<br>
+ SHA-1: [string]
+ </td>
+ </tr>
+ <tr id="download-2-placeholder">
+ <td>
+ Non-preview image (for after testing)
+ </td>
+ <td><a href="#top" onclick="onDownload(this)">download-2-placeholder.tgz</a><br>
+ MD5: [string]<br>
+ SHA-1: [string]
+ </td>
+ </tr>
+ </table>
+
+ <h3 id="flash_a_watch">
+ Flash a watch
+ </h3>
+
+ <p>
+ The steps for flashing an image to a watch are similar to the <a href=
+ "https://developers.google.com/android/nexus/images">steps provided for
+ flashing to a phone</a>. After you <strong>back up your watch
+ data</strong>, use steps in this section to flash the image to the
+ <strong>specific watch</strong> that matches the image (e.g., you must
+ use an LGE Watch Urbane 2nd Edition for the corresponding image).
+ </p>
+
+ <h4 id="set_up_the_watch_to_be_flashed">
+ Set up the watch to be flashed
+ </h4>
+
+ <p>
+ On the watch, enable the Developer Options menu and ADB debugging as
+ follows:
+ </p>
+
+ <ol>
+ <li>Open the Settings menu on the watch.
+ </li>
+
+ <li>Scroll to the bottom of the menu. If no <strong>Developer
+ Options</strong> item is provided, tap <strong>About</strong>.
+ </li>
+
+ <li>Tap the build number 7 times.
+ </li>
+
+ <li>From the Settings menu, tap the <strong>Developer Options</strong>
+ item.
+ </li>
+
+ <li>Enable ADB debugging.
+ </li>
+ </ol>
+
+ <h4 id="confirm_installation_of_the_fastboot_tool">
+ Confirm installation of the fastboot tool
+ </h4>
+
+ <p>
+ To flash a device using one of the <a href=
+ "#preview_system_images">system images</a>, confirm that you have the
+ <code>fastboot</code> tool in the <code>platform-tools/</code> directory
+ of the <a href="https://developer.android.com/sdk">Android SDK</a>. Be
+ sure that you have the latest version of the <strong>Android SDK
+ Platform-tools</strong> from the <a href=
+ "{@docRoot}tools/help/sdk-manager.html">SDK Manager</a>.
+ </p>
+
+ <p>
+ After you confirm that you have the <code>fastboot</code> tool, add the
+ tool to your PATH environment variable so the tool can be found when you
+ flash the watch.
+ </p>
+
+ <h4 id="transfer_the_image_to_the_watch">
+ Transfer the image to the watch
+ </h4>
+
+ <p>
+ To download a preview image and flash it to the watch:
+ </p>
+
+ <ol>
+ <li>Download and unzip the appropriate system image from the "Preview
+ system image" column in the <a href="#preview_system_images">table
+ above</a>.
+ </li>
+
+ <li>Attach the watch charger to the watch and plug the USB cord (from the
+ charger) into your computer.
+ </li>
+
+ <li>Use the following <a href="{@docRoot}tools/help/adb.html">adb
+ command</a> to confirm that the watch is available for flashing:
+ <code>adb devices</code>
+ </li>
+
+ <li>Use the following adb command to start the device in fastboot mode:
+ <code>adb reboot bootloader</code>
+ </li>
+
+ <li>If necessary, use <strong>one</strong> of following two commands to
+ unlock the device's bootloader. This step <strong>erases all data on the
+ device</strong>: <code>fastboot flashing unlock</code> or, for some
+ devices, <code>fastboot oem unlock</code>
+ </li>
+
+ <li>Navigate to the directory where you unzipped the system image in Step
+ 1.
+ </li>
+
+ <li>Execute the <code>flash-all</code> script by typing
+ <code>flash-all.sh</code> or, in the case of Windows,
+ <code>flash-all.bat</code>.
+ </li>
+ </ol>
+
+ <p>
+ After the script finishes, your watch reboots. Pair the watch with a
+ phone or tablet. The preview now is available for testing on the watch.
+ Before installing an app, enable the Developer Options menu, and ADB
+ debugging, on the watch as follows:
+ </p>
+
+ <ol>
+ <li>Open the Settings menu (on the watch).
+ </li>
+
+ <li>Scroll to the bottom of the menu and tap <strong>About</strong>.
+ </li>
+
+ <li>Tap the build number 7 times.
+ </li>
+
+ <li>From the Settings menu, tap the <strong>Developer Options</strong>
+ item.
+ </li>
+
+ <li>Enable ADB debugging.
+ </li>
+
+ <li>Connect the watch to your computer and tap <strong>Always allow from
+ this computer</strong>.
+ </li>
+ </ol>
+
+ <p>
+ Your watch is ready for you to <a href=
+ "{@docRoot}training/wearables/apps/creating.html#Install">install and run
+ your app</a>:
+ </p>
+
+ <ol>
+ <li>Open your app in Android Studio.
+ </li>
+
+ <li>Select <strong>wear</strong> from the Run/Debug configuration
+ drop-down menu.
+ </li>
+
+ <li>Click the Play button.
+ </li>
+
+ <li>In the Select Deployment Target box, click your device.
+ </li>
+ </ol>
+
+ <p>
+ After your app is installed on the watch, you are prompted to start the
+ app on the watch.
+ </p>
+
+ <p>
+ When testing is completed, follow the steps for <a href=
+ "#uninstall_the_preview_from_a_watch">uninstalling the preview</a>.
+ </p>
+
+ <h3 id="uninstall_the_preview_from_a_watch">
+ Uninstall the preview from a watch
+ </h3>
+
+ <p>
+ When testing with the preview is done, restore the watch as follows:
+ </p>
+
+ <ol>
+ <li>Download and unzip the appropriate system image from the "Non-preview
+ system image" column in the <a href="#preview_system_images">table
+ above</a>.
+ </li>
+
+ <li>Manually flash the image to the watch using steps similar to those in
+ <a href="#transfer_the_image_to_the_watch">Transfer the image to the
+ watch</a>, except that you flash the <strong>non-preview</strong> image
+ to the watch.
+ </li>
+ </ol>
+
+ <p>
+ <strong>Note</strong>: Removing a preview system image requires a full
+ device reset and removes all user data on the device.
+ </p>
+
+ <h2 id="set_up_an_emulator">
+ Set Up an Emulator
+ </h2>
+
+ <p>
+ To test with the Android Emulator, create a virtual device in Android
+ Studio as follows:
+ </p>
+
+ <ol>
+ <li>Open the AVD Manager by selecting <strong>Tools > Android > AVD
+ Manager</strong>.
+ </li>
+
+ <li>Click <strong>Create Virtual Device</strong>.
+ </li>
+
+ <li>In the <strong>Category</strong> pane, select Wear, choose a name
+ (such as Android Wear Round), and click <strong>Next</strong>.
+ </li>
+
+ <li>Select an <strong>N</strong> image to download. The images may be on
+ the <strong>x86</strong> tab instead of the <strong>Recommended</strong>
+ tab, until installed. For example, select the image with the
+ <strong>Release Name</strong> of N, the <strong>API Level</strong> of N,
+ and the <strong>Target</strong> of "Android 6.X (with Android Wear)".
+ When the download and installation are complete, click
+ <strong>Finish</strong> and then click <strong>Next</strong>.
+ </li>
+
+ <li>Verify the configuration of the Android Virtual Device (AVD) and
+ click <strong>Finish</strong>.
+ </li>
+ </ol>
+
+ <p>
+ You can now test an application in the <a href=
+ "{@docRoot}tools/devices/emulator.html">Android Emulator</a>. For more
+ information about using virtual devices, see <a href=
+ "{@docRoot}tools/devices/managing-avds.html">Managing AVDs with the AVD
+ Manager</a>.
+ </p>
+ </div><!-- landing -->
+
+</div><!-- relative wrapper -->
+
+
+<script>
+ var urlRoot = "http://storage.googleapis.com/androiddevelopers/shareables/wear/preview/";
+ function onDownload(link) {
+
+ $("#downloadForRealz").html("Download " + $(link).text());
+ $("#downloadForRealz").attr('href', urlRoot + $(link).text());
+
+ $("#tos").fadeIn('fast');
+ $("#landing").fadeOut('fast');
+
+ return true;
+ }
+
+
+ function onAgreeChecked() {
+ /* verify that the TOS is agreed */
+ if ($("input#agree").is(":checked")) {
+ /* reveal the download button */
+ $("a#downloadForRealz").removeClass('disabled');
+ } else {
+ $("a#downloadForRealz").addClass('disabled');
+ }
+ }
+
+ function onDownloadForRealz(link) {
+ if ($("input#agree").is(':checked')) {
+ /*
+ $("#tos").fadeOut('fast');
+ $("#landing").fadeIn('fast');
+ */
+
+ ga('send', 'event', 'M Preview', 'System Image', $("#downloadForRealz").html());
+
+ /*
+ location.hash = "";
+ */
+ return true;
+ } else {
+ return false;
+ }
+ }
+
+ $(window).hashchange( function(){
+ if (location.hash == "") {
+ location.reload();
+ }
+ });
+
+</script>
\ No newline at end of file
diff --git a/docs/html/wear/preview/features/bridger.jd b/docs/html/wear/preview/features/bridger.jd
new file mode 100644
index 0000000..4f0d76b
--- /dev/null
+++ b/docs/html/wear/preview/features/bridger.jd
@@ -0,0 +1,147 @@
+page.title=Bridging Mode for Notifications
+meta.keywords="wear-preview"
+page.tags="wear-preview"
+page.image=images/cards/card-n-sdk_2x.png
+@jd:body
+
+ <div id="qv-wrapper">
+ <div id="qv">
+ <ol>
+ <li>
+ <a href=
+ "#preventing_bridging_with_the_bridging_mode_feature">Preventing
+ Bridging with the Bridging Mode Feature</a>
+ </li>
+
+ <li>
+ <a href=
+ "#using_a_dismissal_id_to_sync_notification_dismissals">Using a
+ Dismissal ID to Sync Notification Dismissals</a>
+ </li>
+ </ol>
+ </div>
+ </div>
+
+ <p>
+ By default, notifications <a href=
+ "{@docRoot}training/wearables/notifications/index.html">are bridged
+ (shared)</a> from an app on a companion phone to the watch. Standalone
+ Android Wear apps are planned for Android Wear 2.0. Therefore, a phone
+ app and a standalone watch app may be sources of the same notifications.
+ The Android Wear 2.0 Preview includes a Bridging mode feature to handle
+ this problem of duplicate notifications.
+ </p>
+
+ <p>
+ With the Android Wear 2.0 Preview, developers can plan to change the
+ behavior of notifications with the following:
+ </p>
+
+ <ul>
+ <li>Specifying in the standalone app's Android manifest file that
+ notifications from the corresponding phone app should <strong>not be
+ bridged</strong> to the watch
+ </li>
+
+ <li>Setting a dismissal ID so notification dismissals are synced across
+ devices
+ </li>
+ </ul>
+
+ <h2 id="preventing_bridging_with_the_bridging_mode_feature">
+ Preventing Bridging with the Bridging Mode Feature
+ </h2>
+
+ <p>
+ To prevent bridging of notifications from a phone app, you can use a
+ entry in the manifest file of the watch app (e.g. the standalone watch
+ app), as follows:
+ </p>
+
+ <pre>
+com.google.android.wearable.notificationBridgeMode
+</pre>
+ <p>
+ Setting that entry to <code>NO_BRIDGING</code> will prevent bridging:
+ </p>
+
+ <pre>
+<meta-data android:name="com.google.android.wearable.notificationBridgeMode"
+ android:value="NO_BRIDGING" />
+</pre>
+ <p>
+ The default bridging behavior occurs if you do not include the entry or
+ if you specify a value of <code>BRIDGING</code> instead of
+ <code>NO_BRIDGING</code>.
+ </p>
+
+ <h3 id="existing_method_of_preventing_bridging">
+ Existing method of preventing bridging
+ </h3>
+
+ <p>
+ An existing way to prevent bridging is with the
+ <code>Notification.Builder</code> class; specify <code>true</code> in the
+ <a href=
+ "{@docRoot}reference/android/app/Notification.Builder.html#setLocalOnly(boolean)">
+ setLocalOnly</a> method.
+ </p>
+
+ <p>
+ However, this way to prevent bridging may not be preferable. For example,
+ if a user installs a phone app but not the corresponding watch app, the
+ <code>setLocalOnly</code> method could prevent the bridging of helpful
+ notifications. Additionally, users may have multiple paired watches and
+ the watch app may not be installed on all of them.
+ </p>
+
+ <p>
+ Thus, if bridging should be prevented <strong>when</strong> the watch app
+ is installed, use the <a href=
+ "#preventing_bridging_with_the_bridging_mode_feature">Bridging mode
+ feature</a>.
+ </p>
+
+ <h2 id="using_a_dismissal_id_to_sync_notification_dismissals">
+ Using a Dismissal ID to Sync Notification Dismissals
+ </h2>
+
+ <p>
+ If you prevent bridging with the Bridging mode feature, dismissals
+ (cancellations) of notifications are not synced across a user's devices.
+ However, the following methods of the <a href=
+ "{@docRoot}reference/android/support/v4/app/NotificationCompat.WearableExtender.html">
+ NotificationCompat.WearableExtender</a> class enable you to use dismissal
+ IDs:
+ </p>
+
+ <pre>
+public WearableExtender setDismissalId(String dismissalId)
+public String getDismissalId()
+</pre>
+ <p>
+ To enable a dismissal to be synced, use the <code>setDismissalId()</code>
+ method. For each notification, pass a globally unique ID, as a string,
+ when you call the <code>setDismissalId()</code> method. When the
+ notification is dismissed, all other notifications with the same
+ dismissal ID are dismissed on the watch(es) and on the companion phone.
+ To retrieve a dismissal ID, use <code>getDismissalId()</code>.
+ </p>
+
+ <p>
+ In the following example, syncing of dismissals is enabled because a
+ globally unique ID is specified for a new notification:
+ </p>
+
+ <pre>
+NotificationCompat.WearableExtender wearableExtender =
+new NotificationCompat.WearableExtender().setDismissalId(“abc123”);
+Notification notification = new NotificationCompat.Builder(context)
+<set other fields>
+.extend(wearableExtender)
+.build();
+</pre>
+ <p>
+ Dismissal IDs work if a watch is paired to an Android phone, but not if a
+ watch is paired to an iPhone.
+ </p>
diff --git a/docs/html/wear/preview/features/complications.jd b/docs/html/wear/preview/features/complications.jd
new file mode 100644
index 0000000..155f733
--- /dev/null
+++ b/docs/html/wear/preview/features/complications.jd
@@ -0,0 +1,797 @@
+page.title=Watch Face Complications
+meta.keywords="wear-preview"
+page.tags="wear-preview"
+page.image=images/cards/card-n-sdk_2x.png
+
+@jd:body
+
+ <div id="qv-wrapper">
+ <div id="qv">
+ <ol>
+ <li>
+ <a href=
+ "#adding_complications_to_a_watch_face">Adding Complications to a Watch Face</a>
+ </li>
+ <li>
+ <a href=
+ "#exposing_data_to_complications">Exposing Data to Complications</a>
+ </li>
+ <li>
+ <a href=
+ "#using_complication_types">Using Complication Types</a>
+ </li>
+ <li>
+ <a href=
+ "#using_fields_for_complication_data">Using Fields for Complication Data</a>
+ </li>
+ <li>
+ <a href=
+ "#api_additions">API Additions</a>
+ </li>
+ </ol>
+ </div>
+ </div>
+
+ <p>
+ A complication is a feature of a watch face <a href=
+ "https://en.wikipedia.org/wiki/Complication_(horology)">beyond hours and
+ minutes</a>. For example, a battery indicator is a complication.
+ </p>
+
+ <p>
+ The Complications API is for both watch faces and data provider apps.
+ </p>
+
+ <p>
+ Watch faces can display extra information without needing code for
+ getting the underlying data. Data providers can supply data (such as
+ battery level, weather, or step-count data) to any watch face using the
+ API.
+ </p>
+
+ <p>
+ For creating or modifying watch faces, see <a href=
+ "#adding_complications_to_a_watch_face">Adding complications to a watch
+ face</a>.
+ </p>
+
+ <p>
+ For writing apps that provide data to watch faces, see <a href=
+ "#exposing_data_to_complications">Exposing data to complications</a>.
+ </p>
+
+ <p>
+ Along with reviewing this page, download the Android Wear 2.0 Preview
+ Reference and review the <a href="#api_additions">API additions</a> in
+ the Javadoc for complications.
+ </p>
+
+ <p>
+ Apps that provide data to watch faces for complications are called
+ "complication data providers." These apps lack control over how their
+ data is rendered. The consuming watch faces are responsible for drawing
+ the complications.
+ </p>
+
+ <p>
+ As indicated in the diagram below, Android Wear mediates the flow of data
+ from providers to watch faces.
+ </p>
+
+ <img src="../images/complications-data-flow.png" width="" alt="Complications data flow" title=
+ "Complications data flow">
+
+ <p>
+ Through this process, watch faces can receive complication data of
+ <a href="#using_complication_types">various types</a> (e.g. small text
+ data or icon data) and then display it.
+ </p>
+
+ <h2 id="adding_complications_to_a_watch_face">
+ Adding Complications to a Watch Face
+ </h2>
+
+ <p>
+ Watch face developers can receive complication data and enable users to
+ select providers for that data. Additionally, Android Wear provides a
+ <a href="#allowing_users_to_choose_data_providers">user interface for
+ data source selection</a>.
+ </p>
+
+ <h3 id="receiving_data_and_rendering_complications">
+ Receiving data and rendering complications
+ </h3>
+
+ <p>
+ To start receiving complication data, a watch face calls
+ <code>setActiveComplications</code> within the
+ <code>WatchFaceService.Engine</code> class with a list of watch face
+ complication IDs. A watch face creates these IDs to uniquely identify
+ slots on the watch face where complications can appear, and passes them
+ to the <code>createProviderChooserIntent</code> method (of the
+ <code>ProviderChooserIntent</code> class) to allow the user to decide
+ which complication should go in which slot.
+ </p>
+
+ <p>
+ Complication data is delivered via the
+ <code>onComplicationDataUpdate</code> (of
+ <code>WatchFaceService.Engine</code>) callback.
+ </p>
+
+ <p>
+ The watch face may render the data as desired as long as the expected
+ fields are represented; the required fields should always be included and
+ the data should be represented in some way. Depending on the type, some
+ of the optional fields should also be included (see the Notes column in
+ the <a href="#types_and_fields">table</a> below).
+ </p>
+
+ <p>
+ We provide design guidelines for our style, as a suggestion for standard
+ complications, but developers can use their own styles or incorporate the
+ data into the watch face in different ways.
+ </p>
+
+ <h3 id="allowing_users_to_choose_data_providers">
+ Allowing users to choose data providers
+ </h3>
+
+ <p>
+ Android Wear provides a user interface (via an Activity) that enables
+ users to choose providers for a particular complication. Watch faces can
+ call the <code>createProviderChooserIntent</code> method to obtain an
+ intent that can be used to show the chooser interface.
+ </p>
+
+ <p>
+ This intent must be used with <code>startActivityForResult</code>. When a
+ watch face calls <code>createProviderChooserIntent</code>, the watch face
+ supplies a watch face complication ID and a list of supported types. The
+ types should be listed in order of preference, usually with types
+ offering more information, such as ranged value, given higher preference.
+ </p>
+
+ <p>
+ When the user selects a data provider, the configuration is saved
+ automatically; nothing more is required from the watch face.
+ </p>
+
+ <h3 id="user_interactions_with_complications">
+ User interactions with complications
+ </h3>
+
+ <p>
+ Providers can specify an action that occurs if the user taps on a
+ complication, so it should be possible for most complications to be
+ tappable. This action will be specified as a <code>PendingIntent</code>
+ included in the <code>ComplicationData</code> object. The watch face is
+ responsible for detecting taps on complications, and should fire the
+ pending intent when a tap occurs.
+ </p>
+
+ <p>
+ It may be infeasible to make some complications tappable (e.g., in the
+ case of a complication that fills the entire background of the watch
+ face), but it is expected that watch faces accept taps on complications
+ where possible.
+ </p>
+
+ <h2 id="exposing_data_to_complications">
+ Exposing Data to Complications
+ </h2>
+
+ <p>
+ A complication data provider is a service that extends
+ <code>ComplicationProviderService</code>. To respond to update requests
+ from the system, your data provider must implement the
+ <code>onComplicationUpdate</code> method of the
+ <code>ComplicationProviderService</code> class. This method will be
+ called when the system wants data from your provider - this could be when
+ a complication using your provider becomes active, or when a fixed amount
+ of time has passed. A <code>ComplicationManager</code> object is passed
+ as a parameter to the <code>onComplicationUpdate</code> method, and can
+ be used to send data back to the system.
+ </p>
+
+ <p>
+ In your app's manifest, declare the service and add an intent filter for
+ the following:
+ </p>
+
+ <pre>
+android.support.wearable.complications.ACTION_COMPLICATION_UPDATE_REQUEST
+</pre>
+ <p>
+ The service's manifest entry should also include an
+ <code>android:icon</code> attribute. The provided icon should be a
+ single-color white icon. This icon should represent the provider and will
+ be shown in the provider chooser.
+ </p>
+
+ <p>
+ Include metadata to specify the supported types, update period, and
+ configuration action, if required; for details, download the Android Wear
+ 2.0 Preview Reference and see the keys listed for the
+ <code>ComplicationProviderService</code> class (in the Javadoc).
+ </p>
+
+ <h3 id="update_period">
+ Update period
+ </h3>
+
+ <p>
+ Your provider can specify an update period using the following metadata
+ key in the manifest:
+ </p>
+
+ <pre>
+android.support.wearable.complications.UPDATE_PERIOD_SECONDS
+</pre>
+ <p>
+ This should be set to as long a time as possible, as updating too
+ frequently may impact battery life. Note that update requests are not
+ guaranteed to be sent with this frequency. The system does apply a
+ minimum update period, and in particular, updates requests may come less
+ often when the device is in ambient mode or is not being worn.
+ </p>
+
+ <p>
+ You can alternatively use a "push style" to send updates, rather than
+ requesting updates on a fixed schedule. To do so, you can set the update
+ period to 0 so scheduled update requests do not occur (or set it to a
+ non-zero value) and use a <code>ProviderUpdateRequester</code> to trigger
+ calls to <code>onComplicationUpdate</code> as required.
+ </p>
+
+ <h3 id="provider_configuration">
+ Provider configuration
+ </h3>
+
+ <p>
+ If required, a provider can include a configuration activity that is
+ shown to the user when the user chooses a data provider. To include the
+ configuration activity, include a metadata item in the provider service
+ declaration in the manifest with a key of the following:
+ </p>
+
+ <p>
+ <code>android.support.wearable.complications.PROVIDER_CONFIG_ACTION</code>
+ </p>
+
+ <p>
+ The value can be an action of your choice.
+ </p>
+
+ <p>
+ Then create the configuration activity with an intent filter for that
+ action. The configuration activity must reside in the same package as the
+ provider.
+ </p>
+
+ <p>
+ The configuration activity must return <code>RESULT_OK</code> or
+ <code>RESULT_CANCELED</code>, to tell the system whether the provider
+ should be set.
+ </p>
+
+ <p>
+ The configuration activity may also be used as an opportunity to request
+ any permissions required by the provider.
+ </p>
+
+ <p>
+ For details, download the Android Wear 2.0 Preview Reference, containing
+ the Javadoc, and see the following in the
+ <code>ComplicationProviderService</code> class:
+ </p>
+
+ <pre>
+METADATA_KEY_PROVIDER_CONFIG_ACTION
+</pre>
+ <h2 id="using_complication_types">
+ Using Complication Types
+ </h2>
+
+ <p>
+ Complication types determine the kinds of data shown in a complication.
+ For example, the <code>SHORT_TEXT</code> type is available when the key
+ data is a short string. In the example of the <code>SHORT_TEXT</code>
+ type, optional data are an icon and a short title.
+ </p>
+
+ <p>
+ Data providers use these complication types differently from the way
+ watch face providers use these types:
+ </p>
+
+ <ul>
+ <li>A data provider chooses the types of complication data to supply. For
+ example, a step count provider might support the
+ <code>RANGED_VALUE</code> and <code>SHORT_TEXT</code> types, whereas a
+ "next meeting" provider might support the <code>SHORT_TEXT</code> and
+ <code>LONG_TEXT</code> types. The data provider also chooses which
+ optional fields of those types to include.
+ </li>
+
+ <li>A watch face provider chooses how many complication types to support.
+ For example, a round complication on a watch face might support the
+ <code>SHORT_TEXT</code>, <code>ICON</code> and <code>RANGED_VALUE</code>
+ types, whereas a gauge on the watch face might support only the
+ <code>RANGED_VALUE</code> type.
+ </li>
+ </ul>
+
+ <p>
+ A <code>ComplicationData</code> object will always have a single
+ complication type. Each complication type has required and optional
+ fields. Generally, a required field represents the primary piece of data;
+ most types take their name from the required field.
+ </p>
+
+ <p>
+ A given type may include different sets of fields. For example,
+ <code>SHORT_TEXT</code> may be just a single piece of text, or a title
+ and text, or an icon and text. A complication that supports a given type
+ must be able to display all the expected variants. However, some optional
+ fields do not need to be displayed (see the <em>Notes</em> column of the
+ table below). For example, the Short title field of the
+ <code>RANGED_VALUE</code> type is not required so that, for example,
+ gauges can be shown without including text.
+ </p>
+
+
+ <h3 id="types_and_fields">
+ Types and fields
+ </h3>
+
+ <p>
+ The following table describes the types and fields of the
+ <code>ComplicationData</code> object.
+ </p>
+
+ <table>
+ <tr>
+ <th scope="col">
+ Type
+ </th>
+ <th scope="col">
+ Required fields
+ </th>
+ <th scope="col">
+ Optional fields
+ </th>
+ <th scope="col">
+ Notes
+ </th>
+ </tr>
+
+ <tr>
+ <td>
+ SHORT_TEXT
+ </td>
+ <td>
+ Short text
+ </td>
+ <td>
+ IconShort title
+ </td>
+ <td>
+ Exactly one of Icon/Short title is expected to be shown if either or
+ both are provided.
+ </td>
+ </tr>
+
+ <tr>
+ <td>
+ LONG_TEXT
+ </td>
+ <td>
+ Long text
+ </td>
+ <td>
+ Long titleIcon*Small image
+ </td>
+ <td>
+ Title is expected to be shown if provided.
+ </td>
+ </tr>
+
+ <tr>
+ <td>
+ RANGED_VALUE
+ </td>
+ <td>
+ ValueMin valueMax value
+ </td>
+ <td>
+ IconShort textShort title
+ </td>
+ <td>
+ Optional fields are not guaranteed to be displayed. Uses include for
+ numerical data within bounds, such as for a percentage.
+ </td>
+ </tr>
+
+ <tr>
+ <td>
+ ICON
+ </td>
+ <td>
+ Icon
+ </td>
+ <td>
+ </td>
+ <td>
+ Used when text is not needed.The icon is expected to be single-color,
+ and may be tinted by the watch face.
+ </td>
+ </tr>
+
+ <tr>
+ <td>
+ SMALL_IMAGE
+ </td>
+ <td>
+ Small image
+ </td>
+ <td>
+ </td>
+ <td>
+ A small image has one of two styles: <em>photo style</em> or <em>icon
+ style</em>. Photo style means it should fill the space and can be
+ cropped; icon style means it should not be cropped and may be padded.
+ </td>
+ </tr>
+
+ <tr>
+ <td>
+ LARGE_IMAGE
+ </td>
+ <td>
+ Large image
+ </td>
+ <td>
+ </td>
+ <td>
+ This image is expected to be large enough to fill the watch face.
+ </td>
+ </tr>
+ </table>
+
+ <p>
+ In addition, the following two types have no fields. These two types may
+ be sent for any complication slot and do not need to be included in a
+ list of supported types:
+ </p>
+
+ <table>
+ <tr>
+ <th scope="col">
+ Type
+ </th>
+ <th scope="col">
+ Required fields
+ </th>
+ <th scope="col">
+ Optional fields
+ </th>
+ <th scope="col">
+ Notes
+ </th>
+ </tr>
+
+ <tr>
+ <td>
+ NOT_CONFIGURED
+ </td>
+ <td>
+ None
+ </td>
+ <td>
+ None
+ </td>
+ <td>
+ Sent when a provider has not yet been chosen for a complication.
+ </td>
+ </tr>
+
+ <tr>
+ <td>
+ EMPTY
+ </td>
+ <td>
+ None
+ </td>
+ <td>
+ None
+ </td>
+ <td>
+ Sent by a provider when there is no data to display in a
+ complication, or sent by the system when nothing should be shown in a
+ complication.
+ </td>
+ </tr>
+ </table>
+
+ <h3 id="examples_of_complication_types">
+ Examples of Complication Types
+ </h3>
+ <p>
+ The following shows examples of complication types:
+ </p>
+
+ <img src="../images/complication-type-exs.png" width=""
+ alt="Complication types" title="Complications types - examples">
+
+ <h2 id="using_fields_for_complication_data">
+ Using Fields for Complication Data
+ </h2>
+
+ <p>
+ The fields of a <code>ComplicationData</code> object have different
+ functions. For example, a text field contains the primary data while a
+ title field is descriptive; a step count complication might have a text
+ field value of "2,543" with a title field value of "steps."
+ </p>
+
+ <p>
+ The following table contains descriptions of the fields in a
+ <code>ComplicationData</code> object. The fields may or may not be
+ populated, depending on the complication type.
+ </p>
+
+ <table>
+ <tr>
+ <th scope="col">
+ Field
+ </th>
+ <th scope="col">
+ Description
+ </th>
+ </tr>
+
+ <tr>
+ <td>
+ Short text
+ </td>
+ <td>
+ Primary text field for small complications. Should not exceed 7
+ characters.
+ </td>
+ </tr>
+
+ <tr>
+ <td>
+ Short title
+ </td>
+ <td>
+ Descriptive field for small complications.Should not exceed 7
+ characters.May only be meaningful in combination with <em>Short
+ text</em>.
+ </td>
+ </tr>
+
+ <tr>
+ <td>
+ Long text
+ </td>
+ <td>
+ Primary data field for large, text-based complications.
+ </td>
+ </tr>
+
+ <tr>
+ <td>
+ Long title
+ </td>
+ <td>
+ Descriptive field for large, text-based complications.May only be
+ meaningful in combination with <em>Long text</em>.
+ </td>
+ </tr>
+
+ <tr>
+ <td>
+ Value
+ </td>
+ <td>
+ A numerical (float) representation of the data.Expected to be
+ depicted relative to the bounds the <em>Min value</em> and <em>Max
+ value</em> fields (but not required to be between those bounds).
+ </td>
+ </tr>
+
+ <tr>
+ <td>
+ Min value
+ </td>
+ <td>
+ The lower bound for the range within which <em>Value</em> should be
+ depicted.Only meaningful in combination with <em>Value</em> and
+ <em>Max value</em>.
+ </td>
+ </tr>
+
+ <tr>
+ <td>
+ Max value
+ </td>
+ <td>
+ The upper bound for the range within which <em>value</em> should be
+ depicted.Only meaningful in combination with <em>Value</em> and
+ <em>Min value</em>.
+ </td>
+ </tr>
+
+ <tr>
+ <td>
+ Icon
+ </td>
+ <td>
+ A single-color image representing the data or the source of the
+ data.Must be tintable.
+ </td>
+ </tr>
+
+ <tr>
+ <td>
+ Small image
+ </td>
+ <td>
+ A small image to represent the data or the source of the data.May be
+ full color.Not expected to fill the entire watch face.
+ </td>
+ </tr>
+
+ <tr>
+ <td>
+ Large image
+ </td>
+ <td>
+ An image with sufficient resolution to fill the watch face.May be
+ full color.
+ </td>
+ </tr>
+ </table>
+
+ <h3 id="providing_time-dependent_values">
+ Providing time-dependent values
+ </h3>
+
+ <p>
+ Some complications need to display a value that relates to the current
+ time. Examples include the current date, the time until the next meeting,
+ or the time in another time zone.
+ </p>
+
+ <p>
+ Providers of such data should not need to update a complication every
+ second/minute to keep those values up to date. Instead, they can specify
+ the values as relative to the current date or time.
+ </p>
+
+ <p>
+ Providers can use the builders in the <code>ComplicationText</code> class
+ to create these time-dependent values.
+ </p>
+
+ <h2 id="api_additions">
+ API Additions
+ </h2>
+
+ <p>
+ The Complications API includes the following new classes in the Wearable
+ Support Library:
+ </p>
+
+ <ul>
+ <li>
+ <code>ComplicationData</code>
+ <ul>
+ <li>Parcelable (using a Bundle internally); immutable
+ </li>
+
+ <li>Represents all types of complication data
+ </li>
+
+ <li>Includes a Builder for instance creation
+ </li>
+ </ul>
+ </li>
+
+ <li>
+ <code>ComplicationText</code>
+ <ul>
+ <li>Used to supply text-based values in a
+ <code>ComplicationData</code> object
+ </li>
+
+ <li>Includes options for time-dependent values, whose text value
+ depends on the current time
+ </li>
+ </ul>
+ </li>
+
+ <li>
+ <code>ComplicationProviderService</code>
+ <ul>
+ <li>Extends <code>Service</code> and includes callback methods to
+ respond to the complication system
+ </li>
+
+ <li>Callback methods are all called on the main thread
+ </li>
+ </ul>
+ </li>
+
+ <li>
+ <code>ComplicationManager</code>
+ <ul>
+ <li>A wrapper for the complication manager service, for use by
+ providers
+ </li>
+
+ <li>Allows providers to send complication data to the system
+ </li>
+ </ul>
+ </li>
+
+ <li>
+ <code>ProviderChooserIntent</code>
+ <ul>
+ <li>Non-instantiable utility class
+ </li>
+
+ <li>Includes a method that a watch face can call for starting a
+ provider chooser (to allow a user to configure complications)
+ </li>
+ </ul>
+ </li>
+
+ <li>
+ <code>ProviderInfoRetriever</code>
+ <ul>
+ <li>Can be used (by watch face configuration activities) to retrieve
+ the current data provider information (app, provider name, icon) for
+ all complications belonging to a watch face
+ </li>
+ </ul>
+ </li>
+
+ <li>
+ <code>ProviderUpdateRequester</code>
+ <ul>
+ <li>Can be used by data provider apps to trigger calls to
+ <code>onComplicationUpdated</code> in their provider service, to
+ enable the push of updates
+ </li>
+ </ul>
+ </li>
+ </ul>
+
+ <p>
+ Additionally, the <code>WatchFaceService.Engine</code> class contains the
+ following new methods:
+ </p>
+
+ <ul>
+ <li>
+ <code>setActiveComplications</code>
+ <ul>
+ <li>Should be called by the watch face to tell the
+ <code>ComplicationManager</code> object what complication slots are
+ available and what types are supported
+ </li>
+ </ul>
+ </li>
+
+ <li>
+ <code>onComplicationDataUpdate</code>
+ <ul>
+ <li>Called by the <code>ComplicationManager</code> object to send
+ complication data to the watch face
+ </li>
+ </ul>
+ </li>
+ </ul>
diff --git a/docs/html/wear/preview/features/ime.jd b/docs/html/wear/preview/features/ime.jd
new file mode 100644
index 0000000..4ee507c
--- /dev/null
+++ b/docs/html/wear/preview/features/ime.jd
@@ -0,0 +1,136 @@
+page.title=Wear Input Method Framework
+meta.tags="wear", "wear-preview", "input-method", "ime"
+page.tags="wear"
+
+@jd:body
+
+
+<div id="qv-wrapper">
+<div id="qv">
+
+ <h2>In this document</h2>
+ <ol>
+ <li><a href="#creating">Creating an Input Method for Wear</a></li>
+ <li><a href="#invoking">Invoking IME</a></li>
+ <li><a href="#considerations">General IME Considerations</a></li>
+ <li><a href="#test">Testing your IME</a></li>
+ </ol>
+
+</div>
+</div>
+
+
+<p>Wear 2.0 supports input methods beyond voice by extending the Android
+Input Method Framework (IMF) to Android Wear. IMF allows for virtual, on-screen
+ keyboards and other input methods to be used for text entry. The IMF APIs used
+ for Wear devices are the same as other form factors, though usage is slightly
+ different due to limited screen real estate.</p>
+
+<p>Wear 2.0 comes with the system default Input Method Editor (IME)
+and opens up the IMF APIs for third-party developers to create custom input
+methods for Wear.
+</p>
+
+
+<h2 id="creating">Creating an Input Method for Wear</h2>
+
+<p>To create an input method for Wear,
+see <a href="http://developer.android.com/guide/topics/text/creating-input-method.html">Creating an Input Method</a>.
+</p>
+
+<h2 id="invoking">Invoking IME</h2>
+If you are developing an IME for Wear, remember that the
+feature is supported only on Android 6.0 (API level 23) and higher versions of
+the platform.
+To ensure that your IME can only be installed on Wearables that support input
+methods beyond voice, add the following to your application's manifest:
+<pre>
+<uses-sdk android:minSdkVersion="23" />
+</pre>
+This indicates that your application requires Android 6.0 or higher.
+For more information, see <a href="http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels">API Levels</a>
+ and the documentation for the <a href="http://developer.android.com/guide/topics/manifest/uses-sdk-element.html"><uses-sdk></a>
+element.
+<p>
+To control how your application is filtered from devices that do not support Wear
+IMEs (for example, on Phone), add the following to your application's manifest:
+</p>
+<pre>
+<uses-feature android:required="true" android:name="android.hardware.type.watch" />
+</pre>
+
+<p>Wear provides user settings on the watch that lets the user to enable multiple
+ IMEs from the list of installed IMEs. Once the users enable your IME, they
+ can invoke your IME from:</p>
+<ul>
+<li>A notification or an app using the
+<a href="http://developer.android.com/reference/android/support/v4/app/RemoteInput.html">RemoteInput</a></code> API.</li>
+<li>Wear apps with an
+<a href="http://developer.android.com/reference/android/widget/EditText.html">EditText</a>
+ field. Touching a text field places the cursor in the field and automatically
+ displays the IME on focus.</li>
+</ul>
+
+
+<h2 id="considerations">General IME Considerations</h2>
+
+<p>Here are some things to consider when implementing IME for wear:</p>
+
+<ul>
+<li><strong>Set Default Action</strong>
+<p>
+<a href="http://developer.android.com/reference/android/support/v4/app/RemoteInput.html">{@code RemoteInput}</a>
+and Wear apps expect only single-line text entry. The ENTER key should always trigger
+ a call to <a href="http://developer.android.com/reference/android/inputmethodservice/InputMethodService.html#sendDefaultEditorAction(boolean)">sendDefaultEditorAction</a>,
+ which causes the app to dismiss the keyboard and continue on to the next step
+ or action.</p>
+</li>
+
+<li><Strong>Use full screen mode IME</strong>
+<p>
+Most on-screen input methods will consume most of the screen, leaving very little
+ of the app visible; hence, we discourage Android Wear apps from presenting a
+ visible {@code EditTextView}. Instead, a full-screen IME uses
+ <a href="http://developer.android.com/reference/android/inputmethodservice/ExtractEditText.html">ExtractEditText</a>
+ to render its own view of the attached editor, also providing control over the
+ styling of this view. You can ignore all editor-related events that the IME
+ doesn't generate.
+For more details on full-screen mode, see
+<a href="http://developer.android.com/reference/android/inputmethodservice/InputMethodService.html">InputMethodService</a>.
+</p>
+</li>
+
+<li><strong>Handle inputType flags</strong>
+<p>
+For privacy reasons, at a minimum you should handle the {@code inputType}
+flag {@code TYPE_TEXT_VARIATION_PASSWORD} in your IME. When your IME is in
+password mode, make sure that your keyboard is optimized for single key press
+(auto spelling correction, auto completion and gesture input are disabled).
+Most importantly, keyboard in password mode should support ASCII symbols
+regardless of the input language. For more details, see
+<a href="http://developer.android.com/training/keyboard-input/style.html">Specifying The Input Method Type</a>.
+</p>
+</li>
+
+<li><strong>Provide a key for switching to the next input method</strong>
+<p>
+Android allows users to easily switch between all IMEs supported by the platform.
+ In your IME implementation, set the boolean
+ <a href="http://developer.android.com/guide/topics/text/creating-input-method.html#Switching">supportsSwitchingToNextInputMethod = true</a>
+ to enable your IME to support switching mechanism
+ (so that apps can switch to the next platform-supported IME).
+</p>
+</li>
+</ul>
+
+
+<h2 id="test">Test your IME</h2>
+
+<p>To test your IME, install the
+<a href="https://drive.google.com/a/google.com/file/d/0ByOeMdiY1arvWUk5QXU1V0E3cFU/view?usp=sharing">Input Box</a>
+ app which has a simple <i><code>EditText</i></code> field.
+ When responding to messages from chat apps, you can also use the IME on the
+ watch.</p>
+
+
+
diff --git a/docs/html/wear/preview/features/notifications.jd b/docs/html/wear/preview/features/notifications.jd
new file mode 100644
index 0000000..21a77c2
--- /dev/null
+++ b/docs/html/wear/preview/features/notifications.jd
@@ -0,0 +1,7 @@
+page.title=Expanded Notifications
+meta.tags="wear", "wear-preview", "notifications"
+page.tags="wear"
+
+@jd:body
+
+<p>stub</p>
\ No newline at end of file
diff --git a/docs/html/wear/preview/features/ui-nav-actions.jd b/docs/html/wear/preview/features/ui-nav-actions.jd
new file mode 100644
index 0000000..587f88f
--- /dev/null
+++ b/docs/html/wear/preview/features/ui-nav-actions.jd
@@ -0,0 +1,186 @@
+page.title=Wear Navigation and Actions
+meta.tags="wear", "wear-preview", "navigation", "action"
+page.tags="wear"
+
+@jd:body
+
+<div id="qv-wrapper">
+<div id="qv">
+
+ <h2>In this document</h2>
+ <ol>
+ <li><a href="#create a drawer">Create a Drawer Layout</a></li>
+ <li><a href="#initialize">Initialize the Drawer List</a></li>
+ <li><a href="#creating">Create a Custom View Drawer</a></li>
+ <li><a href="#listen to events">Listen for Drawer Events</a></li>
+ <li><a href=#peeking">Peeking Drawers</a></li>
+ </ol>
+
+ <h2>You should also read</h2>
+ <ul>
+ <li><a href="https://spec.googleplex.com/wear/components/navigation-drawer.html">
+ Navigation Drawer Design</a> </li>
+ <li>
+ <a href="https://spec.googleplex.com/wear/components/action-drawer.html">
+ Action Drawer Design</a>
+ </ul>
+
+ <h2>Samples</h2>
+ <ol>
+
+ </ol>
+
+</div>
+</div>
+<p>Wear 2.0 adds interactive navigation and action drawers that users can pull
+from the top or bottom edge of the window, respectively. The navigation drawer
+appears at the top of the screen and lets users jump to different views within
+the app, similar to the navigation drawer on a phone. The action drawer appears
+at the bottom of the screen and provides context-specific actions for the user,
+similar to the action bar on a phone. These drawers are accessible when the user
+swipes from the top or bottom of the screen, and they peek when users scroll in
+the opposite direction. </p>
+<div class="cols">
+<div class="col-2of6">
+ <img src="{@docRoot}wear/preview/images/nav_drawer.gif" alt="" style="padding:.5em">
+ <p class="img-caption">
+ <strong>Figure 1.</strong> Navigation and Action Drawers.
+ </p>
+</div>
+<div class="col-2of6">
+ <img src="{@docRoot}wear/preview/images/action_drawer.gif" alt="" style="padding:.5em;"">
+</div>
+</div>
+<div class="cols">
+
+<p>This lesson describes how to implement action and navigation drawers in your
+app using the {@code WearableDrawerLayout} APIs.
+</p>
+
+<h2 id="create a drawer">Create a Drawer Layout</h2>
+To add an action or a navigation drawer, declare your user interface with a
+<code>WearableDrawerLayout</code> object as the root view of your layout. Inside
+ the <code>WearableDrawerLayout</code>, add one view that contains the main content
+ for the screen (your primary layout when the drawer is hidden) and additional
+ child views that contain the contents of the drawer.</h2>
+<p>For example, the following layout uses a <code>WearableDrawerLayout</code> with
+ three child views: a <code>FrameLayout</code> to contain the main content, a
+ navigation drawer, and an action drawer.</p>
+
+<pre>
+<android.support.wearable.view.drawer.WearableDrawerLayout
+ android:id="@+id/drawer_layout"
+ xmlns:android="http://schemas.android.com/apk/res/android"
+ android:layout_width="match_parent"
+ android:layout_height="match_parent"
+ tools:deviceIds="wear">
+
+ <FrameLayout
+ android:layout_width="match_parent"
+ android:layout_height="match_parent"
+ android:id="@+id/content_frame"/>
+
+ <android.support.wearable.view.drawer.WearableNavigationDrawer
+ android:id="@+id/top_navigation_drawer"
+ android:layout_width="match_parent"
+ android:layout_height="match_parent"/>
+
+ <android.support.wearable.view.drawer.WearableActionDrawer
+ android:id="@+id/bottom_action_drawer"
+ android:layout_width="match_parent"
+ android:layout_height="match_parent"/>
+
+</android.support.wearable.view.drawer.WearableDrawerLayout>
+
+</pre>
+<h2 id="initialize">Initialize the Drawer List</h2>
+<p>One of the first things you need to do in your activity is to initialize the
+drawers list of items. You should implement {@code WearableNavigationDrawerAdapter}
+to populate the navigation drawer contents. To populate the action drawer with
+a list of actions, inflate an XML file into the Menu (via MenuInflater).</p>
+
+<p>The following code snippet shows how to initialize the contents of your drawers:
+</p>
+<pre>
+public class MainActivity extends WearableActivity implements
+WearableActionDrawer.OnMenuItemClickListener{
+ private WearableDrawerLayout mwearableDrawerLayout;
+ private WearableNavigationDrawer mWearableNavigationDrawer;
+ private WearableActionDrawer mWearableActionDrawer;
+
+ ...
+
+ @Override
+ public void onCreate(Bundle savedInstanceState) {
+ super.onCreate(savedInstanceState);
+ setContentView(R.layout.activity_main);
+
+ ......
+
+
+ // Main Wearable Drawer Layout that wraps all content
+ mWearableDrawerLayout = (WearableDrawerLayout) findViewById(R.id.drawer_layout);
+
+ // Top Navigation Drawer
+ mWearableNavigationDrawer = (WearableNavigationDrawer) findViewById(R.id.top_navigation_drawer);
+ mWearableNavigationDrawer.setAdapter(new YourImplementationNavigationAdapter(this));
+
+ // Peeks Navigation drawer on the top.
+ mWearableDrawerLayout.peekDrawer(Gravity.TOP);
+
+ // Bottom Action Drawer
+ mWearableActionDrawer = (WearableActionDrawer) findViewById(R.id.bottom_action_drawer);
+
+ // Populate Action Drawer Menu
+ Menu menu = mWearableActionDrawer.getMenu();
+ MenuInflater inflater = getMenuInflater();
+ inflater.inflate(R.menu.action_drawer_menu, menu);
+ mWearableActionDrawer.setOnMenuItemClickListener(this);
+
+ // Peeks action drawer on the bottom.
+ mWearableDrawerLayout.peekDrawer(Gravity.BOTTOM);
+ }
+}
+
+</pre>
+<h2 id="creating">Create a Custom View Drawer</h2>
+
+<p>To use custom views in drawers, add <code>WearableDrawerView</code> to the
+<code>WearableDrawerLayout</code>. To set the contents of the drawer, call <code>
+<a href="https://x20web.corp.google.com/~psoulos/docs/reference/android/support/wearable/view/drawer/WearableDrawerView.html#setDrawerContent(android.view.View)">setDrawerContent(View)</a></code>
+ instead of manually adding the view to the hierarchy. You must also specify the
+ drawer position with the <code>android:layout_gravity</code> attribute. </p>
+<p> The following example specifies a top drawer:</p>
+<pre>
+<android.support.wearable.view.drawer.WearableDrawerLayout>
+ <FrameLayout
+ android:id=”@+id/content” />
+
+ <WearableDrawerView
+ android:layout_width=”match_parent”
+ andndroid:layout_height=”match_parent”
+ android:layout_gravity=”top”>
+ <FrameLayout
+ android:id=”@+id/top_drawer_content” />
+ </WearableDrawerView>
+</android.support.wearable.view.drawer.WearableDrawerView>
+
+</pre>
+
+<h2 id="listen to events">Listen for Drawer Events</h2>
+<p>To listen for drawer events, call {@code setDrawerStateCallback()}on your
+{@code WearableDrawerLayout} and pass it an implementation of
+{@code WearableDrawerLayout.DrawerStateCallback}. This interface provides callbacks
+ for drawer events such as <code>onDrawerOpened()</code>,
+ <code>onDrawerClosed(),</code> and <code>onDrawerStatechanged()</code>.</p>
+
+<h2 id="peeking">Peeking Drawers</h2>
+<p>To set the drawers to temporarily appear, call <code>peekDrawer()</code> on
+your {@code WearableDrawerLayout} and pass it the {@code Gravity} of the drawer.
+ This feature is especially useful because it allows immediate access to the
+ alternate drawer views or actions associated with it. </p>
+
+<pre>{@code mWearableDrawerLayout.peekDrawer</code>(<code>Gravity.BOTTOM);}</pre>
+
+<p>You can also call {@code setPeekContent()} on your drawer to display a custom
+ view when the drawer is peeking.</p>
diff --git a/docs/html/wear/preview/images/action_drawer.gif b/docs/html/wear/preview/images/action_drawer.gif
new file mode 100644
index 0000000..b823137
--- /dev/null
+++ b/docs/html/wear/preview/images/action_drawer.gif
Binary files differ
diff --git a/docs/html/wear/preview/images/complication-type-exs.png b/docs/html/wear/preview/images/complication-type-exs.png
new file mode 100644
index 0000000..d6fe890
--- /dev/null
+++ b/docs/html/wear/preview/images/complication-type-exs.png
Binary files differ
diff --git a/docs/html/wear/preview/images/complications-data-flow.png b/docs/html/wear/preview/images/complications-data-flow.png
new file mode 100644
index 0000000..7fa43f2
--- /dev/null
+++ b/docs/html/wear/preview/images/complications-data-flow.png
Binary files differ
diff --git a/docs/html/wear/preview/images/hero-1x.png b/docs/html/wear/preview/images/hero-1x.png
new file mode 100644
index 0000000..5dcc847
--- /dev/null
+++ b/docs/html/wear/preview/images/hero-1x.png
Binary files differ
diff --git a/docs/html/wear/preview/images/hero-2x.png b/docs/html/wear/preview/images/hero-2x.png
new file mode 100644
index 0000000..19a60cd
--- /dev/null
+++ b/docs/html/wear/preview/images/hero-2x.png
Binary files differ
diff --git a/docs/html/wear/preview/images/nav_drawer.gif b/docs/html/wear/preview/images/nav_drawer.gif
new file mode 100644
index 0000000..1c3b1dc
--- /dev/null
+++ b/docs/html/wear/preview/images/nav_drawer.gif
Binary files differ
diff --git a/docs/html/wear/preview/index.jd b/docs/html/wear/preview/index.jd
new file mode 100644
index 0000000..3024654
--- /dev/null
+++ b/docs/html/wear/preview/index.jd
@@ -0,0 +1,106 @@
+page.title=Android Wear 2.0 Developer Preview
+page.tags="wear","wear-preview"
+meta.tags="wear","preview"
+fullpage=true
+forcelocalnav=true
+header.hide=1
+footer.hide=1
+@jd:body
+
+<script>
+ $(document).ready(function() {
+ if (useUpdatedTemplates) {
+ $("#useUpdatedTemplates").css("display","block");
+ } else {
+ $("#useOldTemplates").css("display","block");
+ }
+ })
+</script>
+
+<section class="dac-expand dac-hero dac-light" style="background-color:#FFFFFF">
+ <div class="wrap" style="max-width:1100px;margin-top:0">
+ <div class="cols dac-hero-content" style="padding-bottom:1em;">
+
+ <div class="col-7of16 col-push-9of16" style="padding-left:2em">
+ <h1 class="dac-hero-title">Android Wear 2.0 Developer Preview</h1>
+ <p class="dac-hero-description">
+ Get ready for the next version of Android Wear!
+ Support stand-alone Wear devices and apps.
+ Create enhanced user interaction and glanceable experiences.
+ Test your apps on Wear devices.
+ </p>
+
+ <a class="dac-hero-cta" href="{@docRoot}wear/preview/program.html">
+ <span class="dac-sprite dac-auto-chevron"></span>
+ Learn more
+ </a>
+ </div>
+ <div class="col-9of16 col-pull-7of16 dac-hero-figure" style="margin-top:1.5em;padding-right:1.5em;">
+ <img class="dac-hero-image" src="{@docRoot}wear/preview/images/hero-1x.png"
+ srcset="{@docRoot}wear/preview/images/hero-1x.png 1x,
+ {@docRoot}wear/preview/images/hero-2x.png 2x">
+ </div>
+ </div>
+ <div class="dac-section dac-small">
+ <div class="resource-widget resource-flow-layout col-16"
+ data-query="collection:wear/preview/landing"
+ data-cardSizes="6x2"
+ data-maxResults="6"></div>
+ </div>
+ </div>
+</section>
+
+<div id="useUpdatedTemplates" style="display:none" class="dac-section dac-slim dac-gray dac-expand">
+ <div class="wrap dac-offset-parent">
+ <a class="dac-fab dac-scroll-button" data-scroll-button href="#build-apps">
+ <i class="dac-sprite dac-arrow-down-gray"></i>
+ </a>
+ <ul class="dac-actions">
+ <li class="dac-action">
+ <a class="dac-action-link" href="{@docRoot}wear/preview/bug">
+ <i class="dac-action-sprite dac-sprite dac-auto-chevron-large"></i>
+ Report an issue
+ </a>
+ </li>
+ <li class="dac-action">
+ <a class="dac-action-link" href="http://g.co/androidweardev">
+ <i class="dac-action-sprite dac-sprite dac-auto-chevron-large"></i>
+ Join developer community
+ </a>
+ </li>
+ </ul>
+ </div><!-- end .wrap -->
+</div><!-- end .dac-actions -->
+
+<div id="useOldTemplates" style="display:none;color:black" class="actions-bar dac-expand dac-invert">
+ <div class="wrap dac-offset-parent">
+
+ <div class="actions">
+ <div><a href="{@docRoot}wear/preview/bug">
+ <span class="dac-sprite dac-auto-chevron-large"></span>
+ Report an issue
+ </a></div>
+ <div><a href="http://g.co/androidweardev">
+ <span class="dac-sprite dac-auto-chevron-large"></span>
+ Join developer community
+ </a></div>
+ </div><!-- end .actions -->
+ </div><!-- end .wrap -->
+</div>
+
+<section class="dac-section dac-light"><div class="wrap">
+ <h1 class="dac-section-title">Resources</h1>
+ <div class="dac-section-subtitle">
+ Essential information to help you get your apps ready for the next version of Android Wear.
+ </div>
+
+ <div class="resource-widget resource-flow-layout col-16"
+ data-query="collection:wear/preview/landing/resources"
+ data-cardSizes="6x6"
+ data-items-per-page="6"
+ data-maxResults="15"
+ data-initial-results="6"></div>
+
+ </div>
+</section>
+
diff --git a/docs/html/wear/preview/license.jd b/docs/html/wear/preview/license.jd
new file mode 100644
index 0000000..e7a7547
--- /dev/null
+++ b/docs/html/wear/preview/license.jd
@@ -0,0 +1,145 @@
+page.title=License Agreement
+
+@jd:body
+
+<p>
+To get started with the Android Wear SDK Preview, you must agree to the following terms and conditions.
+As described below, please note that this is a preview version of the Android Wear SDK, subject to change, that you use at your own risk. The Android Wear SDK Preview is not a stable release, and may contain errors and defects that can result in serious damage to your computer systems, devices and data.
+</p>
+
+<p>
+This is the Android Wear SDK Preview License Agreement (the “License Agreement”).
+</p>
+<div class="sdk-terms" style="height:auto;border:0;padding:0;width:700px">
+1. Introduction
+
+1.1 The Android Wear SDK Preview (referred to in the License Agreement as the “Preview” and specifically including the Android system files, packaged APIs, and Preview library files, if and when they are made available) is licensed to you subject to the terms of the License Agreement. The License Agreement forms a legally binding contract between you and Google in relation to your use of the Preview.
+
+1.2 "Android" means the Android software stack for devices, as made available under the Android Open Source Project, which is located at the following URL: http://source.android.com/, as updated from time to time.
+
+1.3 “Android-compatible” means any Android implemation that (i) complies with the Android Compatibility Definition document, which can be found at the Android compatibility website (http://source.android.com/compatibility) and which may be updated from time to time; and (ii) successfully passes the Android Compatibility Test Suite (CTS).
+
+1.4 "Google" means Google Inc., a Delaware corporation with principal place of business at 1600 Amphitheatre Parkway, Mountain View, CA 94043, United States.
+
+2. Accepting the License Agreement
+
+2.1 In order to use the Preview, you must first agree to the License Agreement. You may not use the Preview if you do not accept the License Agreement.
+
+2.2 By clicking to accept and/or using the Preview, you hereby agree to the terms of the License Agreement.
+
+2.3 You may not use the Preview and may not accept the License Agreement if you are a person barred from receiving the Preview under the laws of the United States or other countries including the country in which you are resident or from which you use the Preview.
+
+2.4 If you will use the Preview internally within your company or organization you agree to be bound by the License Agreement on behalf of your employer or other entity, and you represent and warrant that you have full legal authority to bind your employer or such entity to the License Agreement. If you do not have the requisite authority, you may not accept the License Agreement or use the Preview on behalf of your employer or other entity.
+
+3. Preview License from Google
+
+3.1 Subject to the terms of this License Agreement, Google grants you a limited, worldwide, royalty-free, non-assignable, non-exclusive, and non-sublicensable license to use the Preview solely to develop applications for compatible implementations of Android.
+
+3.2 You may not use this Preview to develop applications for other platforms (including non-compatible implementations of Android) or to develop another SDK. You are of course free to develop applications for other platforms, including non-compatible implementations of Android, provided that this Preview is not used for that purpose.
+
+3.3 You agree that Google or third parties owns all legal right, title and interest in and to the Preview, including any Intellectual Property Rights that subsist in the Preview. "Intellectual Property Rights" means any and all rights under patent law, copyright law, trade secret law, trademark law, and any and all other proprietary rights. Google reserves all rights not expressly granted to you.
+
+3.4 You may not use the Preview for any purpose not expressly permitted by the License Agreement. Except to the extent required by applicable third party licenses, you may not: (a) copy (except for backup purposes), modify, adapt, redistribute, decompile, reverse engineer, disassemble, or create derivative works of the Preview or any part of the Preview; or (b) load any part of the Preview onto a mobile handset or any other hardware device except a personal computer, combine any part of the Preview with other software, or distribute any software or device incorporating a part of the Preview.
+
+3.5 Use, reproduction and distribution of components of the Preview licensed under an open source software license are governed solely by the terms of that open source software license and not the License Agreement. You agree to remain a licensee in good standing in regard to such open source software licenses under all the rights granted and to refrain from any actions that may terminate, suspend, or breach such rights.
+
+3.6 You agree that the form and nature of the Preview that Google provides may change without prior notice to you and that future versions of the Preview may be incompatible with applications developed on previous versions of the Preview. You agree that Google may stop (permanently or temporarily) providing the Preview (or any features within the Preview) to you or to users generally at Google's sole discretion, without prior notice to you.
+
+3.7 Nothing in the License Agreement gives you a right to use any of Google's trade names, trademarks, service marks, logos, domain names, or other distinctive brand features.
+
+3.8 You agree that you will not remove, obscure, or alter any proprietary rights notices (including copyright and trademark notices) that may be affixed to or contained within the Preview.
+
+4. Use of the Preview by You
+
+4.1 Google agrees that nothing in the License Agreement gives Google any right, title or interest from you (or your licensors) under the License Agreement in or to any software applications that you develop using the Preview, including any intellectual property rights that subsist in those applications.
+
+4.2 You agree to use the Preview and write applications only for purposes that are permitted by (a) the License Agreement, and (b) any applicable law, regulation or generally accepted practices or guidelines in the relevant jurisdictions (including any laws regarding the export of data or software to and from the United States or other relevant countries).
+
+4.3 You agree that if you use the Preview to develop applications, you will protect the privacy and legal rights of users. If users provide you with user names, passwords, or other login information or personal information, you must make the users aware that the information will be available to your application, and you must provide legally adequate privacy notice and protection for those users. If your application stores personal or sensitive information provided by users, it must do so securely. If users provide you with Google Account information, your application may only use that information to access the user's Google Account when, and for the limited purposes for which, each user has given you permission to do so.
+
+4.4 You agree that you will not engage in any activity with the Preview, including the development or distribution of an application, that interferes with, disrupts, damages, or accesses in an unauthorized manner the servers, networks, or other properties or services of Google or any third party.
+
+4.5 You agree that you are solely responsible for (and that Google has no responsibility to you or to any third party for) any data, content, or resources that you create, transmit or display through Android and/or applications for Android, and for the consequences of your actions (including any loss or damage which Google may suffer) by doing so.
+
+4.6 You agree that you are solely responsible for (and that Google has no responsibility to you or to any third party for) any breach of your obligations under the License Agreement, any applicable third party contract or Terms of Service, or any applicable law or regulation, and for the consequences (including any loss or damage which Google or any third party may suffer) of any such breach.
+
+4.7 The Preview is in development, and your testing and feedback are an important part of the development process. By using the Preview, you acknowledge that implementation of some features are still under development and that you should not rely on the Preview having the full functionality of a stable release. You agree not to publicly distribute or ship any application using this Preview as this Preview will no longer be supported after the official Android SDK is released.
+
+5. Your Developer Credentials
+
+5.1 You agree that you are responsible for maintaining the confidentiality of any developer credentials that may be issued to you by Google or which you may choose yourself and that you will be solely responsible for all applications that are developed under your developer credentials.
+
+6. Privacy and Information
+
+6.1 In order to continually innovate and improve the Preview, Google may collect certain usage statistics from the software including but not limited to a unique identifier, associated IP address, version number of the software, and information on which tools and/or services in the Preview are being used and how they are being used. Before any of this information is collected, the Preview will notify you and seek your consent. If you withhold consent, the information will not be collected.
+
+6.2 The data collected is examined in the aggregate to improve the Preview and is maintained in accordance with Google's Privacy Policy located at http://www.google.com/policies/privacy/.
+
+7. Third Party Applications
+
+7.1 If you use the Preview to run applications developed by a third party or that access data, content or resources provided by a third party, you agree that Google is not responsible for those applications, data, content, or resources. You understand that all data, content or resources which you may access through such third party applications are the sole responsibility of the person from which they originated and that Google is not liable for any loss or damage that you may experience as a result of the use or access of any of those third party applications, data, content, or resources.
+
+7.2 You should be aware the data, content, and resources presented to you through such a third party application may be protected by intellectual property rights which are owned by the providers (or by other persons or companies on their behalf). You may not modify, rent, lease, loan, sell, distribute or create derivative works based on these data, content, or resources (either in whole or in part) unless you have been specifically given permission to do so by the relevant owners.
+
+7.3 You acknowledge that your use of such third party applications, data, content, or resources may be subject to separate terms between you and the relevant third party.
+
+8. Using Google APIs
+
+8.1 Google APIs
+
+8.1.1 If you use any API to retrieve data from Google, you acknowledge that the data may be protected by intellectual property rights which are owned by Google or those parties that provide the data (or by other persons or companies on their behalf). Your use of any such API may be subject to additional Terms of Service. You may not modify, rent, lease, loan, sell, distribute or create derivative works based on this data (either in whole or in part) unless allowed by the relevant Terms of Service.
+
+8.1.2 If you use any API to retrieve a user's data from Google, you acknowledge and agree that you shall retrieve data only with the user's explicit consent and only when, and for the limited purposes for which, the user has given you permission to do so.
+
+9. Terminating the License Agreement
+
+9.1 the License Agreement will continue to apply until terminated by either you or Google as set out below.
+
+9.2 If you want to terminate the License Agreement, you may do so by ceasing your use of the Preview and any relevant developer credentials.
+
+9.3 Google may at any time, terminate the License Agreement, with or without cause, upon notice to you.
+
+9.4 The License Agreement will automatically terminate without notice or other action upon the earlier of:
+(A) when Google ceases to provide the Preview or certain parts of the Preview to users in the country in which you are resident or from which you use the service; and
+(B) Google issues a final release version of the Android SDK.
+
+9.5 When the License Agreement is terminated, the license granted to you in the License Agreement will terminate, you will immediately cease all use of the Preview, and the provisions of paragraphs 10, 11, 12 and 14 shall survive indefinitely.
+
+10. DISCLAIMERS
+
+10.1 YOU EXPRESSLY UNDERSTAND AND AGREE THAT YOUR USE OF THE PREVIEW IS AT YOUR SOLE RISK AND THAT THE PREVIEW IS PROVIDED "AS IS" AND "AS AVAILABLE" WITHOUT WARRANTY OF ANY KIND FROM GOOGLE.
+
+10.2 YOUR USE OF THE PREVIEW AND ANY MATERIAL DOWNLOADED OR OTHERWISE OBTAINED THROUGH THE USE OF THE PREVIEW IS AT YOUR OWN DISCRETION AND RISK AND YOU ARE SOLELY RESPONSIBLE FOR ANY DAMAGE TO YOUR COMPUTER SYSTEM OR OTHER DEVICE OR LOSS OF DATA THAT RESULTS FROM SUCH USE. WITHOUT LIMITING THE FOREGOING, YOU UNDERSTAND THAT THE PREVIEW IS NOT A STABLE RELEASE AND MAY CONTAIN ERRORS, DEFECTS AND SECURITY VULNERABILITIES THAT CAN RESULT IN SIGNIFICANT DAMAGE, INCLUDING THE COMPLETE, IRRECOVERABLE LOSS OF USE OF YOUR COMPUTER SYSTEM OR OTHER DEVICE.
+
+10.3 GOOGLE FURTHER EXPRESSLY DISCLAIMS ALL WARRANTIES AND CONDITIONS OF ANY KIND, WHETHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO THE IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
+
+11. LIMITATION OF LIABILITY
+
+11.1 YOU EXPRESSLY UNDERSTAND AND AGREE THAT GOOGLE, ITS SUBSIDIARIES AND AFFILIATES, AND ITS LICENSORS SHALL NOT BE LIABLE TO YOU UNDER ANY THEORY OF LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL OR EXEMPLARY DAMAGES THAT MAY BE INCURRED BY YOU, INCLUDING ANY LOSS OF DATA, WHETHER OR NOT GOOGLE OR ITS REPRESENTATIVES HAVE BEEN ADVISED OF OR SHOULD HAVE BEEN AWARE OF THE POSSIBILITY OF ANY SUCH LOSSES ARISING.
+
+12. Indemnification
+
+12.1 To the maximum extent permitted by law, you agree to defend, indemnify and hold harmless Google, its affiliates and their respective directors, officers, employees and agents from and against any and all claims, actions, suits or proceedings, as well as any and all losses, liabilities, damages, costs and expenses (including reasonable attorneys’ fees) arising out of or accruing from (a) your use of the Preview, (b) any application you develop on the Preview that infringes any Intellectual Property Rights of any person or defames any person or violates their rights of publicity or privacy, and (c) any non-compliance by you of the License Agreement.
+
+13. Changes to the License Agreement
+
+13.1 Google may make changes to the License Agreement as it distributes new versions of the Preview. When these changes are made, Google will make a new version of the License Agreement available on the website where the Preview is made available.
+
+14. General Legal Terms
+
+14.1 the License Agreement constitutes the whole legal agreement between you and Google and governs your use of the Preview (excluding any services which Google may provide to you under a separate written agreement), and completely replaces any prior agreements between you and Google in relation to the Preview.
+
+14.2 You agree that if Google does not exercise or enforce any legal right or remedy which is contained in the License Agreement (or which Google has the benefit of under any applicable law), this will not be taken to be a formal waiver of Google's rights and that those rights or remedies will still be available to Google.
+
+14.3 If any court of law, having the jurisdiction to decide on this matter, rules that any provision of the License Agreement is invalid, then that provision will be removed from the License Agreement without affecting the rest of the License Agreement. The remaining provisions of the License Agreement will continue to be valid and enforceable.
+
+14.4 You acknowledge and agree that each member of the group of companies of which Google is the parent shall be third party beneficiaries to the License Agreement and that such other companies shall be entitled to directly enforce, and rely upon, any provision of the License Agreement that confers a benefit on (or rights in favor of) them. Other than this, no other person or company shall be third party beneficiaries to the License Agreement.
+
+14.5 EXPORT RESTRICTIONS. THE PREVIEW IS SUBJECT TO UNITED STATES EXPORT LAWS AND REGULATIONS. YOU MUST COMPLY WITH ALL DOMESTIC AND INTERNATIONAL EXPORT LAWS AND REGULATIONS THAT APPLY TO THE PREVIEW. THESE LAWS INCLUDE RESTRICTIONS ON DESTINATIONS, END USERS AND END USE.
+
+14.6 The License Agreement may not be assigned or transferred by you without the prior written approval of Google, and any attempted assignment without such approval will be void. You shall not delegate your responsibilities or obligations under the License Agreement without the prior written approval of Google.
+
+14.7 The License Agreement, and your relationship with Google under the License Agreement, shall be governed by the laws of the State of California without regard to its conflict of laws provisions. You and Google agree to submit to the exclusive jurisdiction of the courts located within the county of Santa Clara, California to resolve any legal matter arising from the License Agreement. Notwithstanding this, you agree that Google shall still be allowed to apply for injunctive remedies (or an equivalent type of urgent legal relief) in any jurisdiction.
+
+
+</div>
\ No newline at end of file
diff --git a/docs/html/wear/preview/preview_toc.cs b/docs/html/wear/preview/preview_toc.cs
new file mode 100644
index 0000000..f96bf1f
--- /dev/null
+++ b/docs/html/wear/preview/preview_toc.cs
@@ -0,0 +1,132 @@
+<ul id="nav">
+
+ <li class="nav-section">
+ <div class="nav-section-header empty"><a href="<?cs var:toroot ?>preview/overview.html"
+ es-lang="Información general del programa"
+ ja-lang="プログラム概要"
+ ko-lang="프로그램 개요"
+ pt-br-lang="Visão geral do programa"
+ ru-lang="Обзор программы"
+ zh-cn-lang="计划概览"
+ zh-tw-lang="程式總覽">
+ Program Overview</a></div>
+ </li>
+
+
+ <li class="nav-section">
+ <div class="nav-section-header empty"><a href="<?cs var:toroot ?>preview/support.html">
+ Support and Release Notes</a></div>
+ </li>
+
+ <li class="nav-section">
+ <div class="nav-section-header empty"><a href="<?cs var:toroot ?>preview/setup-sdk.html"
+ es-lang="Configurar el SDK de la versión preliminar"
+ ja-lang="Preview SDK のセットアップ"
+ ko-lang="미리 보기 SDK 설정하기"
+ pt-br-lang="Configuração do Preview SDK"
+ ru-lang="Настройка пакета SDK Preview"
+ zh-cn-lang="设置预览版 SDK"
+ zh-tw-lang="設定預覽版 SDK">
+ Set Up to Develop</a></div>
+ </li>
+ <li class="nav-section">
+ <div class="nav-section-header empty"><a href="<?cs var:toroot ?>preview/download.html">
+ Test on a Device</a></div>
+ </li>
+
+
+ <li class="nav-section">
+ <div class="nav-section-header"><a href="<?cs var:toroot ?>preview/behavior-changes.html"
+ es-lang="Cambios en los comportamientos"
+ ja-lang="動作の変更点"
+ ko-lang="동작 변경"
+ pt-br-lang="Mudanças de comportamento"
+ ru-lang="Изменения в работе"
+ zh-cn-lang="行为变更"
+ zh-tw-lang="行為變更">Behavior Changes
+ </a></div>
+ <ul>
+ <li><a href="<?cs var:toroot ?>preview/features/background-optimization.html"
+ >Background Optimizations</a></li>
+ <li><a href="<?cs var:toroot ?>preview/features/multilingual-support.html"
+ >Language and Locale</a></li>
+ </ul>
+ </li>
+
+ <li class="nav-section">
+ <div class="nav-section-header"><a href="<?cs var:toroot ?>preview/api-overview.html"
+ es-lang="Información general de la API"
+ ja-lang="API の概要"
+ ko-lang="API 개요"
+ pt-br-lang="Visão geral da API"
+ ru-lang="Обзор API-интерфейсов"
+ zh-cn-lang="API 概览"
+ zh-tw-lang="API 總覽">Android N for Developers
+ </a></div>
+ <ul>
+
+ <li><a href="<?cs var:toroot ?>preview/features/multi-window.html"
+ >Multi-Window Support</a></li>
+
+ <li><a href="<?cs var:toroot ?>preview/features/notification-updates.html"
+ >Notifications</a></li>
+
+ <li><a href="<?cs var:toroot ?>preview/features/data-saver.html"
+ >Data Saver</a></li>
+
+ <li><a href="<?cs var:toroot ?>preview/features/tv-recording-api.html"
+ >TV Recording</a></li>
+
+ <li><a href="<?cs var:toroot ?>preview/features/security-config.html"
+ >Network Security Configuration</a></li>
+
+ <li><a href="<?cs var:toroot ?>preview/features/icu4j-framework.html"
+ >ICU4J Support</a></li>
+
+ <li><a href="<?cs var:toroot ?>preview/j8-jack.html"
+ >Java 8 Language Features</a></li>
+
+ <li><a href="<?cs var:toroot ?>preview/features/afw.html"
+ >Android for Work Updates</a></li>
+ </ul>
+ </li>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="nav-section">
+ <div class="nav-section-header empty"><a href="<?cs var:toroot ?>preview/samples.html"
+ es-lang="Ejemplos"
+ ja-lang="サンプル"
+ ko-lang="샘플"
+ pt-br-lang="Exemplos"
+ ru-lang="Примеры"
+ zh-cn-lang="示例"
+ zh-tw-lang="範例">
+ Samples</a></div>
+ </li>
+
+ <li class="nav-section">
+ <div class="nav-section-header empty"><a href="<?cs var:toroot ?>preview/license.html"
+ es-lang="Contrato de licencia"
+ ja-lang="使用許諾契約"
+ ko-lang="라이선스 계약"
+ pt-br-lang="Contrato de licença"
+ ru-lang="Лицензионное соглашение"
+ zh-cn-lang="许可协议"
+ zh-tw-lang="授權協議">
+ License Agreement</a></div>
+ </li>
+
+</ul>
diff --git a/docs/html/wear/preview/program.jd b/docs/html/wear/preview/program.jd
new file mode 100644
index 0000000..802e8a8
--- /dev/null
+++ b/docs/html/wear/preview/program.jd
@@ -0,0 +1,255 @@
+page.title=Android Wear Preview Program Overview
+meta.keywords="wear-preview"
+page.tags="wear-preview"
+page.image=images/cards/card-n-sdk_2x.png
+
+@jd:body
+
+ <p>
+ Welcome to the Android Wear 2.0 Developer Preview! This program gives you
+ everything you need to get started with the next version of Android Wear.
+ It’s free, and you can get started right away by downloading the
+ Developer Preview resources.
+ </p>
+
+ <h3 id="program_highlights">
+ Program Highlights
+ </h3>
+
+ <div style="background-color:#eceff1;padding:1em;">
+ <div class="wrap">
+ <div class="cols">
+ <div class="col-4of12">
+ <h5>
+ Hardware and emulator images
+ </h5>
+
+ <p>
+ Run and test your apps on a range of devices or on an emulator.
+ </p>
+ </div>
+
+ <div class="col-4of12">
+ <h5>
+ Latest platform code
+ </h5>
+
+ <p>
+ We’ll provide monthly updates during the preview, so you'll be
+ testing against the latest platform changes.
+ </p>
+ </div>
+
+ <div class="col-4of12">
+ <h5>
+ Priority for developer issues
+ </h5>
+
+ <p>
+ During the first several weeks, we'll give priority to
+ developer-reported issues, so test and give feedback as soon as
+ possible.
+ </p>
+ </div>
+ </div>
+
+ <div class="cols">
+ <div class="col-4of12">
+ <h5>
+ New behaviors and capabilities
+ </h5>
+
+ <p>
+ Start work early to support new platform behaviors such as
+ complications and Material Design for Wear.
+ </p>
+ </div>
+
+ <div class="col-4of12">
+ <h5>
+ Feedback and support
+ </h5>
+
+ <p>
+ Report issues and give us feedback using our issue tracker.
+ Connect with other developers in the Wear Developer Community.
+ </p>
+ </div>
+
+ <div class="col-4of12">
+ </div>
+ </div>
+ </div>
+ </div>
+
+ <h2 id="timeline_and_updates">
+ Timeline and Updates
+ </h2>
+
+ <p>
+ The Android Wear 2.0 Developer Preview runs from 18 May 2016 until the
+ final Android Wear public release to OEMs, planned for Q4 2016.
+ </p>
+
+ <p>
+ At key development milestones, we'll deliver updates for your development
+ and testing environment. In general you can expect updates in
+ approximately 6-week intervals. The release milestones are:
+ </p>
+
+ <ul>
+ <li>Milestone 1 (initial release, alpha)
+ </li>
+
+ <li>Milestone 2 (incremental update, beta)
+ </li>
+
+ <li>Milestone 3 (incremental update, beta)
+ </li>
+
+ <li>Milestone 4 (final APIs and official SDK, Play publishing)
+ </li>
+
+ <li>Near-final system image
+ </li>
+
+ <li>Final release to OEMs
+ </li>
+ </ul>
+
+ <p>
+ Each update includes an updated support library, preview system images,
+ emulator, reference documentation, and API diffs.
+ </p>
+
+ <p>
+ The first three milestones provide an early test and development
+ environment to helps you identify compatibility issues in your current
+ apps and plan migration or feature work needed to target the new
+ platform. This is the priority period in which to give us your feedback
+ on features and APIs and file compatibility issues — for all of these,
+ please use the issue tracker. You can expect some API changes across
+ these updates.
+ </p>
+
+ <p>
+ At milestones 4 and 5 you'll have access to the final Android Wear 2.0
+ APIs and SDK to develop with, as well as near-final system images to test
+ system behaviors and features. Android Wear 2.0 will use the Android N
+ API level at this time. You can begin final compatibility testing of your
+ legacy apps and refine any new code that is using the Android Wear 2.0
+ APIs or features.
+ </p>
+
+ <p>
+ As you test and develop on Android Wear 2.0, we strongly recommend
+ keeping your development environment up-to-date as updates are released.
+ Updated preview images will be available that you can download and flash
+ manually.
+ </p>
+
+ <p>
+ We'll notify you when updates are available via the Android Developers
+ Blog, as well as via this site and the <a href=
+ "http://g.co/androidweardev">Android Wear Developer Community on G+</a>.
+ </p>
+
+ <h2 id="what's_in_the_android_wear_2_0_developer_preview">
+ What's in the Android Wear 2.0 Developer Preview
+ </h2>
+
+ <p>
+ The preview includes everything you need to test your existing apps on a
+ variety of hardware configurations.
+ </p>
+
+ <h3 id="developer_resources">
+ Developer resources
+ </h3>
+
+ <p>
+ You can download these components through the SDK Manager in <a href=
+ "{@docRoot}sdk/installing/adding-packages.html">Android Studio</a>. For
+ more information, see <a href=
+ "{@docRoot}wear/preview/downloads.html">Download and Test with a
+ Device</a>.
+ </p>
+
+ <ul>
+ <li>Android Wear 2.0 Developer Preview <strong>SDK/support
+ library</strong>
+ </li>
+
+ <li>Android Wear 2.0 Developer Preview <strong>emulator system
+ image</strong>
+ </li>
+ </ul>
+
+ <p>
+ We'll provide updates to these development tools at each milestone as
+ needed.
+ </p>
+
+ <h3 id="hardware_system_images">
+ Hardware system images
+ </h3>
+
+ <p>
+ You can download these hardware system images for Nexus devices from the
+ Downloads page:
+ </p>
+
+ <ul>
+ <li>LG Watch Urbane 2nd Edition “nemo”
+ </li>
+
+ <li>Huawei Watch “sturgeon”
+ </li>
+ </ul>
+
+ <h3 id="documentation_and_sample_code">
+ Documentation and sample code
+ </h3>
+
+ <p>
+ These documentation resources help you learn about the preview:
+ </p>
+
+ <ul>
+ <li>[comment placeholder] Get Started has step-by-step instructions for
+ setting up the SDK.
+ </li>
+
+ <li>Documentation of new APIs, including an API Overview, downloadable
+ API Reference, and developer guides on key features such as
+ complications, design patterns for Wear, and building standalone Android
+ Wear apps.
+ </li>
+
+ <li>Sample code that demonstrates how to implement [comment placeholder]
+ complications and other new features.
+ </li>
+ </ul>
+
+ <h3 id="support_resources">
+ Support Resources
+ </h3>
+
+ <p>
+ Use these support resources as you test and develop on the Android Wear
+ 2.0 Developer Preview:
+ </p>
+
+ <ul>
+ <li>Wear Developer Preview Issue Tracker is your primary feedback
+ channel. You can report bugs, performance issues, and general feedback
+ through the issue tracker. You can also check for known issues and find
+ workaround steps.
+ </li>
+
+ <li>The <a href="http://g.co/androidweardev">Wear Developer Community</a>
+ is a Google+ community where you can connect with other developers
+ working with Android Wear. You can share observations or ideas or find
+ answers to questions about Android Wear.
+ </li>
+ </ul>
diff --git a/docs/html/wear/preview/start.jd b/docs/html/wear/preview/start.jd
new file mode 100644
index 0000000..04b9fe6
--- /dev/null
+++ b/docs/html/wear/preview/start.jd
@@ -0,0 +1,210 @@
+page.title=Get Started with the Android Wear 2.0 Developer Preview
+meta.keywords="wear-preview"
+page.tags="wear-preview"
+page.image=images/cards/card-n-sdk_2x.png
+
+@jd:body
+
+
+ <div id="qv-wrapper">
+ <div id="qv">
+ <ol>
+ <li>
+ <a href="#install_android_studio_and_the_latest_packages">Install
+ Android Studio and the Latest Packages</a>
+ </li>
+
+ <li>
+ <a href="#get_the_preview_reference_documentation">Get the Preview
+ Reference Documentation</a>
+ </li>
+
+ <li>
+ <a href="#update_or_create_a_project">Update or Create a
+ Project</a>
+ </li>
+ </ol>
+ </div>
+ </div>
+
+ <p>
+ If you want an environment for basic <strong>compatibility
+ testing</strong> of your app, you can use your current APK and a
+ supported watch or an emulator. You don't necessarily need to update your
+ full development environment to do basic testing. To simply test your
+ app's compatibility with a preview system image, see <a href=
+ "{@docRoot}wear/preview/downloads.html">Download and Test with a
+ Device</a>.
+ </p>
+
+ <p>
+ However, to develop apps for the Android Wear 2.0 Developer Preview, you
+ need to make some updates to your development environment, as described
+ below.
+ </p>
+
+ <h2 id="install_android_studio_and_the_latest_packages">
+ Install Android Studio and the Latest Packages
+ </h2>
+
+ <p>
+ 1. For compatibility with the <a href="{@docRoot}preview/overview.html">N
+ Developer Preview</a>, follow the <a href=
+ "{@docRoot}preview/setup-sdk.html">setup instructions</a> for installing
+ the latest version of Android Studio.
+ </p>
+
+ <p>
+ 2. Use the <a href="{@docRoot}tools/help/sdk-manager.html">SDK
+ manager</a> to install or confirm that you have the latest installations
+ of the following packages:
+ </p>
+
+ <ul>
+ <li>Under the <strong>SDK Platforms tab</strong>:
+ <ul>
+ <li>Android N Preview
+ </li>
+ </ul>
+ </li>
+
+ <li>Under the <strong>SDK Tools tab</strong>:
+ <ul>
+ <li>Android Support Library
+ </li>
+
+ <li>Google Play services
+ </li>
+
+ <li>Google Repository
+ </li>
+
+ <li>Android Support Repository
+ </li>
+ </ul>
+ </li>
+ </ul>
+
+ <h2 id="get_the_preview_reference_documentation">
+ Get the Preview Reference Documentation
+ </h2>
+
+ <p>
+ Detailed information about the preview is available in the preview
+ reference documentation, which you can download from the following table.
+ The zip file includes an updated API reference for the preview.
+ </p>
+
+ <table>
+ <tr>
+ <th scope="col">
+ Reference documentation
+ </th>
+ <th scope="col">
+ Notes
+ </th>
+ </tr>
+
+ <tr>
+ <td>
+ [zip file name]
+ </td>
+ <td>
+ </td>
+ </tr>
+ </table>
+
+ <h2 id="update_or_create_a_project">
+ Update or Create a Project
+ </h2>
+
+ <p>
+ To use the APIs, your project must be configured appropriately in Android
+ Studio.
+ </p>
+
+ <h3 id="update_an_existing_project">
+ Update an existing project
+ </h3>
+
+ <p>
+ To update an existing project for development:
+ </p>
+
+ <ol>
+ <li>Start Android Studio, click <strong>Open an existing Android Studio
+ Project</strong>, and select a project.
+ </li>
+
+ <li>If prompted by the Android SDK Manager for the SDK version to use for
+ the project, select <strong>Use</strong> <strong>Android Studio's
+ SDK</strong>. <//li>
+ </li>
+
+ <li>If prompted to update the Gradle plugin, update the version of the
+ plugin.
+ </li>
+
+ <li>In the <code>build.gradle</code> file for the Wear module, in the
+ <code>dependencies</code> section, update the existing reference to the
+ Wearable Support Library (for example, <code>compile
+ 'com.google.android.support:wearable:1.4.0'</code>) by changing it to the
+ following, which requires that your the Google Repository <a href=
+ "#install_android_studio_and_the_latest_packages">is the latest
+ version</a>::
+
+ <pre>
+ compile 'com.google.android.support:wearable:2.0.0-alpha1'
+
+</pre>
+ </li>
+
+ <li>See the following page for setting up a watch or emulator with a
+ preview system image, in order to begin testing your app: <a href=
+ "{@docRoot}wear/preview/downloads.html">Download and Test with a
+ Device</a>
+ </li>
+ </ol>
+
+ <h3 id="create_a_new_project">
+ Create a new project
+ </h3>
+
+ <p>
+ To create a new project for development:
+ </p>
+
+ <ol>
+ <li>Click <strong>File > New Project</strong> and follow the steps in
+ the Create New Project wizard until you reach the Target Android Devices
+ page.
+ </li>
+
+ <li>Optionally, select the <strong>Phone and Tablet</strong> option. If
+ you plan to use N Preview APIs in a phone app, then the Minimum SDK
+ option list, select <strong>API N: Android 6.x (N Preview)</strong>.
+ </li>
+
+ <li>Select the <strong>Wear</strong> option, and in the Minimum SDK
+ option list, select the latest available (<strong>N Preview</strong>)
+ option. Click <strong>Next</strong> until you exit the Create New Project
+ wizard.
+ </li>
+
+ <li>In the <code>build.gradle</code> file for the Wear module, in the
+ <code>dependencies</code> section, update the existing reference to the
+ Wearable Support Library (perhaps <code>compile
+ 'com.google.android.support:wearable:1.4.0'</code>) to:
+
+ <pre>
+ compile 'com.google.android.support:wearable:2.0.0-alpha1'
+
+</pre>
+ </li>
+
+ <li>See the following page for setting up a watch or emulator with a
+ preview system image, in order to begin testing your app: <a href=
+ "{@docRoot}wear/preview/downloads.html">Download and Test with a
+ Device</a>
+ </li>
+ </ol>
diff --git a/docs/html/wear/wear_toc.cs b/docs/html/wear/wear_toc.cs
index 65ac2e9..93f554f 100644
--- a/docs/html/wear/wear_toc.cs
+++ b/docs/html/wear/wear_toc.cs
@@ -1,74 +1,53 @@
<ul id="nav">
<li class="nav-section">
- <div class="nav-section-header empty"><a href="<?cs var:toroot ?>wear/preview/start.html">Get Started
- </a></div>
+ <div class="nav-section-header empty">
+ <a href="<?cs var:toroot ?>wear/preview/index.html">
+ Wear Developer Preview
+ </a></div>
</li>
<li class="nav-section">
- <div class="nav-section-header empty"><a href="<?cs var:toroot ?>wear/design/user-interface.html">UI Overview
- </a></div>
+ <div class="nav-section-header empty">
+ <a href="<?cs var:toroot ?>wear/preview/program.html">
+ Program Overview
+ </a></div>
</li>
<li class="nav-section">
- <div class="nav-section-header empty"><a href="<?cs var:toroot ?>wear/design/index.html">Design Principles
- </a></div>
+ <div class="nav-section-header">
+ <a href="<?cs var:toroot ?>wear/preview/api-overview.html">
+ API Overview
+ </a></div>
+
+ <ul>
+ <li><a href="<?cs var:toroot ?>wear/preview/features/wear-apk.html">
+ Wear APKs</a></li>
+ <li><a href="<?cs var:toroot ?>wear/preview/features/complications.html">
+ Complications</a></li>
+ </ul>
+
</li>
<li class="nav-section">
- <div class="nav-section-header empty"><a href="<?cs var:toroot ?>wear/notifications/creating.html">Creating Notifications for Android Wear
- </a></div>
+ <div class="nav-section-header empty">
+ <a href="<?cs var:toroot ?>wear/preview/downloads.html">
+ Downloads
+ </a></div>
</li>
<li class="nav-section">
- <div class="nav-section-header empty"><a href="<?cs var:toroot ?>wear/notifications/remote-input.html">Receiving Voice Input from a Notification
- </a></div>
+ <div class="nav-section-header empty">
+ <a href="<?cs var:toroot ?>wear/preview/start.html">
+ Get Started
+ </a></div>
</li>
<li class="nav-section">
- <div class="nav-section-header empty"><a href="<?cs var:toroot ?>wear/notifications/pages.html">Adding Pages to a Notification
- </a></div>
+ <div class="nav-section-header empty">
+ <a href="<?cs var:toroot ?>wear/preview/license.html">
+ License Agreement
+ </a></div>
</li>
- <li class="nav-section">
- <div class="nav-section-header empty"><a href="<?cs var:toroot ?>wear/notifications/stacks.html">Stacking Notifications
- </a></div>
- </li>
-
- <li class="nav-section">
- <div class="nav-section-header"><a href="<?cs var:toroot ?>reference/android/preview/support/package-summary.html">Notification Reference</a></div>
- <ul class="tree-list-children">
-<li class="nav-section">
-<div class="nav-section-header-ref"><span class="tree-list-subtitle package" title="android.preview.support.v4.app">android.preview.support.v4.app</span></div>
- <ul>
-<li><a href="<?cs var:toroot ?>reference/android/preview/support/v4/app/NotificationManagerCompat.html">NotificationManagerCompat</a></li>
- </ul>
-</li>
-
-<li class="nav-section">
-<div class="nav-section-header-ref"><span class="tree-list-subtitle package" title="android.preview.support.wearable.notifications">android.preview.support.wearable.notifications</span></div>
-<ul>
-
-<li><a href="<?cs var:toroot ?>reference/android/preview/support/wearable/notifications/RemoteInput.html">RemoteInput</a></li>
-<li><a href="<?cs var:toroot ?>reference/android/preview/support/wearable/notifications/RemoteInput.Builder.html" >RemoteInput.Builder</a></li>
-
-<li><a href="<?cs var:toroot ?>reference/android/preview/support/wearable/notifications/WearableNotifications.html">WearableNotifications</a></li>
-
-<li><a href="<?cs var:toroot ?>reference/android/preview/support/wearable/notifications/WearableNotifications.Action.html">WearableNotifications.Action</a></li>
-
-<li><a href="<?cs var:toroot ?>reference/android/preview/support/wearable/notifications/WearableNotifications.Action.Builder.html">WearableNotifications.Action.Builder</a></li>
-
-<li><a href="<?cs var:toroot ?>reference/android/preview/support/wearable/notifications/WearableNotifications.Builder.html">WearableNotifications.Builder</a></li>
- </ul>
- </li>
-</ul>
-</li>
-
-
-
- <li class="nav-section">
- <div class="nav-section-header empty"><a href="<?cs var:toroot ?>wear/license.html">License Agreement</a></div>
- </li>
-
-
</ul>
