From 3ec4cf8068af18ded53f9937a5925311a6817b2e Mon Sep 17 00:00:00 2001 From: Bert McMeen Date: Wed, 11 May 2016 15:34:22 -0700 Subject: [PATCH] docs: Wear preview docs: Get Started, Download/Test, Program Overview Bug: 28317997 Change-Id: I7053f9cc336edecf91a256c31e6650a61ef4ae2d --- docs/html/wear/preview/downloads.jd | 537 ++++++++++++++++++---------- docs/html/wear/preview/program.jd | 285 ++++++++++++--- docs/html/wear/preview/start.jd | 281 +++++++++------ 3 files changed, 757 insertions(+), 346 deletions(-) diff --git a/docs/html/wear/preview/downloads.jd b/docs/html/wear/preview/downloads.jd index 10c1377e47ed0..eea4f111918cf 100644 --- a/docs/html/wear/preview/downloads.jd +++ b/docs/html/wear/preview/downloads.jd @@ -1,10 +1,9 @@ -page.title=Preview Downloads -meta.tags="wear-preview", "system image", "download" -page.tags="wear" -page.image=images/cards/card-n-downloads_2x.png +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 -
- + \ No newline at end of file diff --git a/docs/html/wear/preview/program.jd b/docs/html/wear/preview/program.jd index 17df757b6c061..802e8a84f9ec9 100644 --- a/docs/html/wear/preview/program.jd +++ b/docs/html/wear/preview/program.jd @@ -1,62 +1,255 @@ -page.title=Preview Program Overview -page.metaDescription=Get your apps ready for the next version of Android. -page.image=images/cards/card-n-overview_2x.png -meta.tags="wear", "wear-preview" -page.tags="wear" +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 +

+ 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. +

-

- Welcome to the Wear Developer Preview, a program that - gives you everything you need to test and optimize your apps for the next - version of Android Wear. It's free, and you can get started right away just by - downloading the Wear Developer Preview tools. -

+

+ Program Highlights +

+
+
+
+
+
+ Hardware and emulator images +
+

+ Run and test your apps on a range of devices or on an emulator. +

+
-

Timeline and updates

+
+
+ Latest platform code +
-

- Lorem ipsum dolor sit amet, consul graecis gloriatur in cum. Porro noster ea - nam, omnes tollit facete ut vix. Ut nibh ancillae mei, unum mollis aliquid an - pri. No melius dignissim mel. An eum erant dicit volumus, ut eum animal - convenire. -

+

+ We’ll provide monthly updates during the preview, so you'll be + testing against the latest platform changes. +

+
+
+
+ Priority for developer issues +
-

What's in the Wear Developer Preview?

+

+ During the first several weeks, we'll give priority to + developer-reported issues, so test and give feedback as soon as + possible. +

+
+
-

- Lorem ipsum dolor sit amet, consul graecis gloriatur in cum. Porro noster ea - nam, omnes tollit facete ut vix. Ut nibh ancillae mei, unum mollis aliquid an - pri. No melius dignissim mel. An eum erant dicit volumus, ut eum animal - convenire. -

+
+
+
+ New behaviors and capabilities +
+

+ Start work early to support new platform behaviors such as + complications and Material Design for Wear. +

+
-

How to get started

+
+
+ Feedback and support +
-

- To get started testing your app with the Wear Developer Preview: -

+

+ Report issues and give us feedback using our issue tracker. + Connect with other developers in the Wear Developer Community. +

+
-
    -
  1. Review the API - Overview to - get an idea of what's new and how it affects your apps.
    2. -
  2. Download the preview API documentation and system images from the - Preview Downloads -
    3. -
  3. Set up your environment by following the instructions for Get Started with Wear Preview - and configuring test devices.
    4. -
  4. Join the Android Wear - Developer Community to get the latest news and connect with other - developers working with the new platform.
    5. -
+
+
+
+
+
-

- Thank you for participating in the Android Wear Developer Preview program! -

+

+ Timeline and Updates +

+ +

+ 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. +

+ +

+ 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: +

+ + + +

+ Each update includes an updated support library, preview system images, + emulator, reference documentation, and API diffs. +

+ +

+ 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. +

+ +

+ 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. +

+ +

+ 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. +

+ +

+ We'll notify you when updates are available via the Android Developers + Blog, as well as via this site and the Android Wear Developer Community on G+. +

+ +

+ What's in the Android Wear 2.0 Developer Preview +

+ +

+ The preview includes everything you need to test your existing apps on a + variety of hardware configurations. +

+ +

+ Developer resources +

+ +

+ You can download these components through the SDK Manager in Android Studio. For + more information, see Download and Test with a + Device. +

+ + + +

+ We'll provide updates to these development tools at each milestone as + needed. +

+ +

+ Hardware system images +

+ +

+ You can download these hardware system images for Nexus devices from the + Downloads page: +

+ + + +

+ Documentation and sample code +

+ +

+ These documentation resources help you learn about the preview: +

+ + + +

+ Support Resources +

+ +

+ Use these support resources as you test and develop on the Android Wear + 2.0 Developer Preview: +

