Google Play Games Services offers social leaderboards, achievements, and much more (realtime multiplayer, cloud saves, anti-piracy…)
Cross-platform features are deprecated, for new projects it is recommended to use on Android only.
Using open-source libGDX Extension
Google Play Games support for libGDX games on Android and Desktop is provided by gdx-gamesvcs libGDX extension. The extension also provides implementations for other game services (Apple Game Center, GameJolt and others).
Follow the readme and the project’s wiki to integrate GPGS and other game services in your project.
Manual integration in your project
The following article describes the manual integration in your project without using the library.
A Super Jumper based example that makes use of Leaderboards and Achievements is available to download from Google Play.
The project is freely available on GitHub, and a companion tutorial is available here.
Another in-depth LibGDX-based tutorial for adding Google Play Game Services can be found here.
Latest tutorial using Android Studio can be found here
Intellij and Android Studio Setup
- Install Google Play Service and Google Play Repository using and Android SDK
To do that on Android Studio, Open up SDK Manager, ( Click the button next to the AVD manager in the top toolbar ) click Launch Standalone SDK Manager Scroll down to the Extras section and make sure these 2 packages are installed and updated to the latest :
- Google Play services
- Google Repository
Download BaseGameUtils sample project here, copy folder
BaseGameUtils, located in folder
BasicSamplesinto your project root folder.
- Edit settings.gradle
include 'desktop', 'android', 'ios', 'html', 'core', "BaseGameUtils"
- Edit root build.gradle and add the below as android dependency:
- in your AndroidManifest.xml file
- add two permissions: ```
* add to your application tag
6. string.xml in your android project, under 'res'->'values', in file `strings.xml` add app_id as follow, where 123456789 is your app ID in as declared in the Google Play Developer Console.
<?xml version=”1.0” encoding=”utf-8”?>
6. build.gradle in Android project Synchronize with Gradle. you will get the following message:
Error:Execution failed for task ‘:android:processDebugManifest’.
Manifest merger failed : uses-sdk:minSdkVersion 9 cannot be smaller than version 15 declared in library [libgdx-GPGS:BaseGameUtils:1.0] ```
edit and set
minSdkVersion to the version number in the message above (in this case ‘15’)
Google Play Games’ iOS support is deprecated and shouldn’t be implemented in new games.
There are two ways (called
Backend) to integrate Google Play Games Services with iOS depending whether your are using the open source, community supported Mobidevelop’s RoboVM and its Robopods or Intel’s Multi-OS Engine
Mobidevelop’s RoboVM and its Robopods
Please read the specific page for more information on Mobidevelop’s RoboVM and its Robopods
Warning:You can no longer create new Google Play Game Services accounts with iOS. There is a Simple LIBDX Google Play Games Services integration for iOS but it explains why the new version of Google SDK does not allow iOS users to create a GPGS account from iOS (not a libGDX issue).
note: Until early 2016, libGDX iOS integration was achieved using RoboVM.com. This has been deprecated. Be careful when you check examples on the Internet as older examples may be based on this version. The easy way to find out which version is being referred to:
- Supported version will have
com.mobidevelop.robovmin the buid.gradle file
- Deprecated examples will have
org.robovm:robovmin the buid.gradle file
Intel’s Multi-OS Engine
Checkout the specific page for more information on Intel’s Multi-OS Engine.
In the meantime, you can check out the following sample to get you started:
Splinter Sweets is a Kotlin based example that makes use of Leaderboards. It is available on Android and iOS (Gamecenter and Google Play Services integration).