If you look in the link provided by Stan0 you will see this:
public static final int GOOGLE_PLAY_SERVICES_VERSION_CODE
Minimum Google Play services package version
(declared in AndroidManifest.xml android:versionCode)
in order to be compatible with this client version.
Constant Value: 3225000 (0x003135a8)
public static int isGooglePlayServicesAvailable (Context context)
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.
It will ensure that the device is using the version your app requires, if not, then you can take action according to the documentation
private void setUpMapIfNeeded() {
// Do a null check to confirm that we have not already instantiated the
// map.
if (mMap == null) {
FragmentManager mgr = getFragmentManager();
MapFragment mapFragment = (MapFragment)mgr.findFragmentById(R.id.map);
mMap = mapFragment.getMap();
// Check if we were successful in obtaining the map.
if (mMap != null) {
// The Map is verified. It is now safe to manipulate the map.
setUpMap();
}else{
// check if google play service in the device is not available or out-dated.
GooglePlayServicesUtil.isGooglePlayServicesAvailable(this);
// nothing anymore, cuz android will take care of the rest (to remind user to update google play service).
}
}
}
Besides, you need to add an attribute to your manifest.xml as:
And the value of "3225130" is taken from the google-play-services_lib that your project is using. Also, that value is residing in the same location of manifest.xml in google-play-services_lib.
private boolean checkGooglePlayServices() {
final int status = GooglePlayServicesUtil.isGooglePlayServicesAvailable(this);
if (status != ConnectionResult.SUCCESS) {
Log.e(TAG, GooglePlayServicesUtil.getErrorString(status));
// ask user to update google play services.
Dialog dialog = GooglePlayServicesUtil.getErrorDialog(status, this, 1);
dialog.show();
return false;
} else {
Log.i(TAG, GooglePlayServicesUtil.getErrorString(status));
// google play services is updated.
//your code goes here...
return true;
}
}
and you have two options, either write your code directly in else block as commented, or use the returned boolean value for this method to write custom code.
int status = GoogleApiAvailability.getInstance().isGooglePlayServicesAvailable(this);
if(status != ConnectionResult.SUCCESS) {
if(status == ConnectionResult.SERVICE_VERSION_UPDATE_REQUIRED){
Toast.makeText(this,"please update your google play service",Toast.LENGTH_SHORT).show();
}
else {
Toast.makeText(this, "please download the google play service", Toast.LENGTH_SHORT).show();
}
}
From newer updates i have ended up with this code, i have made a handy method to manage all stuff related to it..
All details related to availability of Service and related details are available here.
private void checkPlayService(int PLAY_SERVICE_STATUS)
{
switch (PLAY_SERVICE_STATUS)
{
case ConnectionResult.API_UNAVAILABLE:
//API is not available
break;
case ConnectionResult.NETWORK_ERROR:
//Network error while connection
break;
case ConnectionResult.RESTRICTED_PROFILE:
//Profile is restricted by google so can not be used for play services
break;
case ConnectionResult.SERVICE_MISSING:
//service is missing
break;
case ConnectionResult.SIGN_IN_REQUIRED:
//service available but user not signed in
break;
case ConnectionResult.SUCCESS:
break;
}
}
I use it like this,
GoogleApiAvailability avail;
int PLAY_SERVICE_STATUS = avail.isGooglePlayServicesAvailable(this);
checkPlayService(PLAY_SERVICE_STATUS);
And for version GoogleApiAvailability.GOOGLE_PLAY_SERVICES_VERSION_CODE; will give you.
And one of the most useful answer i found during my research is here.
IMPORTANT: GoogleApiAvailability.GOOGLE_PLAY_SERVICES_VERSION_CODE returns the minimum version required by YOUR app, not the play services version that is installed on the user's device.