games_services_platform_interface

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 the Android-only setSteps achievement operation. (#245)
• 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. (#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

• add getPlayer by @theLee3

• add playerIsUnderage
• add playerIsMultiplayerGamingRestricted
• add playerIsPersonalizedCommunicationRestricted

• 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.

• Add shouldEnableSavedGame to sign in.

• Add save and load game 🎁 👾.

• Support getting the current player score.

• Support getting the player name.

• Support getting the player id.

• Fix the leaderboard id.

• 💪 Running with sound null safety 💪.

• Add the iOS Access point.

• Add increment method by @tommybuonomo.

• Change the method channel.

• Remove the static keyword for showAchievements, showLeaderboards and signIn.

• Remove the static keyword.

• Initial open-source release.