games_services

Release of games_services and games_services_platform_interface 5.3.0.

Note: 5.2.0 was previously published and retracted on pub.dev, so this feature release ships as 5.3.0.

What's new

• Android: Achievements.setSteps — set an incremental achievement's absolute step progress (monotonic, Android-only). (#245)
• iOS/macOS: distinct sign_in_unavailable error code when the sign-in UI won't present, so apps can distinguish "user dismissed" from "modal never showed". (#237)
• iOS/macOS: showAchievements / showLeaderboards now use GKAccessPoint.trigger on supported OS versions, fixing the non-functional GKGameCenterViewController on iOS/macOS 26+. (#243)
• Fix: legacy Auth/Player methods no longer return stale cached PlayerData to the first stream listener. (#242)

Full Changelog: 5.1.0...5.3.0

• Add Android support for setting an incremental achievement's absolute step progress via Achievements.setSteps. (#245)
• Add a distinct sign_in_unavailable error code on iOS/macOS when the sign-in UI won't present. (#237)
• Migrate showAchievements and showLeaderboards to GKAccessPoint.trigger on supported iOS/macOS versions (fixes the non-functional GKGameCenterViewController on iOS/macOS 26+). (#243)
• Fix legacy Auth/Player methods returning stale cached PlayerData. (#242)

games_services 5.1.0

• Add optional coverImage, description, and playedTime parameters to SaveGame.saveGame. On Android these are set as the snapshot metadata (cover image required to pass Google's Play Games Services quality checklist). Ignored on iOS/macOS. (#228)
• Fix Android saveGame using the unique name as the snapshot description; the description is now only set when provided. (#228)
• Add showSavedGames method to use Google Play Games default UI.
• Include Google Play Games metadata with returned SavedGames.
• Add timeScope and playerScope parameters to Leaderboards.showLeaderboards.
• Migrate to Swift Package Manager. (#223)
• Migrate to built-in Kotlin (bumps minimum supported version to Flutter 3.44 / Dart 3.12).

Published on pub.dev: games_services 5.1.0 · games_services_platform_interface 5.1.0

• Add optional coverImage, description, and playedTime parameters to SaveGame.saveGame. On Android these are set as the snapshot metadata (cover image required to pass Google's Play Games Services quality checklist). Ignored on iOS/macOS. (#228)
• Fix Android saveGame using the unique name as the snapshot description; the description is now only set when provided. (#228)
• Add showSavedGames method to use Google Play Games default UI.
• Include Google Play Games metadata with returned SavedGames.
• Add timeScope and playerScope parameters to Leaderboards.showLeaderboards.
• Migrate to Swift Package Manager.
• Migrate to built-in Kotlin (Bumps minimum supported SDK version to Flutter 3.44/Dart 3.12).

• Return success instead of null in case of success.
• Migrate Gamekit deprecated usage of methods.
• Update minimum support for iOS and Android.
• Fix the example.
• Add loadPreviousOccurrence method for iOS to retrieve the previous occurrence of a player's score from a leaderboard.
• Add ignoreImages to loadAchievements, offloading blocking loading images to IO threads pool.
• Add support for GKLocalPlayer.fetchItems.

• Return success instead of null in case of success.
• Migrate Gamekit deprecated usage of methods.
• Update minimum support for iOS and Android.
• Fix the example.
• Add loadPreviousOccurrence method for iOS to retrieve the previous occurrence of a player's score from a leaderboard.
• Add ignoreImages to loadAchievements, offloading blocking loading images to IO threads pool.
• Add support for GKLocalPlayer.fetchItems.

• Fixes delay in some results after sign in. by @theLee3

• Fixes delay in some results after sign in. by @theLee3

Changes 🎁:

• Add player stream to listen to authorization changes. by @theLee3
• Fix bug causing subsequent signIn calls to freeze on iOS if player not authenticated. Now throws auth error. by @theLee3
• Handle Play Services missing/outdated issues by returning error from signIn and presenting native dialog allowing user to resolve the issue. by @theLee3

• Add player stream to listen to authorization changes. by @theLee3
• Fix bug causing subsequent signIn calls to freeze on iOS if player not authenticated. Now throws auth error. by @theLee3
• Handle Play Services missing/outdated issues by returning error from signIn and presenting native dialog allowing user to resolve the issue. by @theLee3

• Add optional Bool forceRefreshToken as parameter for Android GamesSignInClient.requestServerSideAccess, replacing hard-coded false. Defaults to false. by @yukinoshita0219

What changed?

• Add getPlayerScoreObject to retrieve rank and other score data for leaderboard and time span. by @egonbeermat
• Add optional String token to methods that submit and retrieve score. by @egonbeermat
• Add optional Bool showsCompletionBanner as parameter for iOS GKAchievement.report, replacing hard-coded true. Defaults to true. by @egonbeermat
• Add resetAchievements method for iOS only, Android doesn't support this through Play Games. by @egonbeermat
• Export for player_data.dart. by @@theLee3
• Add logs to save game.

• Add getPlayerScoreObject to retrieve rank and other score data for leaderboard and time span. by @egonbeermat
• Add optional String token to methods that submit and retrieve score. by @egonbeermat
• Add optional Bool showsCompletionBanner as parameter for iOS GKAchievement.report, replacing hard-coded true. Defaults to true. by @egonbeermat
• Add resetAchievements method for iOS only, Android doesn't support this through Play Games. by @egonbeermat
• Export for player_data.dart. by @theLee3
• Add logs to save game.

What changed?

• Add ability to get Play Games auth code for use with backends by @theLee3
• Add PlayerData class to return more score holder details by @theLee3
• Add isAuthenticated check alongside DEBUG signInFailed by @theLee3
• Add signInFailed check to prevent hanging on hot reload by @theLee3
• Handle consent exception when calling loadLeaderboardScores with Scope.friendsOnly by @theLee3
• Ensure all task exceptions are handled, to prevent crashes. by @Erfa

• Add ability to get Play Games auth code for use with backends by @theLee3
• Add PlayerData class to return more score holder details by @theLee3
• Add isAuthenticated check alongside DEBUG signInFailed by @theLee3
• Add signInFailed check to prevent hanging on hot reload by @theLee3
• Handle consent exception when calling loadLeaderboardScores with Scope.friendsOnly by @theLee3
• Ensure all task exceptions are handled, to prevent crashes. by @Erfa

• migrate to Google Play Games Services 2.0.0.
• use the Darwin folder for iOS and macOS.

• migrate to google play games services 2.0.0.
• use darwin folder for iOS and macOS.

• Fix Gradle 8 issue by @Skyost
• Add getPlayer by @theLee3

• Fix gradle issue by @Skyost
• add getPlayer by @theLee3

• Fix class not found exception on android @theLee3

• Fix class not found exception on android @theLee3

• add playerIsUnderage by @theLee3
• add playerIsMultiplayerGamingRestricted by @theLee3
• add playerIsPersonalizedCommunicationRestricted by @theLee3
• Fix getSavedGames crash by @AntonHolovin
• Exclude Gson serialized data models from obfuscation by @theLee3

• Rearrange classes to group features. GameAuth for authintication, Achievements for anything related to Achievements, Leaderboards for anything related to Leaderboards, Player for anything related to Player, and SaveGame for anything related to save game.

• Add load achievements.
• Add load leaderboard scores.

• Release Load/ Save a game 🚀.

• Return error in case of error and null in case of success on android for the methods that has no return value.

• Support getting the current player score.

• Support getting the player name.

• Update docs.

• Support getting the player id.

• Added support for macOS.

• Fix android crash cused by pendingOperation.

• Fix showing a leader board with id on android.

• Make access_point_location accessible

• fix AccessPoint issues

• 💪 Running with sound null safety 💪 by @jonatadashi

• Add the iOS Access point

Add increment method by @tommybuonomo

Add the read me.

Show the android popups

Add addActivityResultListener for registrar

Return an error if user not logged in and clicked on achievement or leaderboard.

Add registerWith(registrar:) back

Add explicitSignIn, by @dioxmio

Fix autogenerated class GeneratedPluginRegistrant usage and missing constructor paramete, by @alexeystrakh

Update gradle properties to fix appcenter build, by @alexeystrakh

Upgrade to android x

Upgrade to flutter 1.12

Upgrade to swift 5.0

First stable release.