+ + diff --git a/docs/html/wear/preview/start.jd b/docs/html/wear/preview/start.jd index ff11700a2b2e5..04b9fe6ed8ed1 100644 --- a/docs/html/wear/preview/start.jd +++ b/docs/html/wear/preview/start.jd @@ -1,4 +1,4 @@ -page.title=Get Started with Wear Preview +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 @@ -6,134 +6,205 @@ page.image=images/cards/card-n-sdk_2x.png @jd:body -
- -
+
+
+
    +
  1. + Install + Android Studio and the Latest Packages +
    2. -

    - To develop apps for the Wear Developer Preview, you need to make some updates - to your developer environment. This page describes how to setup for testing - the Wear Preview APIs with your app. -

    +
  2. + Get the Preview + Reference Documentation +
    3. +
  3. + Update or Create a + Project +
    4. +
+
+
-

Get Android Studio 2.2 (preview)

+

+ If you want an environment for basic compatibility + testing 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 Download and Test with a + Device. +

-

- Android Studio 2.2 is currently available as a preview in the canary release - channel. If you already have Android Studio and don't want to update to the - canary channel, you can download Android Studio 2.2 as a separate - installation and use it for development with the Wear Developer Preview, - leaving your primary Android Studio environment unaffected. -

+

+ 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. +

-

- To download Android Studio 2.2 as a separate installation, follow these steps - (or if you want to receive Android Studio 2.1 as an update to your existing - installation, skip to step 4): -

+

+ Install Android Studio and the Latest Packages +

-
    -
  1. Edit the name of your - existing Android Studio installation and append the version number. This way, - when you install the new version, it will not override the existing one.
    2. -
  2. Download the appropriate ZIP file for your operating system from the - canary channel download page. -
    3. -
  3. Unzip the package and move the Android Studio 2.1 contents to the - appropriate location for applications on your system, then launch it.
    4. -
  4. Open the Settings dialog - (File > Settings on Windows/Linux, or - Android Studio > Preferences on Mac). In the left - panel, select Appearance & Behavior > System Settings > - Updates. -
    5. -
  5. On the Updates panel, select the Automatically - check updates for check box and select - Canary Channel from the drop-down list. -
    6. -
+

+ 1. For compatibility with the N + Developer Preview, follow the setup instructions for installing + the latest version of Android Studio. +

-

Keep this settings window open for the next step.

+

+ 2. Use the SDK + manager to install or confirm that you have the latest installations + of the following packages: +

+ -
  • Click the SDK Platforms tab, then select the - Wear Preview check box.
    • +

    + Get the Preview Reference Documentation +

    -
  • Click the SDK Tools tab, then select the - Android SDK Build Tools, Android SDK - Platform-Tools, and Android SDK Tools check - boxes. -
    • +

    + 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. +

    -
  • Click OK, then accept the licensing - agreements for any packages that need to be installed. -
    • - + + + + + + + + + +
    + Reference documentation + + Notes +
    + [zip file name] + +
    -

    Update or Create a Project

    +

    + Update or Create a Project +

    -

    - To use the Wear Preview APIs, your project must be configured appropriately. -

    +

    + To use the APIs, your project must be configured appropriately in Android + Studio. +

    +

    + Update an existing project +

    -

    Update an existing project

    +

    + To update an existing project for development: +

    -

    Open the - build.gradle file for your module and update the values as - follows: -

    +
      +
    1. Start Android Studio, click Open an existing Android Studio + Project, and select a project. +
      2. -
      -android {
-  compileSdkVersion '23'
-  buildToolsVersion '24.0.1-rc1'
-  ...
+      
    2. If prompted by the Android SDK Manager for the SDK version to use for
+      the project, select Use Android Studio's
+      SDK. <//li>
+      
      3. 
 
-  defaultConfig {
-     minSdkVersion '23'
-     targetSdkVersion '23'
-     ...
-  }
-  ...
-}
      +
    3. If prompted to update the Gradle plugin, update the version of the + plugin. +
      4. +
    4. In the build.gradle file for the Wear module, in the + dependencies section, update the existing reference to the + Wearable Support Library (for example, compile + 'com.google.android.support:wearable:1.4.0') by changing it to the + following, which requires that your the Google Repository is the latest + version:: -

      Create a new project

      + 
      +        compile 'com.google.android.support:wearable:2.0.0-alpha1'
 
-
      To create a new project for development with the Wear Preview SDK:
      
+
      +
      5. -
        -
      1. Click File > New Project. and follow the steps until - you reach the Target Android Devices page. -
        2. -
      2. On this page, select Wear option.
        3. -
      3. Under Wear option, in the Minimum - SDK option list, select - API 23: Android API 6.0 (Wear Preview).
        4. -
      +
    5. See the following page for setting up a watch or emulator with a + preview system image, in order to begin testing your app: Download and Test with a + Device +
      6. +
    + +

    + Create a new project +

    + +

    + To create a new project for development: +

    + +
      +
    1. Click File > New Project and follow the steps in + the Create New Project wizard until you reach the Target Android Devices + page. +
      2. + +
    2. Optionally, select the Phone and Tablet option. If + you plan to use N Preview APIs in a phone app, then the Minimum SDK + option list, select API N: Android 6.x (N Preview). +
      3. + +
    3. Select the Wear option, and in the Minimum SDK + option list, select the latest available (N Preview) + option. Click Next until you exit the Create New Project + wizard. +
      4. + +
    4. In the build.gradle file for the Wear module, in the + dependencies section, update the existing reference to the + Wearable Support Library (perhaps compile + 'com.google.android.support:wearable:1.4.0') to: + + 
      +      compile 'com.google.android.support:wearable:2.0.0-alpha1'
+
+
      +
      5. + +
    5. See the following page for setting up a watch or emulator with a + preview system image, in order to begin testing your app: Download and Test with a + Device +
      6. +