From c85bf85941212bba8d6827397f9572ea9ec8e8ef Mon Sep 17 00:00:00 2001 From: Dirk Dougherty Date: Sun, 24 May 2015 19:56:35 -0700 Subject: [PATCH] Doc change: Updates to preview program overview and tags. Change-Id: I60db437ea5aabe3fad0284726d0e3850828c92a3 --- docs/html-ndk/ndk/index.jd | 2 +- docs/html/develop/index.jd | 9 +- docs/html/distribute/engage/engage_toc.cs | 34 +- docs/html/distribute/engage/index.jd | 8 +- .../distribute/essentials/essentials_toc.cs | 46 ++- docs/html/distribute/essentials/index.jd | 14 +- .../distribute/googleplay/families/about.jd | 32 +- .../distribute/googleplay/googleplay_toc.cs | 29 +- docs/html/distribute/googleplay/index.jd | 2 +- docs/html/distribute/monetize/ads.jd | 3 + docs/html/distribute/monetize/ecommerce.jd | 30 +- docs/html/distribute/monetize/monetize_toc.cs | 8 +- .../html/distribute/tools/launch-checklist.jd | 13 +- docs/html/distribute/users/app-invites.jd | 51 +++ docs/html/distribute/users/index.jd | 2 +- docs/html/distribute/users/users_toc.cs | 33 +- docs/html/google/index.jd | 15 +- docs/html/images/developing/app_invites_2.png | Bin 0 -> 101297 bytes .../distribute/android-pay-checkout.png | Bin 0 -> 74824 bytes docs/html/images/distribute/app_invites_1.png | Bin 0 -> 102035 bytes docs/html/images/distribute/app_invites_2.png | Bin 0 -> 102284 bytes docs/html/images/distribute/dff-browse.png | Bin 159215 -> 165976 bytes .../images/distribute/dff-character-group.png | Bin 0 -> 462972 bytes docs/html/images/home/devices-hero_620px.png | Bin 0 -> 464267 bytes docs/html/index.jd | 4 +- docs/html/jd_collections.js | 82 ++-- docs/html/jd_extras.js | 42 +- docs/html/preview/api-changes.jd | 2 +- docs/html/preview/api-overview.jd | 3 +- docs/html/preview/backup/index.jd | 3 +- docs/html/preview/download.jd | 2 +- .../preview/features/runtime-permissions.jd | 3 +- .../images/m-preview-timeline-crop.png | Bin 0 -> 10205 bytes docs/html/preview/index.jd | 61 ++- docs/html/preview/overview.jd | 373 ++++++++++++++++-- docs/html/preview/preview_toc.cs | 2 +- docs/html/training/index.jd | 25 +- 37 files changed, 688 insertions(+), 245 deletions(-) create mode 100644 docs/html/distribute/users/app-invites.jd create mode 100644 docs/html/images/developing/app_invites_2.png create mode 100644 docs/html/images/distribute/android-pay-checkout.png create mode 100644 docs/html/images/distribute/app_invites_1.png create mode 100644 docs/html/images/distribute/app_invites_2.png create mode 100644 docs/html/images/distribute/dff-character-group.png create mode 100644 docs/html/images/home/devices-hero_620px.png create mode 100644 docs/html/preview/images/m-preview-timeline-crop.png diff --git a/docs/html-ndk/ndk/index.jd b/docs/html-ndk/ndk/index.jd index f97dbef79eb24..8d8f14d0b2940 100644 --- a/docs/html-ndk/ndk/index.jd +++ b/docs/html-ndk/ndk/index.jd @@ -45,7 +45,7 @@ footer.hide=1
diff --git a/docs/html/develop/index.jd b/docs/html/develop/index.jd index 9707c997e6797..17db9e568f65c 100644 --- a/docs/html/develop/index.jd +++ b/docs/html/develop/index.jd @@ -56,9 +56,11 @@ excludeFromSuggestions=true

Latest

