From aae171371b044d4efe4b58589f3b04f000016cec Mon Sep 17 00:00:00 2001 From: Robert Ly Date: Wed, 28 Nov 2012 14:04:29 -0800 Subject: docs: update gms toc and landing pages Change-Id: I2d55026d492356b70de2071c96786b6dadb5938a --- docs/html/google/google_toc.cs | 27 +- docs/html/google/play-services/download.jd | 140 --- docs/html/google/play-services/index.jd | 146 ++- docs/html/google/play-services/maps.jd | 6 +- docs/html/google/play-services/plus.jd | 4 +- docs/html/google/play-services/setup.jd | 142 +++ docs/html/images/google/gps.png | Bin 0 -> 641296 bytes docs/html/images/gps-analytics.png | Bin 7276 -> 0 bytes docs/html/images/gps-maps.png | Bin 96526 -> 0 bytes docs/html/images/gps-plus.png | Bin 28391 -> 0 bytes docs/html/images/gps-small.png | Bin 13986 -> 0 bytes docs/html/images/gps.png | Bin 138100 -> 0 bytes .../play-services-diagram.graffle/data.plist | 1020 ------------------- .../play-services-diagram.graffle/image3.png | Bin 59774 -> 0 bytes .../play-services-diagram.graffle/image4.png | Bin 4535 -> 0 bytes .../play-services-diagram.graffle/image5.pdf | Bin 43222 -> 0 bytes .../play-services-diagram.graffle/image8.tiff | Bin 22904 -> 0 bytes docs/html/images/play-services-diagram.png | Bin 35166 -> 38589 bytes .../play-services-diagram.graffle/data.plist | 1049 ++++++++++++++++++++ .../play-services-diagram.graffle/image1.png | Bin 0 -> 59774 bytes .../play-services-diagram.graffle/image2.png | Bin 0 -> 4535 bytes .../play-services-diagram.graffle/image3.tiff | Bin 0 -> 13936 bytes .../play-services-diagram.graffle/image4.tiff | Bin 0 -> 13370 bytes .../play-services-diagram.graffle/image5.png | Bin 0 -> 118384 bytes 24 files changed, 1308 insertions(+), 1226 deletions(-) delete mode 100644 docs/html/google/play-services/download.jd create mode 100644 docs/html/google/play-services/setup.jd create mode 100644 docs/html/images/google/gps.png delete mode 100644 docs/html/images/gps-analytics.png delete mode 100644 docs/html/images/gps-maps.png delete mode 100644 docs/html/images/gps-plus.png delete mode 100644 docs/html/images/gps-small.png delete mode 100644 docs/html/images/gps.png delete mode 100644 docs/html/images/play-services-diagram.graffle/data.plist delete mode 100644 docs/html/images/play-services-diagram.graffle/image3.png delete mode 100644 docs/html/images/play-services-diagram.graffle/image4.png delete mode 100644 docs/html/images/play-services-diagram.graffle/image5.pdf delete mode 100644 docs/html/images/play-services-diagram.graffle/image8.tiff create mode 100644 docs/image_sources/play-services-diagram.graffle/data.plist create mode 100644 docs/image_sources/play-services-diagram.graffle/image1.png create mode 100644 docs/image_sources/play-services-diagram.graffle/image2.png create mode 100644 docs/image_sources/play-services-diagram.graffle/image3.tiff create mode 100644 docs/image_sources/play-services-diagram.graffle/image4.tiff create mode 100644 docs/image_sources/play-services-diagram.graffle/image5.png diff --git a/docs/html/google/google_toc.cs b/docs/html/google/google_toc.cs index d371fa145dc2..0eeff9dc3ed6 100644 --- a/docs/html/google/google_toc.cs +++ b/docs/html/google/google_toc.cs @@ -18,21 +18,14 @@ Google Play services diff --git a/docs/html/google/play-services/download.jd b/docs/html/google/play-services/download.jd deleted file mode 100644 index fb03035654cc..000000000000 --- a/docs/html/google/play-services/download.jd +++ /dev/null @@ -1,140 +0,0 @@ -page.title=Downloading and Configuring the Google Play services SDK -@jd:body - -
- -
- - -

- The Google Play services SDK is an extension to the Android SDK and is available to you as a - downloadable SDK component. This download includes the client library and code samples. -

- -

