Summary: Constants | Fields | Methods | Inherited Methods | [Expand All]
public final class

# GooglePlayServicesUtil

extends Object

java.lang.Object
↳ | com.google.android.gms.common.GooglePlayServicesUtil

## Class Overview

Utility class for verifying that the Google Play services APK is available and up-to-date on this device. The same checks are performed if one uses `AdvertisingIdClient` or `GoogleAuthUtil` to connect to the service.

## Summary

Constants
String | GMS_ERROR_DIALOG |
String | GOOGLE_PLAY_SERVICES_PACKAGE | This constant is deprecated. Use `GOOGLE_PLAY_SERVICES_PACKAGE` instead.
String | GOOGLE_PLAY_STORE_PACKAGE | Package name for Google Play Store.

Fields
public static final int | GOOGLE_PLAY_SERVICES_VERSION_CODE | This field is deprecated. Use `GOOGLE_PLAY_SERVICES_VERSION_CODE` instead.

Public Methods
static Dialog | getErrorDialog(int errorCode, Activity activity, int requestCode) This method is deprecated. Use `getErrorDialog(Activity, int, int)` instead.
static Dialog | getErrorDialog(int errorCode, Activity activity, int requestCode, DialogInterface.OnCancelListener cancelListener) This method is deprecated. Use `getErrorDialog(Activity, int, int, OnCancelListener)` instead.
static PendingIntent | getErrorPendingIntent(int errorCode, Context context, int requestCode) This method is deprecated. Use `getErrorResolutionPendingIntent(Context, ConnectionResult)` instead.
static String | getErrorString(int errorCode) This method is deprecated. Use `getErrorString(int)` instead.
static String | getOpenSourceSoftwareLicenseInfo(Context context) This method is deprecated. Use `getOpenSourceSoftwareLicenseInfo(Context)` instead.
static Context | getRemoteContext(Context context) This gets the Context object of the Buddy APK.
static Resources | getRemoteResource(Context context) This gets the Resources object of the Buddy APK.
static int | isGooglePlayServicesAvailable(Context context) This method is deprecated. Use `isGooglePlayServicesAvailable(Context)` instead.
static boolean | isUserRecoverableError(int errorCode) This method is deprecated. Use `isUserResolvableError(int)` instead.
static boolean | showErrorDialogFragment(int errorCode, Activity activity, int requestCode, DialogInterface.OnCancelListener cancelListener) This method is deprecated. Use `showErrorDialogFragment(Activity, int, int, OnCancelListener)` instead.
static boolean | showErrorDialogFragment(int errorCode, Activity activity, Fragment fragment, int requestCode, DialogInterface.OnCancelListener cancelListener)
static boolean | showErrorDialogFragment(int errorCode, Activity activity, int requestCode) This method is deprecated. Use `showErrorDialogFragment(Activity, int, int)` instead.
static void | showErrorNotification(int errorCode, Context context) This method is deprecated. Use `showErrorNotification(Context, int)` instead.

[Expand] Inherited Methods
From class java.lang.Object
Object | clone()
boolean | equals(Object arg0)
void | finalize()
final Class<?> | getClass()
int | hashCode()
final void | notify()
final void | notifyAll()
String | toString()
final void | wait(long arg0, int arg1)
final void | wait(long arg0)
final void | wait()

## Constants

#### public static final String GMS_ERROR_DIALOG

Constant Value: "GooglePlayServicesErrorDialog"

#### public static final String GOOGLE_PLAY_SERVICES_PACKAGE

This constant is deprecated.
Use `GOOGLE_PLAY_SERVICES_PACKAGE` instead.

Package name for Google Play services.

Constant Value: "com.google.android.gms"

#### public static final String GOOGLE_PLAY_STORE_PACKAGE

Package name for Google Play Store.

Constant Value: "com.android.vending"

## Fields

#### public static final int GOOGLE_PLAY_SERVICES_VERSION_CODE

This field is deprecated.
Use `GOOGLE_PLAY_SERVICES_VERSION_CODE` instead.