@@ -70,10 +72,9 @@ excludeFromSuggestions=true
-
diff --git a/docs/html/distribute/engage/engage_toc.cs b/docs/html/distribute/engage/engage_toc.cs index e1460565e1446..cf024651d9066 100644 --- a/docs/html/distribute/engage/engage_toc.cs +++ b/docs/html/distribute/engage/engage_toc.cs @@ -1,4 +1,10 @@
-
@@ -39,30 +46,6 @@ footer.hide=1 -
-

Resources

-
-
-
-
- - - -
-

Get your apps ready

-
- Resources to help you learn about Android M and get your app ready. -
-
-
- -

Latest

+ + +
+

Resources

+
+ Essential information to help you get your apps ready for Android M. +
+
+
+ diff --git a/docs/html/preview/overview.jd b/docs/html/preview/overview.jd index e235d685b5387..4c13fbc0e721d 100644 --- a/docs/html/preview/overview.jd +++ b/docs/html/preview/overview.jd @@ -1,39 +1,345 @@ -page.title=Preview Program Overview +page.title=Program Overview +page.metaDescription=Welcome to the Android M Developer Preview, a program that gives you everything you need to test and optimize your apps for the next version of Android. page.image=images/cards/card-preview_16-9_2x.png +page.tags="preview", "developer", "android" @jd:body

- The Android M platform is still under development, but we’re offering developers an early look - through the Android M Developer Preview program. This program is an opportunity for you to test - the compatibility of your apps with the next platform release, try out early versions of new API - features, and provide feedback to the Android team. Developers can try out the M Preview system - on with the Android SDK emulator or on Nexus 5, Nexus 6, Nexus 9, and Nexus Player devices. The - program includes update releases during course of the program to allow you to follow the progress - of feature development and fixes, leading up to the official release of the platform. + Welcome to the Android M Developer Preview, a program that gives you + everything you need to test and optimize your apps for the next version of + Android. It's free, and you can get started right away just by downloading + the M Developer Preview tools.

-Preview program timeline -

- Timeline for the M Developer Preview program. +

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

+ Run and test your apps on Nexus 5, 6, 9, and Player (for TV), as well + as emulator. +

+
+ +
+
+ Latest platform code +
+ +

+ We’ll provide multiple updates during the Preview, so you’ll be testing + against the latest platform changes. +

+
+ +
+
+ Updates delivered by OTA +
+ +

+ You can get updates over the air, once you’ve flashed a + device to the initial preview. +

+
+
+ +
+ + + +
+
+ New behaviors and capabilities +
+ +

+ Start work early to support new platform behaviors such as + the new runtime permissions model and power-saving features. +

+
+ +
+
+ Priority window for developer-reported issues +
+ +

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

+
+ +
+
+ Feedback and support channels +
+ +

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

+
+
+
+
+ + + + +

+ Timeline and updates +

++"Preview +

+ The M Developer Preview runs from May 27 until the final Android M SDK, which + we’ll release shortly before the public release during Q3 + 2015.

- We strongly encourage you to provide feedback for the M Preview releases through our issue tracker. Issues reported early - in the program have a better chance of being addressed before the official release, so reports - provided by June 30, 2015 receive priority processing by the Android team. + At key development milestones, we’ll deliver updates for your test devices. + The tentative milestones are

+
    +
  • + Preview 1 (initial Preview release, late May), +
  • + +
  • + Preview 2 (late June/early July), and +
  • + +
  • + Preview 3 (near final, late July) +
  • +
+ +

+ These updates culminate in the final SDK (later in Q3), + which delivers the official APIs for the new version of Android, as well + as the final system behaviors and features. +

+ +

+ As you test and develop on Android M, we strongly recommend keeping + your development environment up-to-date as Preview updates are released. + To make the process easier, we'll deliver updates over the air + (OTA) to devices already flashed to a Preview build, as well as + providing system images that you can download and flash manually. +

+

+ Note: The final SDK and system images can not be delivered + by OTA, but will instead need to be flashed manually to + your test devices. +

+ +

+ We’ll notify you when Preview updates are available via the Android Developers Blog, as + well as this site and the + Android M Developer Community. +