- Before you get started developing, make sure that you have an updated version of the Android SDK - installed on your computer, including the SDK Tools component. If you don't have the SDK, - visit the SDK Download page - on the Android Developers site. -

- -

- To download and configure the Google Play services SDK: -

- -
    -
  1. - Launch Eclipse and select Window > Android SDK Manager or run android - at the command line. -
  2. -
  3. - Scroll to the bottom of the package list and select Extras > Google Play services. - The add-on is downloaded to your computer and installed in your SDK environment at - <android-sdk-folder>/extras/google/google_play_services/. -
  4. -
  5. - Reference the Google Play services client library project located in - <android-sdk-folder>/extras/google/google_play_services/libproject/google-play-services_lib as - a library project for your Android project. See the - Referencing a Library Project for Eclipse - or Referencing a Library Project on the Command Line - for more information on how to do this. -
  6. -
  7. If you are using ProGuard, add the following - lines in the <project_directory>/proguard-project.txt file: - to prevent ProGuard from stripping away required classes: -
    --keep class * extends java.util.ListResourceBundle {
    -    protected Object[][] getContents();
    -}
    -
    -
- -

Ensuring Devices Have the Google Play services APK

-

- Google Play delivers updates to the majority of the devices that support Google Play services - (Android 2.2 devices with the Google Play Store app installed). However, updates might not reach - supported devices in a timely manner, which are desribed in the following four scenarios: -

