You're viewing the legacy docs. They are deprecated as of May 18, 2016.
These docs are for version 2.5.1 and below of the Objective-C SDK. Go to our current docs, or see our iOS migration guide.

Official Code Releases @firebaserelease

iOS Changelog

iOS Client

Mar 15, 2016 - Version 2.5.1
fixed Fixed a potential crash when pruning the persistent cache.
fixed Fixed an issue introduced in 2.5.0 where the client may not correctly synchronize new changes from the server when listening to a query with an orderBy* but no other filters (startAt*, endAt*, etc.).
Dec 15, 2015 - Version 2.5.0
feature Resynchronizing data after a reconnect or an app restart (with persistence enabled) has been optimized to use significantly less bandwidth.
fixed Fixed an issue causing OS X apps to hang on startup when disk persistence is enabled.
Nov 18, 2015 - Version 2.4.3
fixed Fixed issue that could prevent Firebase from reconnecting in some cases.
Oct 8, 2015 - Version 2.4.2
fixed Fixed issue with CocoaPods deployment.
Sep 30, 2015 - Version 2.4.1
fixed Fixed warnings for missing debug symbols.
Sep 24, 2015 - Version 2.4.0
feature updateChildValues: now supports deep paths in addition to child keys.
feature orderByChild: now supports deep paths in addition to child keys.
changed OSX now requires a separate dependency (coming soon, please use 2.3.2 until then).
changed Auth token is now accessible after first device unlock.
changed SDK is now compiled with Bitcode support.
fixed Fixed an edge case leading to cache inconsistencies (related to certain combinations of queries and deep updateChildValues: calls).
fixed Fixed a crash caused by "duplicate" listens.
Jul 17, 2015 - Version 2.3.3
feature Firebase SDK now exports a module map, allowing it to be used from Swift without a bridging header.
changed Including the Firebase SDK no longer requires the -ObjC flag.
changed Improved performance for writes (setValue or updateChildValues), especially when writing locations deep under an observer.
changed Improved performance for initial connection to Firebase.
fixed Fixed a bug in offline disk persistence causing data to be stored at wrong location for certain edge cases.
Jun 24, 2015 - Version 2.3.2
fixed Fixed issue with disk persistence where data containing certain floating point values would end up being re-synced after app restart even if it had not changed.
Jun 1, 2015 - Version 2.3.1
fixed Fixed a regression in push ids (childByAutoId) introduced in 2.3.0 that caused them not to order correctly.
fixed Fixed a memory leak when using queries.
May 29, 2015 - Version 2.3.0
feature Offline disk persistence.
feature Presyncing data with keepSynced.
fixed Fixed a bug that could cause observers to temporarily have no data if observers exist at a higher location.
fixed Fixed a crash related to Unicode strings in queries.
Apr 28, 2015 - Version 2.2.2
changed Set NSURLIsExcludedFromBackupKey for Firebase persistence directory (required by Apple policies).
changed Added tracking for client version and offline persistence usage.
Apr 13, 2015 - Version 2.2.1
fixed Fixed internal assertion that was being hit with priorities on node removal.
fixed Fixed issue with degraded performance for large nodes and many writes.
fixed Network connection is closed properly on network connectivity loss.
fixed Calls to observeSingleEventOfType: now log a warning if they rely on a missing index.
Feb 13, 2015 - Version 2.2.0
feature Added [FQuery queryOrderedByValue] for ordering by value.
fixed Fixed an edge case where ChildAdded events could be delayed for local writes.
fixed A bug where an internal assertion was hit.
fixed Fixed a bug where events for server values were not raised after being acknowledged by the server.
fixed Fixed a bug where persisted writes could be restored out of order.
fixed Fixed a crash when using Firebase URLs without a scheme.
Jan 16, 2015 - Version 2.1.2
fixed Fixed segfault that occurred when using the Firebase SDK in combination with other C++ code or libraries.
Jan 12, 2015 - Version 2.1.1
fixed Fixed two bugs that caused an internal assertion to be hit in rare cases when using updateChildValues().
fixed Fixed issue where client would not connect to server when using limits larger than 2^31. The client now validates the limit range.
Jan 6, 2015 - Version 2.1.0
feature Added [Firebase changeEmailForUser:email password:password toNewEmail:newEmail ...] to enable updating a user's email.
changed Exposed created user ID via block passed to [Firebase createUser:password:withValueCompletionBlock].
fixed Improved performance for large queries with rapid updates.
fixed Fixed a bug where priorities were passed in on value events for queries.
fixed Fixed edge cases with temporarily inconsistent views.
Dec 4, 2014 - Version 2.0.3
feature Added exists() method to FDataSnapshot.
fixed Exposed FirebaseServerValue.timestamp() for using server values in Swift.
fixed Fixed a bug that prevented event updates in some situations after coming back online.
fixed Fixed a bug that prevented event updates in rare occasions where clients would overwrite data with near identical copies.
Nov 12, 2014 - Version 2.0.2
feature Added description to FMutableData.
feature Added ref to FQuery to retrieve Firebase reference.
feature Implemented transient memory usage performance improvements.
fixed Fixed bug with incomplete data that could occur with onDisconnect().
deprecated Deprecated parent in FMutableData.
Nov 4, 2014 - Version 2.0.1
fixed Fixed bug where removing observers caused crashes in some cases.
Nov 4, 2014 - Version 2.0.0
feature Added [FQuery queryOrderedByChild:key] for ordering by arbitrary child attributes.
feature Added [FQuery queryOrderedByKey:] and [FQuery queryOrderedByPriority:] to explicitly set sort order.
feature Added [FQuery queryEqualToValue:value] for exact-match filtering using arbitrary child attributes.
feature Added [FQuery queryLimitedToFirst:limit] or [FQuery queryLimitedToLast:limit] for explicitly set limit direction.
feature Improved performance of existing query functionality.
changed Changes in priority now raise an FEventTypeChildChanged event in addition to an FEventTypeChildMoved event.
changed Renamed to Firebase.key.
changed Renamed to FDataSnapshot.key.
changed Renamed to FMutableData.key.
changed Renamed [observeEventType:andPreviousSiblingNameWithBlock:*] to [observeEventType:andPreviousSiblingKeyWithBlock:*]
changed Renamed [observeSingleEventOfType:andPreviousSiblingNameWithBlock:*] to [observeSingleEventOfType:andPreviousSiblingKeyWithBlock:*]
deprecated Deprecated [FQuery queryStartingAtPriority:startPriority] in favor of [[FQuery queryOrderedByPriority] queryStartingAtValue:].
deprecated Deprecated [FQuery queryEndingAtPriority:endPriority] in favor of [[FQuery queryOrderedByPriority] queryEndingAtValue:].
deprecated Deprecated [FQuery queryEqualToPriority:priority] in favor of [[FQuery queryOrderedByPriority] queryEqualToValue:].
deprecated Deprecated [FQuery queryLimitedToNumberOfChildren:limit] in favor of [FQuery queryLimitedToFirst:limit] or [FQuery queryLimitedToLast:limit].
fixed kFirebaseServerValueTimestamp now works properly in transactions.
fixed Transaction callbacks now always return the snapshot from the specific transaction.
fixed Fixed transactions bug when running on cached data.
fixed Fixed some cases where ChildAdded events were raised with only partially-complete data.
Oct 23, 2014 - Version 1.2.3
fixed Add expires field to auth data, indicating session expiration time in seconds since Unix epoch.
Oct 7, 2014 - Version 1.2.2
fixed Another fix for crashing on authentication errors.
Oct 6, 2014 - Version 1.2.1
fixed Fix for crashing on authentication errors.
Oct 3, 2014 - Version 1.2.0
changed Firebase delegated authentication (previously Firebase Simple Login) is now integrated into the core Firebase library.
feature Added automatic session persistence for all authentication methods.
feature Added a synchronous accessor for authentication state: ref.authData.
feature Added a standardized authData returned for all authentication providers.
Aug 20, 2014 - Version 1.1.12
fixed Fixed the reference returned from snapshot.ref.
feature Made enums nice for Swift.
Jul 30, 2013 - Version 1.1.11
changed FirebaseHandles now start at 1.
changed Validation is now synchronous in user thread.
fixed Fixed bug for path contains.
changed Values with children with leading zeroes will no longer turn into arrays.
fixed Warnings print when you fail to read / write a value due to security rules.
fixed Security debug tokens now work.
Jul 18, 2013 - Version 1.1.10
fixed Fixed issue to make NaN errors more obvious.
fixed Fixed issue with leading zeroes.
feature Added equalTo query support.
feature Introduced several performance improvements.
fixed Invalid data types no longer corrupt the beta persistence (and throw more reasonable, but still asynchronous errors).
Jun 20, 2013 - Version 1.1.9
fixed Fixed bugs to improve iOS8 support.
May 22, 2013 - Version 1.1.8
fixed Fixed numerical/lexicographical key ordering issue.
fixed Avoid mutating transaction tree while iterating it.
Apr 15, 2013 - Version 1.1.7
fixed Fixed 64bit boolean issue in transactions.
fixed Fixed large integer keys issue for array inference.
Mar 15, 2013 - Version 1.1.6
fixed Fixed issue in PodSpec file.
Mar 7, 2013 - Version 1.1.5
fixed Fixed transaction bug.
Feb 28, 2013 - Version 1.1.4
fixed Eliminated warning regarding instance method override from transaction class.
Feb 4, 2013 - Version 1.1.3
feature Updated CocoaPods specfile to add support for both iOS and OSX.
Feb 4, 2013 - Version 1.1.2
feature Several performance improvements.
fixed Fixed bug which caused occasional crash.
fixed Fixed transaction bug.
Dec 4, 2013 - Version 1.1.1
fixed Fixed bugs for arm64 and OSX.
changed New required framework dependency: libc++.dylib.
Dec 3, 2013 - Version 1.1.0
feature Introduced experimental support for disk persistence (disabled by default).
changed Made some modifications to caching behavior.
Nov 9, 2013 - Version 1.0.9
feature Reduced memory usage for processing large data sets.
feature Added ability to manually kill the Firebase connection.
fixed Fixed bugs around state re-establishment.
fixed Fixed bugs around eventing and queries.
fixed Fixed bugs for iOS7 and arm64 support.
Nov 9, 2013 - Version 1.0.8
feature Implemented bandwidth optimization when syncing data.
Version 1.0.7
feature Improved performance when setting data.
changed Changed ordering used when raising events or enumerating snapshots so numeric keys are sorted numerically.
fixed Fixed bug where a limit() query could return stale data.
fixed Fixed bug in serverTimeOffset calculation.
Version 1.0.6
fixed Fixed bug where some objects were incorrectly reported as arrays.
fixed Fixed bug with some combinations of setValue() and limit() not correctly raising events.
fixed Fixed bug with update() incorrectly hiding some events.
Version 1.0.5
feature Added a Firebase* reference to completion blocks.
Version 1.0.4
feature .info/authenticated is now triggered before doing authentication callbacks.
fixed Fixed missing FServerValues on OS X.
Version 1.0.3
feature Added support for server timestamp value.
Version 1.0.2
feature Added OS X support.
feature Added support for .info/serverTimeOffset.
fixed Fixed Firebase URL case sensitivity.

