Firebase Unity SDK Release Notes

To see release notes for the Firebase console and for other Firebase platforms and related SDKs, see the Firebase Release Notes.

To install this SDK, see Add Firebase to your Unity Project.

Version 4.0.1 - Jun 16, 2017

FCM

  • fixed (Android): Fixed crash when updating Google Play services in projects that include the FCM functionality.
  • fixed (iOS): Fixed an issue where library would crash on start up if there was no registration token.

Dynamic Links and Invites

  • fixed (iOS) Fixed an issue which caused an app to not receive a Dynamic Link if it's opened when the app is installed and not running.

Version 4.0.0 - Jun 9, 2017

  • fixed (Android) Fixed crash in some circumstances after resolving dependencies by updating Google Play services.
  • fixed (iOS) Added support for CocoaPod builds that use Xcode workspaces in Unity 5.6 and above.
  • fixed (iOS) Fixed CocoaPod version pinning which was broken in 3.0.3 causing the SDK to pull in the most recent Firebase iOS SDK rather than the correct version for the current Unity SDK release.

Authentication

  • feature Added support for phone number authentication.
  • feature Added the ability to retrieve user metadata.
  • changed Moved token notification to a separate token changed event.

Dynamic Links

  • feature Added a standalone plugin separate from Invites.

Invites

  • fixed (iOS) Fixed an issue in the analytics SDK's method swizzling which resulted in dynamic links / invites not being sent to the application.

FCM

  • fixed (Android) Fixed a regression introduced in 3.0.3 which caused a crash when opening up a notification when the app is running in the background.
  • fixed (iOS) Fixed interoperation with other users of local notifications.

Version 3.0.3 - May 11, 2017

Authentication

  • fixed Fixed a crash caused by a stale memory reference when a firebase::auth::Auth object is destroyed and then recreated for the same App object.
  • fixed Fixed a potential memory corruption when AuthStateListener is destroyed.
  • fixed (Editor) Fixed an occasional crash in the Unity editor when using authentication sign-in methods.

Version 3.0.2 - May 9, 2017

  • fixed (Android) Fixed an unhandled exception that occurs if FirebaseApp creation fails due to an out-of-date Google Play services version.
  • fixed (Android) Fixed a crash in the Google Play services updater that occurred when clicking outside of the dialog on Android 4.x devices.
  • fixed (Android Editor) Fixed referenced Android dependencies in the Maven plugin where the Project Object Model file (pom.xml) references a specific version using a range expression.
  • fixed (Android Editor) Fixed the resolution of Android dependencies when the bundle ID is modified.
  • fixed (iOS Editor) Improved compatibility with Cocoapods support in Unity 5.6, required to use the GoogleVR iOS SDK.

Authentication

  • fixed Fixed user being invalidated when linking credential fails.
  • fixed Fixed an occasional crash when events are fired. This could manifest in a crash when signing in.
  • changed Deprecated FirebaseUser.RefreshToken.

Realtime Database

  • fixed Fixed an issue which caused the application to manually refresh the auth token.

FCM

  • fixed (Android) Resolved an issue which caused an app to receive an empty message when a notification is received while the app is in the background and user then taps on the app icon rather than the notification.

Invites

  • fixed (iOS) Fixed an issue which resulted in the app delegate method application:openURL:sourceApplication:annotation: not being called when linking the invites library. This caused the Facebook SDK login flow to fail.

Version 3.0.1 - March 15, 2017

  • fixed (Android) Fixed Google Play Services checker on Android. Previously when Google Play Services was out of date, FirebaseApp.CheckDependencies() incorrectly returned DependencyStatus.Available.
  • changed (Android) Added check for auto-resolution being enabled in the Android Resolver editor plugin. If auto-resolution is disabled by the user or by another plugin (e.g Google Play Games), the user is warned about the configuration problem and given the opportunity to fix it.
  • fixed (Android) Fixed single architecture builds when using Gradle.
  • fixed (Android) Resolved an issue which caused the READ_PHONE_STATE permission to be requested.

Version 3.0.0 - February 27, 2017

  • changed Added link.xml files to allow byte stripping to be enabled.
  • fixed Fixed issues with Android builds when targeting a single ABI.
  • changed Added process of cleaning stale / moved files when upgrading to a newer version of the editor plugin.
  • changed Fixed minor issue in the editor plugin with the Firebase window not being repainted as Firebase configuration files are added to or removed from a project.
  • changed Bundle ID selection dialog for iOS and Android is now displayed when the project bundle ID doesn't match the Firebase configuration.
  • changed (iOS) Added automated CocoaPod tool installation and improved Pod tool detection when using RVM. This enables iOS projects to build with Unity Cloud Build.
  • changed (iOS) Added support for pods that reference static libraries.
  • changed (Android) Added experimental support for building with Proguard stripping enabled.
  • fixed (Android) Fixed Android package (AAR) synchronization when the project bundle ID is modified.
  • fixed (Android) Fixed clean up of stale AAR dependencies when users change Android SDK versions.
  • changed (Android) Jar Resolver now remembers—for the editor session—which AARs to keep when new AARs are available compared to what is included in a project.
  • changed (Android) Added support for projects that use Google Play Services at different versions.
  • changed Added fake—but valid—JWT in the Authentication stub used when building for the desktop.

Authentication

  • changed Added SetCurrentScreen() method.
  • fixed Fixed race condition when accessing user properties.