-Important: - - Because it is hard to anticipate the state devices are in, you must always check for a - compatible Google Play services APK in your app when you are accessing Google Play services - features. For many apps, this is each time in the - {@link android.app.Activity#onResume onResume()} method of the main activity. - -

-
    -
  1. - A recent version of the Google Play Store app is installed, and the most recent Google Play - services APK has been downloaded. -
  2. -
  3. - A recent version of the Google Play Store app is installed, but the most recent Google Play - services APK has not been downloaded. -
  4. -
  5. - An old version of the Google Play Store app, which does not proactively download Google Play - services updates, is present. -
  6. -
  7. - The Google Play services APK is missing or disabled on the device, which might happen if the - user explicitly uninstalls or disables it. -
  8. -
-

- Case 1 is the success scenario and is the most common. However, because the other scenarios can - still happen, you must handle them every time your app connects to a Google Play service to - ensure that the Google Play services APK is present, up-to-date, and enabled. -

-

- To help you, the Google Play services client library has utility methods to assist in - determining whether or not the Google Play services APK is recent enough to support the - version of the client library that you are using. If not, the client library sends users to the - Google Play Store to download a recent version of the Google Play services APK. -

- -

-Note: - - The Google Play services APK is not visible by searching the Google Play Store. The client - library provides a deep link into the Google Play Store when it detects that the device has a - missing or incompatible Google Play services APK. - -

- -

- It is up to you choose the appropriate place in your app to do the following steps to check for - a valid Google Play services APK. For example, if Google Play services is required for your app, - you might want to do it when your app first launches. On the other hand, if Google Play services - is an optional part of your app, you can do these checks if the user navigates to that portion - of your app: -

- -
    -
  1. - Query for the status of Google Play services on the device with the -isGooglePlayServicesAvailable() - method, which returns a result code. -
  2. -
  3. - If the result code is -SUCCESS, - then the Google Play services APK is up-to-date, and you can proceed as normal. -
  4. -
  5. - If the result is -SERVICE_MISSING, -SERVICE_VERSION_UPDATE_REQUIRED, - or -SERVICE_DISABLED, - call getErrorDialog() - to display an error message to the user, which will then allow the user to download the APK - from the Google Play Store or enable it in the device's system settings. -
  6. -
\ No newline at end of file diff --git a/docs/html/google/play-services/index.jd b/docs/html/google/play-services/index.jd index 60a689d80c9c..61b482605135 100644 --- a/docs/html/google/play-services/index.jd +++ b/docs/html/google/play-services/index.jd @@ -1,37 +1,41 @@ -page.title=Google Maps -page.landing=true -page.landing.intro=Add Google maps to your Android apps and let your users explore the world. Give your users all of the benefits of the Google Maps, but with the customizations that you need for your app and users. -page.landing.link=https://developers.google.com/maps/documentation/android/ -page.landing.link.text=developers.google.com/maps -page.landing.image=images/gps.png +page.title=Google Play services +header.hide=1 @jd:body - -

- Google Play services is a platform delivered through the Google Play Store that - lets you integrate Google products into your Android apps. - The Google Play services framework consists of a services component - that runs on the device and a thin client library that you package with your app. -

+
+ +
+ +
+
+

Google Play services

+

+

-

- -OVERVIEW -

+

Give your apps more features to attract users on a wider range of devices. + With Google Play services, your app can take advantage + of the latest, Google-powered features such as Maps, Google+, and more. + with automatic platform updates distributed as an APK through + the Google Play store. This makes it faster for your users to receive updates + and easier for you to integrate the newest that Google has to offer. +

-
 
+

Setup

-
+
+
+ + +

Google Technology

-

Add exciting and useful Google features such as Maps, Google+, Analytics, and more -to your Android apps. Easy-to-use client libraries are provided for the products in Google -Play services, so you can implement the functionality you want faster. New features -and products are continuously being added, so make sure to check back often.

+

Google Play services provides you with easy access to Google services and is tightly +integrated with the Android OS. Easy-to-use client libraries are provided for +each service that let you implement the functionality you want easier and faster.

@@ -40,37 +44,81 @@ and products are continuously being added, so make sure to check back often.

All products in Google Play services share a common authentication API that leverages the existing Google accounts on the device. You and your users have a consistent and safe way to grant and receive OAuth2 authentication - to Google services. Even services that are not bundled in Google Play services - can take advantage of the authentication APIs as long as they accept OAuth2 - tokens associated with a Google account.

+ to Google services.

Automatic Updates

-

Devices running Android 2.2 and newer and that have the Google Play Store app installed -automatically receive updates to Google Play services. New products, features, and fixes are -automatically pushed to a wide range of devices, old and new. You can now enhance your app with the most -up-to-date version of Google Play services without worrying about your users' Android platform version.

+

Devices running Android 2.2 and newer and that have the Google Play Store +app automatically receive updates to Google Play services. Enhance +your app with the most recent version of Google Play services without worrying +about your users' Android version.

+ +
+
+ + +

How It Works

+

The Google Play services client library

+

+ The client library contains the interfaces to the individual Google + services and allows you to obtain authorization from users to authenticate + to these services with their credentials. It also contains APIs that allow + you to resolve any issues at runtime, such as a missing, disabled, or out-of-date + Google Play services APK. The client library has a light footprint if you use + ProGuard as part of your build process, so it won't have + an adverse impact on your app's file size. +

+

+ If you want to access added features or products, you can upgrade to a new version of the + client library as they are released. However, upgrading is not + necessary if you don't care about new features or bug fixes. + We anticipate more Google services to be continuously added, so be on the lookout for + these updates. +

+ +
 
+ +
+
+

The Google Play services APK

+

+ The Google Play services APK contains the individual Google services and runs + as a background service in the Android OS. You interact with the background service + through the client library and the service carries out the actions on your behalf. + An easy-to-use authentication flow is also + provided to gain access to the each Google service, which provides consistency for both + you and your users. +

+

+ The Google Play services APK is delivered through the Google Play Store, so + updates to the services are not dependent on carrier or OEM system image updates. In general, devices + running Android 2.2 (Froyo) or later and have the Google Play Store app installed receive updates within a + few days. This allows you to use the newest APIs in Google Play services and reach most of the + devices in the Android ecosystem (devices older than Android 2.2 or devices without the Google + Play Store app are not supported). +

+
+ +
+ +

Updates to Google Play services include access to new APIs, features, and bug fixes.

-

Services

- \ No newline at end of file +

The benefits for your app

+ +

Google Play services gives you the freedom to use the newest APIs for popular +Google services without worrying about device support. Updates to Google Play +services are distributed automatically by the Google Play Store and new versions +of the client library are delivered through the Android SDK Manager. This makes it +easy for you to focus on what's important: your users' experience.

+ +

To get started, set up the SDK and check out +the various products in the Google Play services platform now!

+ + + + diff --git a/docs/html/google/play-services/maps.jd b/docs/html/google/play-services/maps.jd index 85a745db2627..d2973c3eceb4 100644 --- a/docs/html/google/play-services/maps.jd +++ b/docs/html/google/play-services/maps.jd @@ -30,7 +30,7 @@ href="https://developers.google.com/maps/documentation/android/">developers.goog