+ +

+ What’s in the Preview? +

+ +

+ The M Developer Preview includes everything you need to test your existing + apps on a variety of screen sizes, network technologies, CPU/GPU chipsets, + and hardware architectures. +

+ +

+ SDK tools +

+ +

+ You can download these components through the SDK Manager in Android Studio: +

+ +
    +
  • M Developer Preview SDK tools +
  • + +
  • M Developer Preview emulator system image (32-bit & + 64-bit) +
  • + +
  • M Developer Preview emulator system Image for Android TV + (32-bit) +
  • +
+ +

+ Hardware system images +

+ +

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

+ +
    +
  • + Nexus 5 (GSM/LTE) “hammerhead” device system image +
  • + +
  • + Nexus 6 “shamu” device system image +
  • + +
  • + Nexus 9 (Wi-Fi) “volantis” device system image +
  • + +
  • + Nexus Player (Android TV) “fugu” device system image +
  • +
+ +

+ 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 M + Developer Preview: +

+ +
    +
  • M + 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, if available. +
  • + +
  • The Android M Developer + Community is a Google+ community where you can connect with + other developers working with Android M. You can share + observations or ideas or find answers to questions about Android M. +
  • +
+ + +

+ Targeting, preview APIs, and publishing +

+ +

+ The Android M Developer Preview is a development-only release and + does not have a standard API level. If you want to opt out + of compatibility behaviors to test your app (which is strongly recommended), + you can target the M Developer Preview by setting your app's targetSdkVersion + to “MNC”. +

+ +

+ The Android M Developer Preview delivers preview APIs + — the APIs will not be official until the final SDK is released, + currently planned for the third quarter of 2015. This means that you can + expect minor API changes over time, especially during + initial weeks of the program. We’ll provide a summary of changes to you with + each update of the Android M Developer Preview. +

+ +

+ Note that although preview APIs may change, underlying system behaviors such + as runtime permissions and power-saving features are stable and ready for + testing right away. +

+ +

+ In terms of publishing, Google Play prevents publishing of apps + targeting the M Developer Preview. When the Android M final SDK is + available, you’ll be able to target the official Android M API level and + publish your app to Google Play. Meanwhile, if you want to distribute an app + targeting Android M to testers, you can do so via email or by direct download + from your site. +

+ +

+ How to get started? +

+

To get started testing your app:

-
    -
  • Review the API Overview and - Behavior Changes to - get an idea of what's new and how it affects your app. +
      +
    1. Review the API Overview + and Behavior Changes to get an + idea of what's new and how it affects your apps.
    2. Setup for testing and development by following the instructions for @@ -41,23 +347,24 @@ page.image=images/cards/card-preview_16-9_2x.png and configuring test devices.
    3. -
    4. You can download the latest M Developer - Preview system image for compatible Nexus devices and install it for testing. Once you have - flashed a development device, it is upgraded automatically with the next preview release - through over-the-air (OTA) updates. +
    5. Follow the + flashing instructions to flash the latest M developer preview system image + for Nexus 5, 6, 9, and Player. Once you've flashed your development device, + Preview updates will be delivered through over-the-air (OTA) updates.
    6. -
    7. Review the M Preview API Reference and - samples to - gain more insight into new API features and how to use them in your app. +
    8. Download the M Preview API + Reference and M Preview + samples to gain more insight into new API features and how to use them in + your app.
    9. -
    10. Join the M Preview Google+ developer - community to get the latest developer updates and connect with other - developers working with the preview. +
    11. Join the Android M + Developer Community to get the latest news and connect with other + developers working with the new platform.
    12. -
+

- Thanks in advance for your participation in the developer preview program! -

+ Thank you for your participation in the Android M Developer Preview program! +

\ No newline at end of file diff --git a/docs/html/preview/preview_toc.cs b/docs/html/preview/preview_toc.cs index 037193235f520..76dfef5cb97cd 100644 --- a/docs/html/preview/preview_toc.cs +++ b/docs/html/preview/preview_toc.cs @@ -7,7 +7,7 @@