Google Play services client library version (declared in library's AndroidManifest.xml android:versionCode).

## Public Methods

#### public static Dialog getErrorDialog (int errorCode, Activity activity, int requestCode)

This method is deprecated.
Use `getErrorDialog(Activity, int, int)` instead.

Returns a dialog to address the provided errorCode. The returned dialog displays a localized message about the error and upon user confirmation (by tapping on dialog) will direct them to the Play Store if Google Play services is out of date or missing, or to system settings if Google Play services is disabled on the device.

##### Parameters

errorCode | error code returned by `isGooglePlayServicesAvailable(Context)` call. If errorCode is `SUCCESS` then null is returned.
activity | parent activity for creating the dialog, also used for identifying language to display dialog in.
requestCode | The requestCode given when calling startActivityForResult.

#### public static Dialog getErrorDialog (int errorCode, Activity activity, int requestCode, DialogInterface.OnCancelListener cancelListener)

This method is deprecated.
Use `getErrorDialog(Activity, int, int, OnCancelListener)` instead.

Returns a dialog to address the provided errorCode. The returned dialog displays a localized message about the error and upon user confirmation (by tapping on dialog) will direct them to the Play Store if Google Play services is out of date or missing, or to system settings if Google Play services is disabled on the device.

##### Parameters

errorCode | error code returned by `isGooglePlayServicesAvailable(Context)` call. If errorCode is `SUCCESS` then null is returned.
activity | parent activity for creating the dialog, also used for identifying language to display dialog in.
requestCode | The requestCode given when calling startActivityForResult.
cancelListener | The `DialogInterface.OnCancelListener` to invoke if the dialog is canceled.

#### public static PendingIntent getErrorPendingIntent (int errorCode, Context context, int requestCode)

This method is deprecated.
Use `getErrorResolutionPendingIntent(Context, ConnectionResult)` instead.

Returns a PendingIntent to address the provided errorCode. It will direct them to one of the following places to either the Play Store if Google Play services is out of date or missing, or system settings if Google Play services is disabled on the device.

##### Parameters

errorCode | error code returned by `isGooglePlayServicesAvailable(Context)` call. If errorCode is `SUCCESS` then null is returned.
context | parent context for creating the PendingIntent.
requestCode | The requestCode given when calling startActivityForResult.

#### public static String getErrorString (int errorCode)

This method is deprecated.
Use `getErrorString(int)` instead.

Returns a human-readable string of the error code returned from `isGooglePlayServicesAvailable(Context)`.

#### public static String getOpenSourceSoftwareLicenseInfo (Context context)

This method is deprecated.
Use `getOpenSourceSoftwareLicenseInfo(Context)` instead.

Returns the open source software license information for the Google Play services application, or null if Google Play services is not available on this device.

#### public static Context getRemoteContext (Context context)

This gets the Context object of the Buddy APK. This loads the Buddy APK code from the Buddy APK into memory. This returned context can be used to create classes and obtain resources defined in the Buddy APK.

##### Returns

- The Context object of the Buddy APK or null if the Buddy APK is not installed on the device.

#### public static Resources getRemoteResource (Context context)

This gets the Resources object of the Buddy APK.

##### Returns

- The Resources object of the Buddy APK or null if the Buddy APK is not installed on the device.

#### public static int isGooglePlayServicesAvailable (Context context)

This method is deprecated.
Use `isGooglePlayServicesAvailable(Context)` instead.

Verifies that Google Play services is installed and enabled on this device, and that the version installed on this device is no older than the one required by this client.

##### Returns

- status code indicating whether there was an error. Can be one of following in `ConnectionResult`: SUCCESS, SERVICE_MISSING, SERVICE_VERSION_UPDATE_REQUIRED, SERVICE_DISABLED, SERVICE_INVALID

#### public static boolean isUserRecoverableError (int errorCode)

This method is deprecated.
Use `isUserResolvableError(int)` instead.

Determines whether an error is user-recoverable. If true, proceed by calling `getErrorDialog(int, Activity, int)` and showing the dialog.

##### Parameters

errorCode | error code returned by `isGooglePlayServicesAvailable(Context)`, or returned to your application via `onConnectionFailed(ConnectionResult)`

##### Returns

- true if the error is recoverable with `getErrorDialog(int, Activity, int)`

#### public static boolean showErrorDialogFragment (int errorCode, Activity activity, int requestCode, DialogInterface.OnCancelListener cancelListener)

This method is deprecated.
Use `showErrorDialogFragment(Activity, int, int, OnCancelListener)` instead.

Display a DialogFragment for an error code returned by `isGooglePlayServicesAvailable(Context)`.

##### Parameters

errorCode | error code returned by `isGooglePlayServicesAvailable(Context)` call. If errorCode is `SUCCESS` then this does nothing
activity | parent activity for creating the dialog, also used for identifying language to display dialog in.
requestCode | The requestCode given when calling startActivityForResult.
cancelListener | The `DialogInterface.OnCancelListener` to invoke if the dialog is canceled.

##### Returns

- true if the dialog is shown, false otherwise.

##### Throws

RuntimeException | if API level is below 11 and `activity` is not a `FragmentActivity`.

##### See Also

- `ErrorDialogFragment`
- `SupportErrorDialogFragment`

#### public static boolean showErrorDialogFragment (int errorCode, Activity activity, Fragment fragment, int requestCode, DialogInterface.OnCancelListener cancelListener)

#### public static boolean showErrorDialogFragment (int errorCode, Activity activity, int requestCode)

This method is deprecated.
Use `showErrorDialogFragment(Activity, int, int)` instead.

Display a DialogFragment for an error code returned by `isGooglePlayServicesAvailable(Context)`.

##### Parameters

errorCode | error code returned by `isGooglePlayServicesAvailable(Context)` call. If errorCode is `SUCCESS` then this does nothing.
activity | parent activity for creating the dialog, also used for identifying language to display dialog in.
requestCode | The requestCode given when calling startActivityForResult.

##### Returns

- true if the dialog is shown, false otherwise

##### Throws

RuntimeException | if API level is below 11 and `activity` is not a `FragmentActivity`.

##### See Also

- `ErrorDialogFragment`
- `SupportErrorDialogFragment`

#### public static void showErrorNotification (int errorCode, Context context)

This method is deprecated.
Use `showErrorNotification(Context, int)` instead.

Displays a notification relevant to the provided error code. This method is similar to `getErrorDialog(int, android.app.Activity, int)`, but is provided for background tasks that cannot or shouldn't display dialogs.

##### Parameters

errorCode | error code returned by `isGooglePlayServicesAvailable(Context)` call. If errorCode is `SUCCESS` then null is returned.
context | used for identifying language to display dialog in as well as accessing the `NotificationManager`.