Firebase Unity SDK

The Firebase Unity SDK provides Unity packages for the following Firebase features on iOS, tvOS and Android.

Note: Firebase Dynamic Links is not supported on tvOS.

Feature	Unity Package
Firebase Analytics	FirebaseAnalytics.unitypackage
Firebase App Check	FirebaseAppCheck.unitypackage
Firebase Authentication	FirebaseAuth.unitypackage
Firebase Crashlytics	FirebaseCrashlytics.unitypackage
Firebase Dynamic Links	FirebaseDynamicLinks.unitypackage
Cloud Firestore	FirebaseFirestore.unitypackage
Firebase Functions	FirebaseFunctions.unitypackage
Firebase Installations	FirebaseInstallations.unitypackage
Firebase Messaging	FirebaseMessaging.unitypackage
Firebase Realtime Database	FirebaseDatabase.unitypackage
Firebase Remote Config	FirebaseRemoteConfig.unitypackage
Firebase Storage	FirebaseStorage.unitypackage

The SDK provides .NET 4.x compatible packages

Desktop Workflow Implementations

The Firebase Unity SDK includes desktop workflow support for the following Firebase features, enabling their use in the Unity editor and in standalone desktop builds on Windows, OS X, and Linux:

Feature	Unity Package
Firebase Authentication	FirebaseAuth.unitypackage
Firebase App Check	FirebaseAppCheck.unitypackage
Firebase Realtime Database*	FirebaseDatabase.unitypackage
Cloud Firestore	FirebaseFirestore.unitypackage
Firebase Functions	FirebaseFunctions.unitypackage
Firebase Remote Config	FirebaseRemoteConfig.unitypackage
Firebase Storage	FirebaseStorage.unitypackage

(* See Known Issues in the Release Notes below.)

This is a Beta feature, and is intended for workflow use only during the development of your app, not for publicly shipping code.

Stub Implementations

Stub (non-functional) implementations of the remaining libraries are provided for convenience when building for Windows, OS X, and Linux, so that you don't need to conditionally compile code when also targeting the desktop.

AdMob

The AdMob Unity plugin is distributed separately and is available from the AdMob Get Started guide.

Setup

You need to follow the SDK setup instructions. Each Firebase package requires configuration in the Firebase Console. If you fail to configure your project your app's initialization will fail.

Support

Firebase Support

Release Notes

11.6.0