Simple Login Client

Oct, 2014
deprecated Simple Login has been deprecated. Please use the login features that have been integrated into the main Firebase SDK library.
Sep 11, 2014 - Version 1.3.4
feature Anonymous users are now persisted across app restarts.
May 27, 2013 - Version 1.3.3
fixed Fixed a bug where changePasswordForEmail() failed to surface an error when invoked with an incorrect password.
Apr 19, 2013 - Version 1.3.2
feature Added support for isTemporaryPassword flag when logging in using the email / password provider (GitHub issue #17 -
fixed Gracefully handle missing Facebook iOS SDK during build.
Apr 4, 2013 - Version 1.3.1
feature Added support for latest Facebook iOS SDK (v3.13) and document changes (GitHub issue #2 -
Version 1.3.0
feature Added support for Google / Google+ authentication (GitHub issue #1 -
feature Added uid field on FAUser object.
Version 1.2.1
feature Added options argument to enable security debug mode.
Version 1.2.0
feature Added support for password resets (see
Version 1.1.2
fixed Fixed bugs to improve iOS7 and ARM64 support.
Version 1.1.0
feature Added support for anonymous authentication provider.
fixed Fixed error checking for FacebookAppId instead of FacebookAppID.
fixed Translated OS-level ACFacebookAudience to appropriate FBSession constant if Facebook SDK is present.