- To run and test your app with the Wear Developer Preview, you need to set up - a runtime environment. You can do that in either of these ways: -
++ You can run and test your app with the Android Wear 2.0 Developer Preview + in either of these ways: +
-- If you want an environment for basic compatibility testing of your app on the - new platform, all you need is your current APK and a hardware device or - emulator. You don't necessarily need to update your full development - environment to do basic testing. -
+- If you want to modify your app to target the Wear Preview or use the Wear - Preview APIs, you need to set up a development environment that's updated - to support the Wear Preview. For more information, see - Get Started with Wear 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. As described below, you don't necessarily + need to update your full development environment to do basic testing. +
-+ However, if you want to modify your app to target + Android Wear 2.0 or use new APIs, you need to update your development + environment. See Get Started + with the Android Wear 2.0 Preview. +
++ 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. +
-+ 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. +
-- Detailed information about the Wear Preview APIs is available in the - reference documentation, which you can download from the following table. - This package contains an abridged, offline version of the Android developer - web site, and includes an updated API reference for the Wear Preview APIs - and an API difference report. -
++ Installing a system image on a watch removes all data from the + watch, so you should back up your data first. +
-| Documentation | -Checksums | -
|---|---|
| - n-preview-1-docs.zip | -
- MD5: 4ab33ccbe698f46f125cc5b807cf9c2f - SHA-1: 6a3880b3ccd19614daae5a4d0698ea6ae11c20a5 - |
-
| Device | -Download / Checksums | -
|---|---|
| Gear Live "sprat" |
- sprat-XXXXX-preview-d86c7559.tgz - MD5: d84b6c31a7754e505149594887b3481a - SHA-1: d86c7559c93724cca6af91040b012c48529f2c94 - |
-
| + Type of LGE Watch Urbane 2nd Edition image + | ++ Download/Checksums + | +
|---|---|
| + Preview image for testing + | +download-3-placeholder.tgz + MD5: [string] + SHA-1: [string] + |
+
| + Non-preview image (for after testing) + | +download-4-placeholder.tgz + MD5: [string] + SHA-1: [string] + |
+
+ Please note the following: + Flashing your device will require unlocking + the bootloader which + shall void the device's warranty--proceed at your own risk. +
+| + Type of Huawei Watch image + | ++ Download/Checksums + | +
|---|---|
| + Preview image for testing + | +download-1-placeholder.tgz + MD5: [string] + SHA-1: [string] + |
+
| + Non-preview image (for after testing) + | +download-2-placeholder.tgz + MD5: [string] + SHA-1: [string] + |
+
- The Wear Developer Preview offers system updates for a range of hardware devices - that you can use for testing your app, from phones to tablets and TV. -
++ The steps for flashing an image to a watch are similar to the steps provided for + flashing to a phone. After you back up your watch + data, use steps in this section to flash the image to the + specific watch that matches the image (e.g., you must + use an LGE Watch Urbane 2nd Edition for the corresponding image). +
++ On the watch, enable the Developer Options menu and ADB debugging as + follows: +
-- At any time you can download the latest Developer Preview system image and - manually flash it to your device. See the table below to download the system - image for your test device. Manually flashing a device is useful if you need - precise control over the test environment or need to reinstall frequently, - such as for automated testing. -
+- Installing a system image on a device removes all data from the - device, so you should back up your data first. -
+- After you back up your device data and download the system image below that - matches your device, follow the instructions at developers.google.com/android - to flash the image onto your device. -
+- If you want to uninstall the preview from a device, you can do so in one of - these ways:
-- The device will receive an OTA update to the most recent production version - of Android available for that device (for example, Android 6.0 Marshmallow). - The update requires a full device reset, so user data on the device will be - removed. Make sure to back up important data before - un-enrolling a device. -
-
+ To flash a device using one of the system images, confirm that you have the
+ fastboot tool in the platform-tools/ directory
+ of the Android SDK. Be
+ sure that you have the latest version of the Android SDK
+ Platform-tools from the SDK Manager.
+
Note: - Uninstalling a Developer Preview system image prior to - the end of the program requires a full device reset and removes all user data - on the device. -
+
+ After you confirm that you have the fastboot tool, add the
+ tool to your PATH environment variable so the tool can be found when you
+ flash the watch.
+
+ To download a preview image and flash it to the watch: +
-To use the Android Emulator to run the Wear Preview, you need to -download the Wear Preview SDK and create a virtual device for the -emulator.
+First, download the Wear Preview SDK as follows (if you -already got it while setting up -to develop for Android N, you can skip this part): +
adb devices
+ adb reboot bootloader
+ fastboot flashing unlock or, for some
+ devices, fastboot oem unlock
+ You should now have Android SDK Built-Tools 24.0 0 rc1, -Platform-Tools 24.0.0 rc1, and SDK Tools -25.0.9. If you do not update the SDK Tools to 25.0.9, then you won't -be able to run the x86_64 system images for Android N.
+flash-all script by typing
+ flash-all.sh or, in the case of Windows,
+ flash-all.bat.
+ + 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: +
-Now create a virtual device with the Wear Preview system image:
+You can now launch the Android Emulator with the Wear Preview AVD.
+-For the best experience in the Android Emulator, install -Android Studio 2.2 Preview, which supports the Android Emulator 2.0 Beta -with much faster performance compared to the Emulator in -Android Studio 1.5.
+For more information about creating virtual devices, see Managing Virtual Devices. -
++ Your watch is ready for you to install and run + your app: +
- ++ After your app is installed on the watch, you are prompted to start the + app on the watch. +
+ ++ When testing is completed, follow the steps for uninstalling the preview. +
+ ++ When testing with the preview is done, restore the watch as follows: +
+ ++ Note: Removing a preview system image requires a full + device reset and removes all user data on the device. +
+ ++ To test with the Android Emulator, create a virtual device in Android + Studio as follows: +
+ ++ You can now test an application in the Android Emulator. For more + information about using virtual devices, see Managing AVDs with the AVD + Manager. +
+ - + \ 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. -
++ Run and test your apps on a range of devices or on an emulator. +
+- 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. +
++ 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. -
++ Start work early to support new platform behaviors such as + complications and Material Design for Wear. +
+- 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. +
+- Thank you for participating in the Android Wear Developer Preview program! -
++ 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+. +
+ ++ The preview includes everything you need to test your existing apps on a + variety of hardware configurations. +
+ ++ 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. +
+ ++ You can download these hardware system images for Nexus devices from the + Downloads page: +
+ ++ These documentation resources help you learn about the preview: +
+ ++ Use these support resources as you test and develop on the Android Wear + 2.0 Developer Preview: +
+ +- 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. -
++ 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): -
++ 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: +
+To start developing with Wear Preview APIs, you need to install the -Wear Preview SDK in Android Studio as follows:
++ 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. +
-| + Reference documentation + | ++ Notes + | +
|---|---|
| + [zip file name] + | ++ | +
- 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. +
++ To update an existing project for development: +
-Open the
- build.gradle file for your module and update the values as
- follows:
-
-android {
- compileSdkVersion '23'
- buildToolsVersion '24.0.1-rc1'
- ...
+ 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::
-+ compile 'com.google.android.support:wearable:2.0.0-alpha1' -+To create a new project for development with the Wear Preview SDK:
+
+ To create a new project for development: +
+ +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' + ++