• Changes
  • General: Update to Firebase C++ SDK version 11.6.0.
  • General (iOS): Update to Firebase Cocoapods version 10.16.0.
  • App Check: Fixed a crash when there are errors creating a provider. (#877)

11.5.0

• Changes
  • General: Update to Firebase C++ SDK version 11.5.0.
  • General (Android): Update to Firebase Android BoM version 32.3.1.
  • General (iOS): Update to Firebase Cocoapods version 10.15.0.
  • General (Android): Made dynamic code files read only to comply with new Android 14 security requirements. This fixes a crash at API level 34+.
  • Analytics (iOS): Added InitiateOnDeviceConversionMeasurementWithPhoneNumber function to facilitate the on-device conversion measurement API.

11.4.0

• Changes
  • General: Update to Firebase C++ SDK version 11.4.0.
  • General (Android): Update to Firebase Android BoM version 32.2.2.
  • General (iOS): Update to Firebase Cocoapods version 10.13.0.
  • General (iOS): 32-bit iOS builds (i386 and armv7) are no longer supported.
  • Auth: Fixed a potential crash with holding onto FirebaseUser objects after the AuthResult has been disposed.

11.3.0

• Changes
  • General: Update to Firebase C++ SDK version 11.3.0.
  • General (Android): Update to Firebase Android BoM version 32.2.0.
  • General (iOS): Update to Firebase Cocoapods version 10.12.0.
  • General (Desktop): Fixed an error loading google-services.json and google-services-desktop.json from paths with international characters on Windows.
  • Auth (Android): Fixed an issue where VerifyPhoneNumber's internal builder failed to create PhoneAuthOptions with certain compiler settings.
  • Auth (iOS): Fixed an issue where functions that return AuthResult were not including updated credentials when encountering errors.
  • Firestore (Android) Fix the intermittent global references exhaustion crash when working with documents with a large number of keys and/or large map and/or array fields. (#569).
  • Remote Config (Desktop): Additional fix for handling of non-English time zone names on Windows.

11.2.0

• Changes
  • General: Update to Firebase C++ SDK version 11.2.0.
  • General (Android): Update Firebase Android BoM dependencies to v32.1.1.
  • General (iOS): Update Firebase Cocoapods dependencies to v10.11.0.
  • Remote Config (Desktop): Fixed numeric conversion when the system language's number format uses commas as decimal points.
  • Remote Config (Desktop): Fixed handling of time zones on Windows when the time zone name in the current system language contains an accented character or apostrophe.

11.1.0

• Changes
  • General: Update to Firebase C++ SDK version 11.1.0.
  • General (Android): Update Firebase Android BoM dependencies to v32.1.0.
  • General (iOS): Update Firebase Cocoapods dependencies to v10.10.0.
  • General (Android): Fix for deadlock within JniResultCallback, commonly seen within Messaging, but affecting other products as well.
  • General: Fix an issue where AppCheck bundles were unintentionally included in App in the tgz.
  • Auth: Fix a crash that could occur when referencing CurrentUser.
  • Auth: Remove internal methods.
  • Database/Firestore (Desktop): Fixed a crash on Windows when the user's home directory contains non-ANSI characters (Unicode above U+00FF).
  • Storage (Desktop): Fixed a crash on Windows when uploading files from a path containing non-ANSI characters (Unicode above U+00FF).
  • Firestore: Add multi-database support. (#738).

11.0.0

• Changes
  • App Check: Adds support for Firebase App Check on Android, iOS, tvOS, and desktop platforms. To learn more, see https://firebase.google.com/docs/app-check
  • Messaging: Remove deprecated calls Send, Subscribe, and Unsubscribe.
  • Remote Config (Android/iOS): Added support for real-time config updates. Use the new OnConfigUpdateListener API to get real-time updates. Existing FetchAsync and ActivateAsync APIs aren't affected by this change. To learn more, see Get started with Firebase Remote Config.
  • Auth: Deprecated a number of methods, appending _DEPRECATED to some of their names. This is a breaking change; you must either modify your code to refer to the _DEPRECATED methods, or switch to the new methods, which have new return types AuthResult (rather than SignInResult). The deprecated methods will be removed in the next major release of the Firebase Unity SDK. (Note: do not mix and match using the old and new methods or undefined behavior may result.)
  • Firestore: Added Query.Count(), which fetches the number of documents in the result set without actually downloading the documents (#659).

10.7.0

• Changes
  • General: Update to Firebase C++ SDK version 10.7.0.
  • General (Android): Update Firebase Android BoM dependencies to v31.3.0.
  • General (iOS): Update Firebase Cocoapods dependencies to v10.7.0.
  • Messaging (Android): Generate the custom MessagingUnityPlayerActivity as a Java file instead of precompiling it. This is to better support changes with the UnityPlayerActivity, and GameActivity options, in the Unity 2023 editor.

10.6.0

• Changes
  • General (Android): Update to Firebase Android BoM version 31.2.3.
  • General (iOS): Update to Firebase Cocoapods version 10.6.0.

10.5.0

• Changes
  • General (Android): Update to Firebase Android BoM version 31.2.1.
  • General (iOS): Update to Firebase Cocoapods version 10.5.0.

10.4.0

• Changes
  • General (Android): Update to Firebase Android BoM version 31.2.0.
  • General (iOS): Update to Firebase Cocoapods version 10.4.0.
  • Firebase introduces Unity SDK support for tvOS, for Analytics, Authentication, Crashlytics, Database, Firestore, Cloud Functions, Installations, Messaging, Remote Config and Storage.
  • Analytics: Added SetConsent() and GetSessionIdAsync() APIs.
  • Crashlytics: Added ReportUncaughtExceptionsAsFatal property and LogExceptionAsFatal API.

10.3.0

• Changes
  • General (Android): Update to Firebase Android BoM version 31.1.1.
  • General (iOS): Update to Firebase Cocoapods version 10.3.0.
  • Remote Config: Added ConfigSettings.MinimumFetchIntervalInMilliseconds, which should be used instead of MinimumFetchInternalInMilliseconds. The old one is considered deprecated, and will be removed with the next major release.

10.2.0

• Changes
  • General (Android): Update to Firebase Android BoM version 31.1.0.
  • General (iOS): Update to Firebase Cocoapods version 10.2.0.

10.1.1

• Changes
  • General (Android): Update to Firebase Android BoM version 31.0.3.
  • Crashlytics (Android): Fixed an issue preventing native crashes from being reported for Android API 29+.

10.1.0

• Changes
  • General: Update to Firebase C++ SDK version 10.1.0.
  • General (Android): Update to Firebase Android BoM version 31.0.2.
  • General (iOS): Update to Firebase Cocoapods version 10.1.0.
  • Crashlytics (Android): Fixed an issue with symbols being stripped when using the tgz package.
  • Firestore (Android): Reduce the number of JNI global references consumed when creating or updating documents (#1111).

10.0.1

• Changes
  • Crashlytics (Android): Fixed a critical issue that was causing background crashes in specific cases.

10.0.0

• Changes
  • General: Updated Firebase C++ SDK dependencies to v10.0.0.
  • General (Android): Update Firebase Android BoM dependencies to v31.0.0.
  • General (iOS): Update Firebase Cocoapods dependencies to v10.0.0.
  • General: Minimum supported editor version is now Unity 2019.
  • General: Removed dependency on Parse Tasks.
  • Auth (Android/iOS): Deprecate PhoneAuthProvider.MaxTimeoutMs. The actual range is determined by the underlying SDK, ex. PhoneAuthOptions.Builder in Android SDK.
  • Remote Config: Improve performance when setting default parameters with long strings.

9.6.0

• Changes
  • General: Updated Firebase C++ SDK dependencies to v9.6.0.
  • General (Android): Update Firebase Android BoM dependencies to v30.5.0.
  • General (iOS): Update Firebase Cocoapods dependencies to v9.6.0.

9.5.0

• Changes
  • General: Updated Firebase C++ SDK dependencies to v9.5.0.
  • Crashlytics: Fix #218 that Firebase editor tool not loading when iOS build support is not installed.

9.4.0

• Changes
  • General: Updated Firebase C++ SDK dependencies to v9.4.0.

9.3.0

• Changes
  • General (Android, Linux): Fixed a concurrency bug where waiting for an event with a timeout could occasionally return prematurely, as if the timeout had occurred (#1021).

9.2.0

• Changes
  • Crashlytics: Fix requiring user code to reference Crashlytics when using il2cpp.
  • Firestore: Added TransactionOptions to control how many times a transaction will retry commits before failing (#318).
  • Database (Desktop): If the app data directory doesn't exist, create it. This fixes an issue with disk persistence on Linux.
  • Messaging (Android): Make sure all the resources are closed in RegistrationIntentService. (#973).

9.1.0

• Changes
  • General: Added a missing namespace to the Google.MiniJson.dll.
  • General (iOS): Fix an issue with bitcode not being enabled correctly.
  • Functions: Add a new method GetHttpsCallableFromURL, to create callables with URLs other than cloudfunctions.net.
  • Analytics (iOS): Added InitiateOnDeviceConversionMeasurementWithEmail function to facilitate the on-device conversion measurement API.

9.0.0

• Changes
  • General: Minimum supported editor version is now Unity 2018.
  • General (Editor, macOS): Add support for Apple Silicon chips.
  • General (iOS): Firebase Unity on iOS is now built using Xcode 13.3.1.
  • General (iOS): Fixed crash when running on iPhoneOS 12 and older.
  • Analytics: Removed deprecated event names and parameters.
  • Crashlytics (Android): Fixed a bug with missing symbols when enabling minification via proguard.
  • Messaging (Android): Fixed a bug with duplicate symbols when also using Functions.
  • Realtime Database (Desktop): Fixed a bug handling server timestamps on 32-bit CPUs.
  • Storage (Desktop): Set Content-Type HTTP header when uploading with custom metadata.

8.10.1

• Changes
  • General (Android): Fix an issue when building with mainTemplate.gradle.

8.10.0

• Changes
  • General (Editor, macOS): Fix an issue when finding "python" executable.
  • General : Firebase Unity SDK starts to build using Unity 2019, and releases from git repo.

8.9.0

• Changes
  • General (Editor, macOS): Support non-default "python" executable names, common in newer macOS versions.
  • General (iOS): Fixed additional issues on iOS 15 caused by early initialization of Firebase iOS SDK.
  • Remote Config: Fixed default FetchAsync() timeout being too high.
  • Storage (Desktop): Added retry logic to PutFileAsync, GetFileAsync, and other operations.

8.8.1

• Changes
  • General (iOS): Fixed additional issues on iOS 15 caused by early initialization of Firebase iOS SDK.

8.8.0

• Changes
  • General (iOS): Another possible fix for an intermittent crash on iOS 15 caused by constructing C++ objects during Objective-C's +load method.
  • Storage: Added a method to access the url of a storage instance.
  • Crashlytics (Android): Updated internal Crashpad version to commit 281ba7. With this change, disabling tagged pointers is no longer required, so the following can be removed from your manifest's application tag: android:allowNativeHeapPointerTagging=false.
  • Crashlytics (Android): Improved runtime efficiency of the SetCustomKey functions, significantly reducing the number objects created and disk writes when keys are updated frequently.
  • Remote Config: Fixed an issue where the TimeSpan field of FetchDataAsync was being used incorrectly.

8.7.0:

• Changes
  • General (iOS): Fixed an intermittent crash on iOS 15 caused by constructing C++ objects during Objective-C's +load method. (#706) (#783)
  • Crashlytics (Android): Fixed a bug that prevented some Crashlytics session files from being removed after the session ended. All session-specific files are now properly cleaned up. (#737)

8.6.2:

• Changes
  • Messaging (Android): Clean up callbacks on termination, to possibly fix ANR issues in CheckAndFixDependenciesAsync (#1160).

8.6.1:

• Changes
  • Crashlytics (Android): Updated the pinned dependency to fix a missing method error (#1177).

8.6.0:

• Changes
  • General (Android): Minimum SDK version is now 19.
  • General: Variant double type now supports 64-bit while saving to json. (#1133).
  • Firestore: Released to general availability for Android and iOS (desktop support remains in beta).
  • Firestore (iOS): Fixed intermittent crashes and empty results when retrieving the contents of a document. (#1171).
  • Firestore (iOS): Fixed intermittent "start after" query filters failing to have any effects on the queries.
  • Firestore (iOS): Fixed intermittent cases where specifying ServerTimestampBehavior.Previous would return empty values instead of the previous values.
  • Crashlytics: Improved crash reporting for Unity Android apps using the IL2CPP scripting backend. To display symbolicated IL2CPP stack traces in the Crashlytics console, Android customers will need to upload symbol files for their builds. See the [Getting Started with Crashlytics Unity] (https://firebase.google.com/docs/crashlytics/get-started?platform=unity) Guide for more details.
  • Messaging (Android): Fixed crash resulting in ANR on termination. (#1151).

8.5.0:

• Changes
  • General (iOS): iOS SDKs are now built using Xcode 13.0.0.
  • Firestore: Fixed an issue where the Equals() and GetHashCode() methods of DocumentSnapshot would sometimes be inconsistent (#8647).

8.4.0:

• Changes
  • General: Added support for Android x86 64.
  • Firestore: Improved the efficiency of progress callbacks in LoadBundleAsync().
  • Firestore: Fixed crashes in Unity Editor on Linux caused by C++ exceptions failing to be converted to C# exceptions.
  • Firestore: Fixed intermittent hangs on Android when exceptions are thrown by callbacks.
  • Firestore: Fixed a crash on Android when DocumentReference.Set() was invoked with an invalid documentData value (e.g. an int).
  • Firestore: Fixed race conditions in the instance caching, terminate, and disposal logic of FirebaseFirestore.

8.3.0:

• Changes
  • Firestore: Simplified the API for modifying the settings of a FirebaseFirestore instance. This is a backwards-incompatible change and requires updates to code that sets FirebaseFirestore.Settings.
  • Firestore: Changed an argument to Query.WhereNotIn() from List to IEnumerable, to be consistent with Query.WhereIn().
  • Messaging (Android): Fixes an issue with receiving tokens when initializing the app.

8.2.0:

• Changes
  • Firestore: Removed Equals and GetHashCode methods from Query, QuerySnapshot, and DocumentSnapshot classes. These methods were unimplemented, and we plan to add proper support for them in a future release.
  • Crashlytics: Upload UnityFramework symbols in addition to the main app dSYM file to improve symbolication (#673).
  • Messaging: Fixed a duplicate class error when building an application which also uses Firebase Functions.

8.1.0:

• Changes
  • Database: Fixed a crash around using DataSnapshots within Coroutines (#635).
  • Firestore: Implemented IDisposable for ListenerRegistration (#746).
  • Firestore: Added null and empty string argument checks to all public methods, which now throw exceptions instead of crashing (#1053).
  • Firestore: Fixed Android crash due to missing QueryEventListener class (#1080).
  • Firestore: Added support for Firestore Bundles via FirebaseFirestore.LoadBundleAsync() and FirebaseFirestore.GetNamedQueryAsync(). Bundles contain pre-packaged data produced with the Firestore Server SDKs and can be used to populate Firestore's cache without reading documents from the backend.

8.0.0:

• Breaking Changes
  • Instance Id: Removed support for the previously-deprecated Instance ID SDK.
  • Remote Config: The previously-deprecated class FirebaseRemoteConfigDeprecated and the property ConfigSettings.IsDeveloperMode have been removed.
• Changes
  • Firestore: Internal assertions will now trigger C# exceptions (possible exception types are ArgumentException, InvalidOperationException and FirestoreException with ErrorCode set to Internal). These exceptions are not meant to be caught -- rather, they are to help with debugging and to avoid crashing the Unity editor instance. Important: on iOS, you would need to change two settings on the exported XCode project for this feature to work properly. Open Build Settings and make sure that Enable C++ Exceptions and Enable C++ Runtime Types settings are set to Yes for all of the following: the Unity-iPhone scheme, the UnityFramework scheme (for Unity versions 2019.3 and above) and the Unity-iPhone project. If you're doing incremental iOS builds (i.e., if you use Append instead of Replace when doing the build), these settings will persist between rebuilds, so you would only have to do this once per project.
  • Firestore: Fix RunTransactionAsync() to roll back the transaction if the task returned from the given callback faults (#1042).

7.2.0:

• Changes
  • Database: Fixed a potential crash that can occur as a result of a race condition when adding, removing and deleting ValueListeners or ChildListeners rapidly.
  • Database: Fixed a crash when setting large values on Windows and Mac systems (#517].
  • FCM (Android): Fixed triggering of callback handlers for background notifications. Using enqueueWork instead of startService.
  • Crashlytics: Added new Unity-specific metadata to help diagnose tricky crashes around specific hardware setups.

7.1.0:

• Breaking Changes
  • Remote Config: Changed FirebaseRemoteConfig to be an instanced class, with new APIs to better manage fetching config data. The old static methods are now deprecated, and can be accessed in the new class FirebaseRemoteConfigDeprecated.
  • Remote Config: ConfigSettings.IsDeveloperMode is now obsolete and does nothing. ConfigSettings.MinimumFetchInternalInMilliseconds should be adjusted instead.
• Changes
  • General: Add GoogleServices-Info.plist to Unity-iPhone target in Unity 2019.3+.
  • Firestore: Fixed partial updates in UpdateAsync() with FieldValue.Delete (#882).
  • Firestore: Fixed DocumentSnapshot.ToDictionary() on non-existent documents when running on Android (#887).
  • Firestore: Fixed crash setting FirebaseFirestore.LogLevel on Android before any instances have been created (#888).
  • Auth: Fixed a flaky crash when accessing the result from the task returned by FetchProvidersForEmailAsync.
  • Auth: You can now specify a language for emails and text messages sent from your apps using UseAppLanguage() or setting the FirebaseAuth.LanguageCode property.
  • Messaging (Android): Using enqueueWork instead of startService. Fixes bug where we lost messages with data payloads received when app is in background. (#877
  • Remote Config: Fixed numeric value conversion ConfigValue.DoubleValue and ConfigValue.LongValue to be locale independent.
  • Installations: Fixed pod version to 7.5.0.

7.0.1:

• Changes
  • Remote Config (Android): Fixed the crash bug introduced in 7.0.0.

7.0.0:

• Changes
  • General (iOS): iOS SDKs are now built using Xcode 11.7.
  • App (Editor): Remove deprecated service account APIs.
  • App: Remove FirebaseApp.CheckDependencies() API.
  • Analytics: Remove deprecated SetMinimumSessionDuration call.
  • Installations: Added Installations SDK. See Documentations for details.
  • Instance Id: Marked Instance Id as deprecated.
  • Messaging: Added getToken, deleteToken apis.
  • Messaging: Removed deprecated Send() function.
  • Storage: Remove deprecated DownloadUrl and DownloadUrls properties in StorageMetadata.
  • Messaging: raw_data has been changed from a std::string to a byte array.
  • Dynamic Links: Remove deprecated DynamicLinkComponents.DynamicLinkDomain . Please use DynamicLinkComponents.DomainUriPrefix instead.
  • Dynamic Links (Android): Bump up Android library version and remove dependency to GMS app invite.
  • Firestore: Added support for WhereNotEqualTo and WhereNotIn queries.
  • Firestore: Added new internal HTTP headers to the gRPC connection.
  • Firestore: Fixed a Unity Editor hang on Windows when restarting an app after listening to a query, document, or snapshots in sync (#845).
  • Firestore: Added support for FirebaseFirestoreSettings.CacheSizeBytes.
  • Firestore: Fixed an intermittent crash in the Unity Editor when the app is restarted while a transaction is in progress (#783).
  • Firestore: Fixed a crash when writing to a document after having been offline for long enough that the auth token expired (#872).

6.16.1:

• Changes
  • General (Android): Fixes regression in 6.16.0 about Android build error "Program type already present: com.google.firebase.unity.BuildConfig" when make Android build with Crashlytics SDK in Unity 2019 and below.
  • General: Significantly reduced the filesize of the Linux libraries.
  • Database (Desktop): Added a function to create directories recursively for persistent storage that fixes segfaults.

6.16.0:

• Changes
  • General: Prevent Firebase SDK from causing GC in every frame.
  • General (Editor): Improved the performance of Firebase Editor tools by delay initialization when condition met and improve asset searching.
  • General: Deprecate Firebase.Unity.Editor.FirebaseEditorExtensions. Most of the functions is noop now and will be removed soon.
  • General: Breaking Change Remove deprecated functions FirebaseApp.SetEditorAuthUserId() and FirebaseApp.GetEditorAuthUserId() in order to improve performance.
  • General: (Android) Fixed that FirebaseApp failed to create for builds created by Unity 2020+ due to google-services.json not found. All Firebase Android resource files are moved to directories with androidlib extension.
  • General: (Android) Remove android:minSdkVersion from AndroidManifest.xml under Assets/Plugins/Android/Firebase which is causing build error in Unity 2020.
  • Database (Desktop): Enabled offline persistence.
  • Firestore: Fixed FirebaseFirestore.LogLevel for some log levels.
  • Firestore: Added Error.None as a synonym for Error.Ok, which is more consistent with other Firebase Unity APIs.
  • auth.SWIG: Fix typo (across).
  • Firestore: Fixed leaked memory in FirebaseFirestore C# objects.
  • Crashlytics: Fixed an issue on iOS where the Crashlytics Run Script would fail to get added on versions of Unity 2018 and below #5569
  • Crashlytics: (Android) Fixed crashes for builds created by Unity 2020+ due to build ID is missing. Generated Crashlytics Android resource files are moved to Plugins/Android/FirebaseCrashlytics.androidlib.
  • Firestore: Fixed CollectionReference.AddAsync() to propagate errors.
  • Firestore: Changed async tasks to fault with FirestoreException.
  • Firestore: Renamed the Error enum to FirestoreError.
  • Messaging (Android): Updated library to be compatible with Android O, which should resolve a IllegalStateException that could occur under certain conditions.
  • Messaging: Deprecated the Send function.
  • Firestore: Added meaningful error messages to the exceptions with which ListenerRegistration.ListenerTask tasks fault.

6.15.2

• Overview
• Changes
  • Firestore (iOS): Fixed the missing Dispose symbol by updating to the correct Cocoapod version.

6.15.1

• Overview
• Changes
  • Firestore: Significantly improved stability when reentering play mode, addressing this issue.
  • Firestore: Fixed memory leaks that could cause a global reference table overflow on Android, addressing this issue.
  • Fixed an issue that warns about Future handle not released properly.
  • Firestore: Added the ListenerRegistration.ListenerTask property which facilitates discovering an error that causes the listener stream to stop.
  • Fixed an issue that cause Editor crash on the second time click play.

6.15.0

• Overview
  • Replaced legacy Fabric Crashlytics Android and iOS SDKs with updated Firebase Crashlytics SDKs.
  • Reduce editor freeze when play mode starts.
• Changes
  • Crashlytics (Android and iOS): Updated with the Firebase Crashlytics Android & iOS SDKs, which now use Firebase-specific endpoints rather than the deprecated Fabric endpoints. Crashlytics C# APIs have not changed.
  • Crashlytics (Editor): Removed UI for managing Fabric API keys, which are no longer required. Migrated Fabric apps will automatically use the Google App Id as defined in the GoogleServicesInfo.plist and google-services.json files.
  • Crashlytics (Editor): Fixed an issue that occurs when Crashlytics is imported using the Unity Package Manager.
  • Crashlytics: Added [assembly: Preserve] attribute to Firebase.Crashlytics namespace, to prevent stripping of Crashlytics code by the UnityLinker.
  • Firestore: Fixed several serialization issues on iOS.
  • Firestore: Added WaitForPendingWritesAsync method which allows users to wait on a task that completes when all pending writes are acknowledged by the firestore backend.
  • Firestore: Added TerminateAsync method which terminates the instance, releasing any held resources.
  • Firestore: Added ClearPersistenceAsync method which clears the persistent cache, allowing unit/integration tests to be more isolated.
  • Firestore: Added Query.LimitToLast(int n), which returns the last n documents as the result.
  • Firestore: Added support for changing Firestore settings.
  • Test Lab: Experimental release of Test Lab is now available on all supported platforms.
  • Firestore: Removed the DocumentReference.ListenerDelegate and Query.ListenerDelegate delegates. These were intended to be internal-only types.
  • General: Reduce editor freeze when play mode starts by not running XcodeProjectPatcher, GeneratedXmlFromGoogleServices and AndroidManifestPatcher if the editor is in play mode or about to start play mode.
  • Messaging: (Android) Using the MessagingUnityPlayerActivity will no longer interfere with Unity's built-in handling of deep links.

6.14.1

• Changes
  • Auth: Added a new method: Firebase.Auth.Credential.IsValid().
  • Auth: Added Firebase.Auth.FirebaseAccountLinkException which may be thrown by LinkAndRetrieveDataWithCredentialAsync. The exception includes a Firebase.Auth.UserInfo object which may contain additional information about the user's account.
  • Auth (iOS): Added Firebase.Auth.UserInfo.UpdatedCredential. This credential may be valid in FirebaseAccountLinkExceptions indicating that the credential may be used to sign into Firebase as the Apple-linked user.

6.14.0

• Changes
  • Firestore: Firestore.LoggingEnabled is replaced by Firestore.LogLevel for consistency with other Firebase Unity APIs. The getter for this property has been removed.
  • Crashlytics (iOS): Removes references to UIWebView APIs to prevent App Store rejections.

6.13.0

• Changes
  • General: Update asset labels so that External Dependency Manager works even if files in Firebase SDK are moved.
  • Firestore: Added Query.WhereArrayContains() query operator to find documents where an array field contains a specific element.
  • Firestore: Added FieldValue.ArrayUnion() and FieldValue.ArrayRemove() to atomically add and remove elements from an array field in a document.
  • Firestore: Added Query.WhereIn() and Query.WhereArrayContainsAny() query operators. Query.WhereIn() finds documents where a specified field’s value is IN a specified array. Query.WhereArrayContainsAny() finds documents where a specified field is an array and contains ANY element of a specified array.
  • Firestore: Fixed QuerySnapshot.GetEnumerator() to not throw an InvalidCastException.

6.12.0

• Overview
  • Added experimental support for Cloud Firestore SDK.
• Changes
  • Firestore: Experimental release of Firestore is now available on all supported platforms.

6.11.0

• Overview
  • Updated dependencies, changed minimum Xcode, and fixed an issue in Database handling Auth token revocation.
• Changes
  • General (Editor): Added FirebaseAuth manifest file to FirebaseDatabase.unitypackage and FirebaseStorage.unitypackage for better package management through Play Services Resolver.
  • General (iOS): Minimum Xcode version is now 10.3.
  • General: When creating a FirebaseApp, the ProjectId from the default FirebaseApp is used if one is not provided.
  • Database (Desktop): Fixed that database stops reconnecting to server after the auth token is revoked.

6.10.0

• Overview
  • Auth bug fixes and resource generation improvements.
• Changes
  • Auth (iOS): Enabled the method OAuthProvider.GetCredential. This method takes a nonce parameter as required by Apple Sign-in.
  • Auth (Desktop): Fixed a deadlock that could cause the Unity Editor to freeze when disposing FirebaseAuth.
  • Editor: Python 3 compatibility for resource generation script and added a fallback to use the Python interpreter on Windows 7/8.
  • Editor: Removed debug logging when the resource generator script is executed.

6.9.0

• Overview
  • Updated dependencies, added support for Apple Sign-in to Auth, support for signing-in using a 3rd party web providers and configuration of BigQuery export in Messaging, fixed a Crashlytics build reporting bug with Python 3 and fixed core editor plugin loading issue on Windows.
• Changes
  • Auth: Added API for invoking FirebaseAuth.SignInWithProvider and User FirebaseUser.LinkWithProvider and FirebaseUser.ReauthenticateWithProvider for sign in with third party auth providers.
  • Auth: Added constant ProviderId strings to the provider classes.
  • Auth (iOS): Added support for linking Apple Sign-in credentials.
  • Crashlytics: Fixed build event reporting when Python 3 is installed on Mac or Linux machines.
  • Messaging (Android): Added the option to enable or disable message delivery metrics export to BigQuery. This functionality is currently only available on Android. Stubs are provided on iOS for cross platform compatibility.
  • Editor: Fixed core editor plugin so that it loads without the iOS Unity extension installed on Windows.

6.8.1

• Overview
  • Fixed Crashlytics and core editor plugin.
• Changes
  • Crashlytics (Editor): Fixed Crashlytics editor plugin so that it loads without the iOS Unity extension installed.
  • Editor: Fixed core editor plugin so that it loads without the iOS Unity extension installed.

6.8.0

• Overview
  • Updated dependencies and fixed resource generation issue with python3.
• Changes
  • Editor: Fixed an issue where resource generation from google-services.json or GoogleService-Info.plist would fail if python3 was used to execute the resource generation script.

6.7.0

• Overview
  • Updated dependencies, fixed issues in Analytics, Database, Dynamic Links, Crashlytics, and Storage.
• Changes
  • Storage (iOS/Android): Fixed an issue where FirebaseStorage.GetReferenceFromUrl would return an invalid StorageReference.
  • Dynamic Links: Fixed an issue where removing delegate from DynamicLinks.DynamicLinkReceived does not stop the delegate from being called.
  • Database: Fixed an issue causing timestamps to not be populated correctly when using DatabaseReference.UpdateChildren().
  • Database (Desktop): Fixed an issue preventing listener events from being triggered after DatabaseReference.UpdateChildren() is called.
  • Database (Desktop): Functions that take string parameters will now fail gracefully if passed a null pointer.
  • Database (Desktop): Fixed an issue that could result in an incorrect snapshot being passed to listeners under specific circumstances.
  • Database (Desktop): Fixed an issue causing DatabaseReference.RunTransaction() to fail due to datastale when the location previously stored a list with more than 10 items or a dictionary with integer keys.
  • Crashlytics: Fixed an issue on iOS with Unity 2019.3 beta where the plugin fails to create a XCode run script to upload symbols.
  • Analytics (iOS): Fixed the racy behavior of FirebaseAnalytics.GetAnalyticsInstanceId() after calling FirebaseAnalytics.ResetAnalyticsData().

6.6.0

• Overview
  • Updated dependencies, fixed issues in Auth & Database.
• Changes
  • Auth (Desktop): Fixed not loading provider list from cached user data.
  • Database (Desktop): Fixed a crash that could occur when trying to keep a location in the database synced when you do not have permission.
  • Database (Desktop): Queries on locations in the database with query rules now function properly, instead of always returning "Permission denied".
  • Database (Desktop): Fixed the map-to-vector conversion when firing events that have maps containing enitrely integer keys.

6.5.0

• Overview
  • Updated dependencies, improved logging for Auth and Database, and fixed the freeze in the editor.
• Changes
  • General: The instance of FirebaseApp, FirebaseAuth, FirebaseDatabase, FirebaseFunctions, FirebaseInstanceId and FirebaseStorage will be kept alive after creation until explicitly disposed.
  • Auth (Linux): Improved error logging if libsecret (required for login persistence) is not installed on Linux.
  • Database: The database now supports setting the log level independently of the system level logger.
  • Auth/Database (Desktop): Fixed the freeze when playing in the editor for the more than once or when closing the editor, when keeping a static reference to either FirebaseAuth or FirebaseDatabase instances.

6.4.0

• Overview
  • Updated dependencies, improved error handling in the iOS build logic, improved error handling with deleted objects, fixed an issue with Auth persistence, and fixed a crash in Database.
• Changes
  • General: Added more underlying null checks when accessing objects that can potentially be deleted, throwing exceptions instead of crashing.
  • General (iOS): Handle malformed Info.plist files when patching Xcode projects.
  • Auth (Desktop): Fixed an issue with updated user info not being persisted.
  • Database (Desktop): Fixed a crash with saving a ServerTimestamp during a transaction.

6.3.0

• Overview
  • Auth (iOS): Fixed an exception in Firebase.AuthVerifyPhoneNumber.
• Changes
  • General (Editor): Fixed spurious errors about missing google-services.json file.
  • General (iOS/Android): Fixed a bug that allows custom FirebaseApp instances to be created after the app has been restarted
  • Auth (Desktop): Changed destruction behavior. Instead of waiting for all async operations to finish, now Auth will cancel all async operations and quit. For callbacks that are already running, this will protect against cases where auth instances might not exist anymore.
  • Auth (iOS): Fixed an exception in PhoneAuthProvider.verifyPhoneNumber.
  • Auth (iOS): Stopped Auth from hanging on destruction if any local tasks remain in scope.
  • Database (Desktop): Fixed an issue that could cause a crash when updating the descendant of a location with a listener attached.

6.2.2

• Overview
  • Bug fixes.
• Changes
  • General (Editor): Worked around regression in Unity 2019.2 and 2019.3 which caused DllNotFoundException.
  • General (Editor, macOS): Add support for macOS 10.11.x.
  • Auth (Editor): After loading a persisted user data, ensure token is not expired.
  • Auth (desktop): Ensure Database, Storage and Functions do not use an expired token after it's loaded from persistent storage.
  • Database (Editor): Fixed a crash when calling UpdateChildrenAsync.
  • Database (Editor): Deprecated service account authentication.
  • Database (Editor): Fixed DatabaseReference.RunTransaction() sending invalid data to the server which causes error message "Error on incoming message" and freeze.
• Known Issues
  • Database/Storage/Functions may fail to send authentication token to server if FirebaseAuth is garbage-collected. If you are unable to access to the server due to "Permission Denied", please try to keep FirebaseAuth alive.

6.2.1

• Overview
  • Fixed Crashlytics on Android not working correctly.
• Changes
  • Crashlytics (Android): Fixed an issue causing Crashlytics to believe it was shut down, blocking all functionality.

6.2.0

• Overview
  • Moved Realtime Database to a C++ implementation on desktop, added support for custom domains to Dynamic Links, and fixed issues in Database, Instance ID, and Crashlytics.
• Changes
  • General (Editor): Fixed an issue that could cause errors when trying to read a google-services.json file with unicode characters in its path.
  • General (Editor, iOS): Added support for patching Xcode projects in Unity 2019.3+.
  • General: Fixed a race that could lead to a crash when gabarge collecting FirebaseApp objects.
  • General: Updated Play Services Resolver from 1.2.116 to 1.2.121 For more information, see this document. Added support for the Jetpack Jetifier , this allows the use of legacy Android support libraries with the latest release of Google Play Services that uses AndroidX.
  • Crashlytics (Android): Fixed a crash when logging large call stacks.
  • Crashlytics (Android): Fixed a crash in exception logging when the application is shutting down.
  • Instance ID (Android): Fixed a crash when destroying InstanceID objects.
  • Instance ID: Fixed a crash if multiple Instance ID objects are created and destroyed quickly.
  • Dynamic Links: Added support for custom domains.
  • Database (Editor): Moved Realtime Database to a C++ implementation on desktop to improve reliability across different Unity versions.
  • Database (Editor): Moved transaction callbacks to the main thread to mirror Android and iOS.
  • Database: Added a way to configure log verbosity of Realtime Database instances.

6.1.1

• Overview
  • Fixed an issue when generating Firebase config files on Windows.
• Changes
  • General (Editor): Fixed an issue when generating Firebase config files on Windows.
  • General (Editor): Upgraded Play Services Resolver to from 1.2.115 to 1.2.116. For more information see this document.

6.1.0

• Overview
  • Added Auth credential persistence on Desktop, fixed and cleaned up some documentation, converted testapps to use ContinueOnMainThread(), fixed issues in Auth and Database, and added additional information to Messaging notifications.
• Changes
  • General (Editor): Removed Firebase Invites documentation from the in-editor documentation.
  • General (Editor): Fixed an issue with resource generation when Firebase plugin files have been moved from their default locations.
  • General (iOS): Fixed an issue where connections via NSURLSession (used internally by the iOS SDK) can be prematurely closed by the client if NSAppTransportSecurity is set to YES in the Info.plist and NSAllowsArbitraryLoadsInWebContent is not set. This can be fixed by setting NSAllowsArbitraryLoadsInWebContent to the same value as NSAppTransportSecurity.
  • General (Editor): Upgraded Play Services Resolver to from 1.2.109 to 1.2.115. For more information see this document.
  • Auth (Desktop): User's credentials will now persist between sessions. See the documentation for more information.
  • Auth (Desktop): As part of the above change, if you access CurrentUser immediately after creating the FirebaseAuth instance, it will block until the saved user's state is finished loading.
  • Auth (Desktop): Fixed an issue where Database/Functions/Storage might not use the latest auth token immediately after sign-in.
  • Auth (Android): Fixed an issue where an error code could get reported incorrectly on Android.
  • Crashlytics, Functions: Fixed an issue that could cause a crash during shutdown due to the destruction order of plugins being nondeterministic.
  • Database (iOS): Fixed a race condition that could cause a crash when cleaning up database listeners on iOS.
  • Database (iOS): Fixed an issue where long (64-bit) values could get written to the database incorrectly (truncated to 32-bits) on 32-bit devices.
  • Messaging (Android): Added channel_id to Messaging notifications.

6.0.0

• Overview
  • Released Crashlytics as generally available (GA); added Task.ContinueWithOnMainThread(); fixed issues in the Android Resolver, iOS Resolver, Auth, Database, Messaging, and Remote Config; removed Firebase Invites, removed deprecated methods in Firebase Remote Config, and deprecated a method in Firebase Analytics.
• Changes
  • Updated Firebase iOS and Firebase Android dependencies.
  • Crashlytics (iOS/Android): Crashlytics for Unity is now generally available (GA). Get the next evolution with BigQuery exports, Jira integration, and more. To migrate from Fabric Crashlytics for Unity to Firebase Crashlytics, follow the migration guide.
  • Added an extension method, Task.ContinueWithOnMainThread(), which forces the continuation of asynchronous operations to occur in the Unity main thread rather than in a background thread.
  • General: Upgraded Play Services Resolver to from 1.2.104 to 1.2.109. For more information see this document.
  • General (Android): Added support for Android SDK installed directly in Unity 2019.
  • General (iOS): Fixed issues generating projects without using Cocoapods.
  • Database (iOS/Android): Fixed an issue where integrating the SDK greatly increased the size of your app.
  • Database: Fixed exception handling during listener events.
  • Remote Config: Fixed an issue parsing boolean values.
  • Auth (Desktop): Fixed a crash when attempting to call Game Center authentication methods from the Unity editor.
  • Messaging (iOS/Android): Fix an issue where Subscribe and Unsubscribe never returned if the API was configured not to receive a registration token.
  • Invites: Removed Firebase Invites, as it is no longer supported.
  • Remote Config: Removed functions using config namespaces.
  • Analytics: Deprecated SetMinimumSessionDuration.

5.7.0

• Overview
  • Fixed an issue with escape characters in Auth, deprecated functions in Remote Config, and fixed an issue in the Android Resolver.
• Changes
  • Auth: Fixed UserProfile.PhotoUrl removing percent encoded characters when being set.
  • Remote Config: Config namespaces are now deprecated. You'll need to switch to methods that use the default namespace.
  • General (Android): Fixed an exception on resolution in some versions of Unity 2017.4 by changing how Android ABI selection is handled.

5.6.1

• Overview
  • Fixed race condition on iOS SDK startup and fixed some issues in the Android Resolver.
• Changes
  • General (iOS): Updated to the latest iOS SDK to fix a crash on firebase::App creation caused by a race condition. The crash could occur when accessing the [FIRApp firebaseUserAgent] property of the iOS FIRApp.
  • General (Android): Fixed Java version check in Android resolver when using Java SE 12 and above.
  • General (Android): Whitelisted Unity 2017.4 and above for ARM64 builds. Previously required ARM64 libraries would be stripped from all Unity 2017 builds resulting in a DllNotFoundException.

5.6.0

• Overview
  • Added Game Center sign-in to Auth and fixed intermittent crashes due to garbage collection.
• Changes
  • Auth (iOS): Added Game Center authentication.
  • General: Fixed intermittent crashes caused when multiple native objects were garbage-collected at the same time.

5.5.0

• Overview
  • Added support for Crashlytics as a Beta release, deprecated Firebase Invites, and updated the Android Resolver.
• Changes
  • Crashlytics: Crashlytics for Unity is now available as a Beta release. Get the next evolution with BigQuery exports, Jira integration, and more. To migrate from Fabric Crashlytics for Unity to Firebase Crashlytics, follow the migration guide.
  • General (Android): Updated to using version 1.2.101 of the Android Resolver. Prompt the user before the resolver runs for the first time and allow the user to elect to disable from the prompt.
  • Invites: Firebase Invites is deprecated. Please refer to https://firebase.google.com/docs/invites for details.

5.4.4

• Overview
  • Fixed bugs in iOS/Android Resolver components, Realtime Database on mobile, and Cloud Functions on Android; fixed a general iOS bug; and fixed issues with Unity 5.6 and Unity 2018.3 and newer.
• Changes
  • General (Android): Fixed packaging of AARs in the Android Resolver when using Unity 2018 and a recent version of Gradle.
  • General: Reduced auto-resolution frequency in iOS and Android Resolvers, speeding up builds and reducing memory footprint.
  • General: Fixed an issue with version number handling in iOS and Android Resolvers.
  • General (iOS): Fixed an issue that caused apps to crash when exiting the app.
  • General: Fixed parsing of Unity 5.6 metadata.
  • General: Workaround for Unity 2018.3 and newer ignoring the "Any" platform.
  • Realtime Database (mobile): Fixed an issue where certain DataSnapshots were missing data.
  • Cloud Functions (Android): Fixed an issue with error handling.
• Known Issues
  • The garbage collection race condition mentioned in version 5.4.2 still occurs in Firebase Auth, Database, Storage, and Instance ID. To work around the issue until a fixed is released, keep a reference to the Firebase object instance (for example, FirebaseAuth.DefaultInstance) to prevent garbage collection.

5.4.3

• Overview
  • Bug fix for Firebase Storage on iOS.
• Changes
  • Storage (iOS): Fixed an issue when downloading files with GetBytesAsync.

5.4.2

• Overview
  • Updated iOS and Android dependency versions, and fixed issues in the Android Resolver, FirebaseApp, Auth on Android, Database, and Dynamic Links on iOS.
• Changes
  • General (Android): Fixed an infinite loop in Android Resolver when using auto-resolution.
  • App: Fixed a race condition causing an occasional crash when FirebaseApp is garbage collected.
  • Auth (Android): Removed an irrelevant error about the Java class FirebaseAuthWebException.
  • Database: Fixed a race condition causing an occasional crash when FirebaseDatabase is garbage collected.
  • Dynamic Links (iOS): Fixed Dynamic Links iOS when using Unity Cloud builds.
• Known Issues
  • The garbage collection race condition mentioned above still occurs in Firebase Auth, Storage, and Instance ID. To work around the issue until a fixed is released, keep a reference to the Firebase object instance (for example, FirebaseAuth.DefaultInstance) to prevent garbage collection.

5.4.1

• Overview
  • Fix for Google Analytics iOS dependency.
• Changes
  • Analytics (iOS): Fixed issue with Google Analytics and Google App Measurement mismatch.

5.4.0

• Overview
  • Improved support for .NET 4.x Unity projects, exposed method to enable Realtime Database peristence, bug fix for link shortening in Dynamic Links.
• Changes
  • General: Added plugins that are pre-configured for import into .NET 4.x Unity projects.
  • Realtime Database: Exposed method to enable persistence on mobile platforms.
  • Dynamic Links (Android): Fixed short link generation failing with "error 8".

5.3.1

• Overview
  • Updated iOS and Android dependency versions, bug fix for Invites, improved Android module initialization, fixed issue with Unity 2018.3 beta, added C# symbols and upgraded the Play Services Resolver.
• Changes
  • General: Added symbols for all C# assemblies.
  • General (Android): Improved module initialization so that the Unity SDK does not attempt to use Android libraries unless the C# assembly is included. For example, this allows users of the Firebase Analytics plugin to use the firebase-messaging Android library without the Firebase Unity Messaging component.
  • General (Editor): Fixed loading of the Firebase.Editor.dll component in Unity 2018.3.0b2
  • General (Editor): Updated the Play Services Resolver from version 1.2.88 to 1.2.91, see the GitHub changelog for details.
  • General (Editor): Fixed the Android "Open in Console" button of the Firebase window (accessible under the Window > Firebase menu option) to correctly open the Firebase console in a web browser when the selected target platform is not Android in Unity 5.6 and above.
  • Invites (Android): Fixed an exception when the Android Minimum Version code option is used on the Android.

5.3.0

• Overview
  • Fixed bugs in Database, Functions, Storage, and the Android Resolver; changed minimum Xcode version to 9.4.1.
• Changes
  • General (iOS): Minimum Xcode version is now 9.4.1.
  • General (Android): Fixed an issue resolving additional types of version conflicts in the Android Resolver.
  • General (Android): Fixed a hang in Unity 5.6.
  • Database (Desktop): Fixed issues in ChildListener.
  • Database (Desktop): Fixed a crash related to objects being garbage
  • Functions (Android): Fixed an issue when a function returns an array.
  • Storage: Fixed issues when transactions are canceled in .NET 4.6.
• Known Issues
  • Dynamic Links (Android): Shortening dynamic links fails with "Error 8".

5.2.1

• Overview
  • Updated Android and iOS dependency versions, and fixed bugs in App, Auth, Database, and the Android Resolver.
• Changes
  • General (Android): Fixed an issue resolving certain types of version conflicts in the Android Resolver.
  • App: Now throws an exception if any Firebase libraries are initialized while CheckAndFixDependenciesAsync() is still in progress.
  • Auth, Database: Fixed a race condition returning Tasks when calling the same method twice in quick succession.
  • Database (iOS/Android): Fixed a crash in DatabaseReference/Query during garbage collection (and other times).

5.2.0

• Overview
  • Fixed bugs in Auth, changes to Functions, Messaging and Android builds.
• Changes
  • Auth: Fixed per-frame allocation in the token refresh logic.
  • Auth (Android): Fixed a crash in FirebaseUser.UpdatePhoneNumberCredentialAsync().
  • Functions: Added a way to specify which region to run the function in.
  • Messaging: Added SubscribeAsync and UnsubscribeAsync, which return Tasks, and deprecated Subscribe and Unsubscribe.
  • General (Android): Fixed a null reference in the Google Play Services availability checker.
  • General (Android): Fixed Android problems merging Android library manifests in Unity 2018.
  • General (Android): Added arm64-v8a build support.

5.1.1

• Overview
  • Updated Android and iOS dependency versions only.

5.1.0

• Overview
  • Changes to Analytics, Auth, and Database; and added Cloud Functions for Firebase.
• Changes
  • Android (General): Fixed build issues due to the broken AndroidManifest merger in Unity 2018.x.
  • Android (General): Improved compatibility with plugins that use Google Play services versions older than 15.0.0.
  • Android (General): Improved dependency resolution when the Android SDK path is not configured.
  • Analytics: Added ResetAnalyticsData() to clear all analytics data for an app from the device.
  • Analytics: Added GetAnalyticsInstanceIdAsync() which allows developers to retrieve the current app's analytics instance ID.
  • Auth: Linking a credential with a provider that has already been linked now produces an error.
  • Auth (iOS): Fixed crashes in FirebaseUser.LinkAndRetrieveDataWithCredential() and FirebaseUser.ReauthenticateAndRetrieveData().
  • Auth (iOS): Fixed photo URL never returning a value on iOS.
  • Auth (Android): Fixed setting the profile photo URL with FirebaseUser.UpdateUserProfile().
  • Database: Added support for ServerValues in SetPriority methods.
  • Database (iOS / Android): Now implemented as a wrapper around Firebase iOS and Android SDKs, to add offline support and increase reliability and performance.
  • Functions: Added support for Cloud Functions for Firebase on iOS, Android, and desktop.

5.0.0

• Overview
  • Renamed the static libraries to include firebase in their name, removed deprecated methods in App, Auth, and Storage, and exposed new APIs in Dynamic Links and Invites.
• Changes
  • General: Library names that previously did not mention Firebase now have a "FirebaseCpp" prefix. For example, Auth.dll is now FirebaseCppAuth.dll.
  • General (Android): Improved error handling when device is out of space.
  • App: Removed deprecated method SetLogLevel.
  • Auth: Removed deprecated properties PhotoUri and RefreshToken.
  • Dynamic Links: Added MatchStrength to ReceivedDynamicLink, that describes the strength of the match for the received link.
  • Invites: Added MatchStrength to InvitesReceivedEventArgs, that describes the strength of the match for the received invite.
  • Storage: Deprecated StorageMetadata.DownloadUrl and StorageMetadata.DownloadUrls. Please use StorageReference.GetDownloadUrlAsync() instead.
  • Messaging: Added an optional initialization options struct. This can be used to suppress the prompt on iOS that requests permission to receive notifications at start up. Permission can be requested manually using the function FirebaseMessaging.RequestPermissionAsync().

4.5.2

• Overview
  • Fixed a build issue, and bugs in FirebaseApp, Auth and Linux Desktop.
• Changes
  • Common: Updated Parse .NET 4.6 forwarding DLLs to fix build issues when using IL2CPP with the .NET 4.6 framework. The update works with IL2CPP in Unity 2017.2 and beyond. IL2CPP builds still fail in Unity 2017.1 as the IL2CPP distribution bundled with Unity 2017.1 does not correctly support type forwarding DLLs.
  • Common: Root cert installation is now only performed in plugins that use the .NET network stack (currently only the Realtime Database). This should resolve exceptions on initialization that reference /System/Library/Frameworks/CoreFoundation.framework/CoreFoundation.
  • Common (Desktop): Fixed crash when using Firebase Auth, Storage, Realtime Database and Remote Config on Linux.
  • Common (Android): Loading default AppOptions is now more robust on Android resulting in errors reported for missing fields rather than exiting the application with an error in the native library.
  • Auth: Fixed regression in release 4.5.0 which led to an unhandled exception on auth token refresh.
• Known Issues
  • IL2CPP builds will fail in Unity 2017.1 as the IL2CPP distribution bundled with Unity 2017.1 does not correctly support type forwarding DLLs.

4.5.1

• Overview
  • Fixed some build issues, fixed bugs in Database, Dynamic Links, Invites, Remote Config, and Storage, and exposed new APIs in Auth on Desktop and Analytics.
• Changes
  • Auth (Desktop): Added support for accessing user metadata.
  • Analytics: Added SetMinimumSessionDuration() and SetSessionTimeoutDuration().
  • Desktop: Fixed a bug when using iOS GoogleServicesInfo.plist config settings on desktop, which prevented "play in editor" mode from loading the correct project settings. (Only affected users who developed for iOS and not Android, who were using Desktop).
  • Dynamic Links and Invites (Android): Fixed an issue with Dynamic Links getting lost when calling CheckAndFixDependenciesAsync.
  • Messaging: Added TokenRegistrationOnInitEnabled property to enable or disable auto-token generation.
  • Remote Config: Fixed a bug causing incorrect reporting of success or failure during a Fetch().
  • Storage: Fixed a bug in Storage that was unescaping '/' characters in URL returned by StorageReference.GetDownloadUrlAsync(). This caused an "Invalid HTTP method/URL pair" error when attempting to download using the URL.
  • General (Android): Fixed a bug causing Unity to hang due to FirebaseApp initializing on the wrong thread, when building in -batchmode.

4.5.0

• Overview
  • Desktop workflow support for some features, Google Play Games authentication on Android, improved editor support, and changes to Auth, Instance ID and Storage.
• Changes
  • General: Added support for plugins within the Unity Editor context.
  • Auth, Remote Config: Stub implementations have been replaced with functional desktop implementations on Windows, OS X and Linux.
  • Auth (Android): Added support for Google Play Games authentication.
  • Auth, Instance ID: Fixed issues when destroying/finalizing Firebase objects.
  • Storage: Added Md5Hash to StorageMetadata.
  • Storage (iOS / Android): Now implemented as wrapper around Firebase iOS and Android SDKs, to increase reliability and performance.
• Known Issues
  • On Windows and Mac OS, only 64-bit builds are supported (x86_64), not 32-bit.

4.4.3

• Overview
  • Bug fixes in Dynamic Links, Invites, Remote Config and Storage.
• Changes
  • Dynamic Links (iOS): Now fetches the invite ID when using universal links.
  • Dynamic Links (iOS): Fixed crash on failure of dynamic link completion.
  • Dynamic Links (iOS): Fixed an issue where some errors weren't correctly reported.
  • Invites (Editor): Fixed SendInvite never completing.
  • Remote Config (iOS): Fixed an issue where some errors weren't correctly reported.
  • Storage: Fixed Metadata::content_language returning the wrong data.
  • Storage (iOS): Reference paths formats are now consistent with other platforms.
  • Storage (iOS): Fixed an issue where trying to upload to a non-existent path would not complete the Task.
  • Storage (iOS): Fixed a crash when a download fails.
  • Editor: Fixed a crash in the editor when using .NET 4.6 with certain versions of Unity 2017.
  • General (Android): Fixed an issue when Google Play Services was out of date and would hang after returning from the update workflow.

4.4.2

• Overview
  • Updated Firebase iOS dependency version.
• Changes
  • General (iOS): Updated Firebase iOS Cocoapod dependency version.

4.4.1

• Overview
  • Bug fixes for .Net 4.x, Storage, Realtime Database, and Instance ID on iOS.
• Changes
  • Instance ID (iOS): GetTokenAsync no longer fails without an APNS certificate, and no longer forces registering for notifications.
  • Storage: Added support for a progress listener and cancellation token to GetBytesAsync.
  • Storage: Fixed an issue where the auth token was not refreshed when the application is started.
  • Realtime Database: Fixed an issue where the auth token was not refreshed when the application is started.
  • General (Android): Fixed a bug with handling transitive dependencies in the Android Resolver, where there was a common dependency name from different sources.
  • General (Android): Fixed Android Resolver reporting non-existent conflicts.
  • General: Fixed 'get_realtimeSinceStartup' Assert in development builds.
  • General: Fixed issues when using types added in .NET 4.x such as Tuple. This requires switching to the appropriate Unity.Compat.dll when using .NET 4.x (see Known Issues).

4.4.0

• Overview
  • Support for Instance ID, and an Auth fix.
• Changes
  • Instance ID: Added Instance ID library.
  • Auth: Fixed user metadata property names.

4.3.0

• Overview
  • General threading / callback and other bug fixes and new features in Auth.
• Changes
  • General: Fixed some invalid calls to Unity APIs from threads.
  • General (Editor): Changed Firebase settings window to work with Unity 4.x
  • General (Editor): Fixed GoogleServices-Info.plist not being read in batch mode.
  • Auth: Fixed a bug due to a race condition fetching the authentication token which could cause Database and Storage operations to hang.
  • Auth: Added support for accessing user metadata.
  • Remote Config (Android): Fixed a bug where remote config values retrieved were misclassified as coming from a default config vs an active config.
  • Database: Fixed hang when Time.timeScale is 0.
  • Storage: Fixed hang when Time.timeScale is 0.

4.2.1

• Overview
  • Bug fixes for Real-Time Database, Storage, API initialization in .NET 4.x, and improvements to the iOS and Android Resolver components.
• Changes
  • General (Android): Fixed Android resolution when a project path contains apostrophes.
  • General (iOS): Increased speed of iOS resolver dependency loading.
  • General (Android): Removed legacy resolution method from Android Resolver. It is now only possible to use the Gradle or Gradle prebuild resolution methods.
  • General (Android): Fixed Android Resolution issues with OpenJDK by updating the Gradle wrapper to 4.2.1.
  • General (Android): Android resolution now also uses gradle.properties to pass parameters to Gradle in an attempt to workaround problems with command line argument parsing on Windows 10.
  • General: Fixed some invalid calls to Unity APIs from threads, when using .NET 4.x which is added in Unity 2017.
  • Database: Fixed hang in Real-Time Database when Time.timeScale is 0 in Unity 2017.
  • Storage: Fixed hang in Storage when Time.timeScale is 0 in Unity 2017.
  • Storage: Fixed file download in Unity 2017.2.

4.2.0

• Overview
  • Added URL support in Messaging, improved the initialization process on Android and fixed bugs in the iOS and Android build systems, Analytics, Auth, Database and Messaging.
• Changes
  • Messaging: Messages sent to users can now contain a link URL.
  • Auth: Added more specific error codes for failed operations.
  • Auth (iOS): Phone Authentication no longer requires push notifications. When push notifications aren't available, reCAPTCHA verification is used instead.
  • Analytics (iOS): Fixed bug which prevented the user ID and user properties being cleared.
  • Database: Fixed issue where user authentication tokens are ignored if the application uses the database API before initializing authentication.
  • Messaging (Android): Fixed a bug which prevented the message ID field being set.
  • General (iOS): Fixed incorrect processing of framework modulemap files which resulted in the wrong link flags being generated when Cocoapod project integration is enabled.
  • General (Android): Added support for Google Play services dependency resolution when including multiple plugins (e.g AdMob, Google Play Games services) that require different versions of Google Play services.
  • General (Android): Fixed Android dependency resolution when local project paths contain spaces.
  • General (Android): Fixed race condition in Android Resolver which could cause a hang when running auto-resolution.
  • General (Android): Forced Android Gradle resolution process to not use the Gradle daemon to improve reliability of the process.
  • General (Android): Added a check for at least JDK 8 when running Android dependency resolution.
  • General: Fixed MonoPInvokeCallbackAttribute incorrectly being added to the root namespace causing incompatibility with plugins like slua.
• Known Issues
  • General (Android): Unity (not the Firebase SDK) has a bug that causes applications to crash after running the Google Play services update on Android 8.0 Oreo devices.

4.1.0

• Overview
  • Bug fixes for the iOS build system, Auth, Messaging, and Remote Config.
• Changes
  • General (iOS): Fixed spurious errors on initialization of FirebaseApp.
  • General (iOS): Fixed iOS build with Cocoapod Project integration enabled. This affected all iOS builds when using Unity 5.5 or below or when using Unity Cloud Build.
  • General (iOS): Fixed issue which prevented the use of Unity Cloud Build with Unity 5.6 and above. Unity Cloud Build does not open generated Xcode workspaces so we force Cocoapod Project integration in the Unity Cloud Build environment.
  • Auth (Android): Now throws an exception if you call GetCredential without an Auth instance created.
  • Messaging (Android): Fixed a bug resulting in FirebaseMessages not having their MessageType field populated.
  • Messaging (iOS): Fixed a race condition if a message is received before Firebase Cloud Messaging is initialized.
  • Messaging (iOS): Fixed a bug detecting whether the notification was opened if the app was running in the background.
  • Remote Config: When listing keys, the list now includes keys with defaults set, even if they were not present in the fetched config.

4.0.3

• Overview
  • Bug fixes for Database, Dynamic Links, Messaging, iOS SDK compatibility, .NET 4.x compatibility.
• Changes
  • General: Added support for .NET 4.x in the System.Task implementation used by the SDK. The VersionHandler editor plugin is now used to switch Task implementations based upon the selected .NET version.
  • General: Fixed root cert installation failure if Firebase is initialized after other network operations are performed by an application.
  • General: Improved native shared library name mangling when targeting Linux.
  • General (iOS): Fixed an issue which resulted in custom options not being applied to FirebaseApp instances.
  • General (iOS): Fixed a bug which caused method implementation look ups to fail when other iOS SDKs rename the selectors of swizzled methods. This could result in a hang on startup when using some iOS SDKs.
  • Dynamic Links (Android): Fixed task completion if short link creation fails.
  • Database: Fixed a bug that caused database connections to fail when using the .NET 4.x framework in Unity 2017 on OSX.
  • Database: Fixed a bug where large data updates could be ignored.
  • Messaging (iOS): Fixed message handling when messages they are received via the direct channel to the FCM backend (i.e not via APNS).

4.0.2

• Overview
  • Bug fixes for Analytics, Auth, Dynamic Links, and Messaging; added support for Android SDK 25.
• Changes
  • General (Android): Fixed a manifest issue with Android SDK tools and support library >= 25.x.
  • General (Android): Fixed an issue which caused Analytics to not be enabled in all plugins.
  • General (Android): Fixed native libraries not being included in built APKs when using the internal build system in Unity 2017.
  • Analytics (Android): Fix SetCurrentScreen to work from any thread.
  • Auth (iOS): Fixed user being invalidated when linking a credential fails.
  • Dynamic Links: Fixed an issue which caused an app to crash or not receive a Dynamic Link if the link is opened when the app is installed and not running.
  • Messaging (iOS): Fixed a crash when no notification event is registered.
  • Messaging: Fixed token notification event occasionally being raised twice with the same token.

4.0.1

• Overview:
  • Bug fixes for Dynamic links and Invites on iOS, the Google Play services updater when using Cloud Messaging and Cloud Messaging on iOS.
• Changes:
  • Cloud Messaging (Android): Fixed crash when updating Google Play services in projects that include the Cloud Messaging functionality.
  • Cloud Messaging (iOS): Fixed an issue where library would crash on start up if there was no registration token.
  • Dynamic Links & Invites (iOS): Fixed an issue that resulted in apps not receiving a link when opening a link if the app is installed and not running.

4.0.0

• Overview
  • Added support for phone number authentication, access to user metadata, a standalone dynamic links plugin and bug fixes.
• Changes
  • Auth: Added support for phone number authentication.
  • Auth: Added the ability to retrieve user metadata.
  • Auth: Moved token notification into a separate token change event.
  • Dynamic Links: Added a standalone Unity plugin separate from Invites.
  • Invites (iOS): Fixed an issue in the analytics SDK's method swizzling which resulted in dynamic links / invites not being sent to the application.
  • Messaging (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.
  • Messaging (iOS): Fixed interoperation with other users of local notifications.
  • General (Android): Fixed crash in some circumstances after resolving dependencies by updating Google Play services.
  • General (Editor): Fixed iOS resolver and Jar resolver plugins getting disabled when importing multiple Firebase, Google Play Games or AdMob plugins into a project.
  • General (iOS): Added support for Cocoapod builds that use Xcode workspaces in Unity 5.6 and above.
  • General (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.

3.0.3

• Overview
  • Bug fixes for Auth.
• Changes
  • Auth: 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.
  • Auth: Fixed potential memory corruption when AuthStateListener is destroyed.
  • Auth: Fixed occasional crash in Unity editor when using Auth sign-in methods.

3.0.2

• Overview
  • Bug fixes for Auth, Database, Invites, Messaging, Storage, and a general fix, plus improved compatibility with Unity 5.6 when using the GoogleVR SDK.
• Changes
  • General (Android): Fixed unhandled exception if FirebaseApp creation fails due to an out of date Google Play services.
  • General (Android): Fixed Google Play Services updater crash when clicking outside of the dialog on Android 4.x devices.
  • Auth: Fixed user being invalidated when linking a credential fails.
  • Auth: Fixed an occasional crash when events are fired. This could manifest in a crash when signing in.
  • Auth: Deprecated FirebaseUser.RefreshToken.
  • Database: Fixed an issue which caused the application to manually refresh the auth token.
  • Messaging: Fixed incorrectly notifying the app of a message when a notification is received while the app is in the background and the app is then opened by via the app icon rather than the notification.
  • Invites (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.
  • Storage: Fixed a bug that prevented the construction of Metadata without a storage reference.
  • Editor (Android): Fixed referenced Android dependencies in maven where the POM references a specific version e.g. '[1.2.3]'.
  • Editor (iOS): Improved compatibility with Unity 5.6's Cocoapods support required to use the GoogleVR SDK.
  • Editor (Android): Fixed Android dependency resolution when the bundle ID is modified.

3.0.1

• Overview
  • Fixed Google Play Services checker on Android and improved Android build configuration checks.
• Changes
  • (Android): Fixed Google Play Services checker on Android. Previously when Google Play Services was out of date, FirebaseApp.CheckDependencies() incorrectly returned DependencyStatus.Available.
  • Editor (Android): Added check for auto-resolution being enabled in the Android Resolver. 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.
  • (Android) Fixed single architecture builds when using Gradle.
  • (Android) Resolved an issue which caused the READ_PHONE_STATE permission to be requested.

3.0.0

• Overview
  • Streamlined editor integration, build support and some bug fixes for Auth, Database, Messaging, Invites and Storage.
• Changes
  • Added link.xml files to allow byte stripping to be enabled.
  • Fixed issues with Android builds when targeting a single ABI.
  • Auth: Fixed race condition when accessing user properties.
  • Auth: Added SetCurrentScreen() method.
  • Database: Resolved issue where large queries resulted in empty results.
  • Database: Fixed an issue which prevented saving boolean values.
  • Mesaging: Fixed issue with initialization on iOS that caused problems with other SDKs.
  • Invites: Fixed issue with initialization on iOS that caused problems with other SDKs.
  • Storage: Fixed a bug which prevented download URLs from containing slashes.
  • Storage: Fixed a bug on iOS which caused networking to fail when the full .NET 2.0 is used.
  • Editor: Added process of cleaning stale / moved files when upgrading to a newer plugin version.
  • Editor: Automated Cocoapod tool installation and improved Pod tool detection when using RVM. This enables iOS projects to build with Unity Cloud Build.
  • Editor: Added support for pods that reference static libraries.
  • Editor: Bundle ID selection dialog for iOS and Android is now displayed when the project bundle ID doesn't match the Firebase configuration.
  • Editor: Added experimental support for building with Proguard stripping enabled.
  • Editor: Fixed Android package (AAR) synchronization when the project bundle ID is modified.
  • Editor: Fixed clean up of stale AAR dependencies when users change Android SDK versions.
  • Editor: 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.
  • Editor: Added support for projects that use Google Play Services at different versions.
  • Editor: Fixed minor issue with the Firebase window not being repainted as Firebase configuration files are added to or removed from a project.
  • Desktop: Added fake - but valid - JWT in the Authentication mock.

1.1.2

• Overview
  • Fix for a major bug causing Auth to hang, as well as other bug fixes.
• Changes
  • Auth: Fixed a potential deadlock when running callbacks registered via Task.ContinueWith()
  • Auth: (Android) Fixed an error in Firebase.Auth.FirebaseUser.PhotoUrl.
  • Messaging: (iOS) Removed hard dependency on Xcode 8.
  • Messaging: (Android) Fixed an issue where the application would receive an empty message on startup.

1.1.1

• Overview
  • Bug fixes for the editor plugin, Firebase Authentication, Messaging, Invites, Real-Time Database and Storage.
• Changes
  • 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 a bug in the editor plugin that caused a stack overflow when multiple iOS configuration files (GoogleServices-Info.plist) are present in a project.
  • Auth: (Android) Fixed an issue that caused a Task to never complete when signing in while a user is already signed in.
  • Auth: Renamed the Auth.UserProfile.ProtoUri property to Auth.UserProfile.ProtoUrl in order to be consistent with the other URL properties across the SDK.
  • Messaging / Invites: Fixed an issue with method swizzling that caused some of the application's UIApplicationDelegate methods to not be called.
  • Storage: 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.
  • Real-Time Database: Fixed an issue that prevented saving floating point values.

1.1.0

• Overview
  • Added support for Firebase Storage and bug fixes.
• Changes
  • Added support for Firebase Storage.
  • Fixed crash in Firebase Analytics when logging arrays of parameters.
  • Fixed crash in Firebase Messaging when receiving messages with empty payloads on Android.
  • Fixed random hang when initializing Firebase Messaging on iOS.
  • Fixed topic subscriptions in Firebase Messaging.
  • Fixed an issue that resulted in a missing app icon when using Firebase Messaging on Android.
  • Fixed exception in error message construction when FirebaseApp initialization fails.
  • Fixed reporting of null events in the Firebase Realtime Database.
  • Fixed unsubscribe for complex queries in the Firebase Realtime Database.
  • Fixed service account authentication in the Firebase Realtime Database.
  • Fixed Firebase.Database.Unity being stripped from iOS builds.
  • Fixed support for building with Firebase plugins in Microsoft Visual Studio.
  • Fixed scene transitions causing event routing to break across all components.
  • Changed editor plugins for Firebase Authentication and Invites to return success for all operations instead of raising exceptions.
  • Changed editor plugin to read JAVA_HOME from the Unity editor preferences.
  • Changed editor plugin to scan all google-services.json and GoogleService-Info.plist files in the project and select the config file matching the project's current bundle ID.
  • Improved the performance of AAR / JAR resolution when the Android config is selected and auto-resolution is enabled.
  • Improved error messages in the editor plugin.
• Known Issues
  • Proguard is not integrated into Android builds. We have distributed proguard files that can be manually integrated into Android builds within AAR files matching the following pattern in each Unity package: Firebase/m2repository/com/google/firebase/firebase-*-unity/*firebase-*.srcaar
  • Incompatible AARs are not resolved correctly when building for Android. This can require manual intervention when using multiple plugins (e.g Firebase + AdMob + Google Play Games). A workaround is documented on the AdMob Unity plugin issue tracker.

1.0.1

• Overview
  • Bug fixes.
• Changes
  • Fixed Realtime Database restricted access from the Unity Editor on Windows.
  • Fixed load and build errors when iOS support is not installed.
  • Fixed an issue that prevented the creation of multiple FirebaseApp instances and customization of the default instance on iOS.
  • Removed all dependencies on Python for Android resource generation on Windows.
  • Fixed an issue with pod tool discovery when the Ruby Gem binary directory is modified from the default location.
  • Fixed problems when building for Android with the IL2CPP scripting backend.
• Known Issues
  • Proguard is not integrated into Android builds. We have distributed proguard files that can be manually integrated into Android builds within AAR files matching the following pattern in each Unity package: Firebase/m2repository/com/google/firebase/firebase-*-unity/*firebase-*.srcaar

1.0.0

• Overview
  • First public release with support for Firebase Analytics, Authentication, Real-time Database, Invites, Dynamic Links and Remote Config. See our setup guide to get started.
• Known Issues
  • Proguard is not integrated into Android builds. We have distributed proguard files that can be manually integrated into Android builds within AAR files matching the following pattern in each Unity package: Firebase/m2repository/com/google/firebase/firebase-*-unity/*firebase-*.srcaar