Realtime Database

  • fixed Resolved issue where large queries resulted in empty results.
  • fixed Fixed an issue which prevented saving boolean values.

Storage

  • fixed Fixed a bug which prevented download URLs from containing slashes.
  • fixed (iOS) Fixed a bug on iOS which caused networking to fail when the full .NET 2.0 compatibility level is used.

FCM

  • fixed (iOS) Fixed issue with initialization on iOS that caused problems with other SDKs.

Invites

  • fixed (iOS) Fixed issue with initialization on iOS that caused problems with other SDKs.

Version 1.1.2 - February 6, 2017

  • fixed Fixed a potential deadlock when running callbacks registered via Task.ContinueWith().

Authentication

  • fixed (Android) Fixed an error in Firebase.Auth.FirebaseUser.PhotoUrl.

FCM

  • fixed (iOS) Removed hard dependency on Xcode 8.
  • fixed (Android) Fixed an issue where the application would receive an empty message on startup.

Version 1.1.1 - January 18, 2017

  • fixed Fixed an issue in the editor plugin that caused an exception to be thrown when the project bundle ID didn't match a bundle ID in the Android configuration file (google-services.json).
  • fixed Fixed a bug in the editor plugin that caused a stack overflow when multiple iOS configuration files (GoogleServices-Info.plist) are present in a project.

Authentication

  • fixed (Android) Fixed an issue that caused a Task to never complete when signing in while a user is already signed in.
  • changed Renamed the Auth.UserProfile.ProtoUri property to Auth.UserProfile.ProtoUrl to be consistent with the other URL properties across the SDK.

FCM

  • fixed (iOS) Fixed an issue with method swizzling that caused some of the application's UIApplicationDelegate methods to not be called.

Invites

  • fixed (iOS) Fixed an issue with method swizzling that caused some of the application's UIApplicationDelegate methods to not be called.

Realtime Database

  • fixed Fixed an issue that prevented saving floating point values.

Storage

  • fixed The Storage plugin was using a Unity API that is only present in Unity 5.4. We have modified the component so that it is now backwards compatible with previous versions of Unity.

Version 1.1.0 - December 9th, 2016

  • changed The editor plugin now reads the Java SDK location from the Unity editor preferences.
  • changed The editor plugin now scans all google-services.json and GoogleService-Info.plist files selects the config file matching the project's bundle ID.
  • changed Error messages in the editor plugin now report more common configuration problems.
  • changed (Android) Improved the performance of AAR / JAR resolution when the Android config is selected and auto-resolution is enabled.
  • fixed Fixed a bug that caused event routing to fail when a Unity scene transition occurs.
  • fixed Fixed a build configuration problem that prevented builds in Visual Studio.
  • issue (Android) Proguard is not integrated into Android builds, but you can manually integrate the Proguard files included with the Unity SDK into Android app builds. These Proguard files are found in AAR files matching the following pattern in each Unity package: Firebase/m2repository/com/google/firebase/firebase-*-unity/*firebase-*.srcaar
  • issue (Android) Incompatible AARs are not resolved correctly when building for Android. This can require manual intervention when using multiple plugins. A workaround is documented on the AdMob Unity plugin issue tracker.

Storage

Analytics

  • fixed Fixed crash when logging arrays of parameters.

Authentication

  • changed Modified stub implementation so that all operations now succeed rather than raise exceptions.

Realtime Database

  • fixed Fixed an issue that caused null events to not be reported.
  • fixed Fixed an issue that caused unsubscription from complex queries to fail.
  • fixed Fixed an issue that caused service account authentication to fail in the editor.
  • fixed Added a link.xml rule to prevent Firebase.Database.Unity being stripped from iOS builds.

FCM

  • fixed Fixed an issue that prevented subscription to topics.
  • fixed (iOS) Fixed an issue that caused random hangs during initialization on iOS.
  • fixed (Android) Modified the AndroidManifest.xml so that the app icon is included on Android.
  • fixed (Android) Fixed an issue that caused an exception when receiving messages with empty payloads on Android.

Dynamic Links and Invites

  • changed Modified stub implementation so that all operations now succeed rather than raise exceptions.
  • fixed Fixed an issue that caused a crash when opening a link.
  • fixed (iOS) Fixed an issue that caused random hangs during initialization on iOS.

Version 1.0.1 - November 18th, 2016

  • fixed Fixed Realtime Database restricted access from the Unity Editor on Windows.
  • fixed (iOS) Fixed load and build errors when iOS support is not installed.
  • fixed (iOS) Fixed an issue that prevented the creation of multiple FirebaseApp instances and customization of the default instance.
  • fixed (iOS) Fixed an issue with pod tool discovery when the Ruby Gem binary directory is modified from the default location.
  • fixed (Android) Removed all dependencies on Python resource generation on Windows.
  • fixed (Android) Fixed problems when building with the IL2CPP scripting backend.

Version 1.0.0 - November 7th, 2016

This initial release of the Firebase Unity SDK includes support for Analytics, Authentication, Realtime Database, Invites, Dynamic Links and Remote Config. To get started, see Adding Firebase to your Unity Project.

  • issue Proguard is not integrated into Android builds, but you can manually integrate the Proguard files included with the Unity SDK into Android app builds. These Proguard files are found in AAR files matching the following pattern in each Unity package: Firebase/m2repository/com/google/firebase/firebase-*-unity/*firebase-*.srcaar

Send feedback about...

Need help? Visit our support page.