The Revision API is not longer available. The Couchbase Lite 2.0 conflict resolver API lets users pick which revision is the winner when a conflict occurs. There is a default conflict resolver if none are provided.

The 1.x Attachment API has been renamed to Blob but the functionality remains the same.

The 1.x Database.inTransaction method has been renamed to Database.inBatch to emphasize that Couchbase Lite does not offer transactional guarantees, and that the purpose of the method is to optimize batch operations rather than to enable ACID transactions.

Known Issues

Database Encryption is not available in Couchbase Lite 2.0 but may be re-introduced in a later version of Couchbase Lite 2.x.

The OpenID Connect authenticator API has been removed but may be re-introduced in a later version of Couchbase Lite 2.x.

The Listener component has been removed in Couchbase Lite 2.0. As a result, hybrid development frameworks such as Cordova and peer-to-peer replications are not supported in Couchbase Lite 2.0. Support for those features may be re-introduced in a later version of Couchbase Lite 2.x.

Compatibility Matrix

The table below summarizes the compatible versions of Couchbase Lite, Sync Gateway and Couchbase Server to use in production. Preview and beta versions should only be used for development and testing.

EE features

Incremental API Changes

Beta 2 (Developer build 23)

The Document save API has changed based on user feedback. There are now two variants, one which will force the write to become current (default) and one which will return false and abort the save if there is a conflict.

Database encryption has been removed.

.NET Standard 1.4 -> .NET Standard 2.0

A mountain of bug fixes regarding replication. .NET now passes through a wide scenario of 50+ functional scenarios.

Library is now split into two editions: Community Edition and Enterprise Edition. Each has its own respective license and you are required to accept the Enterprise Edition license to use (short summary: You can use it all you like in development, but need to pay for production use).

Xamarin platforms have been removed from GA for enterprise edition due to the unavailable bandwidth for testing, as well as .NET Core for Mac and Linux. They are still present in Beta 2 though.

Beta 1 (Developer build 22)

The new replication protocol is enabled by default in Sync Gateway 2.0.

The target URI scheme has changed from blip:// (blips://) to ws:// (wss://) respectively.

More API changes to conform to internal spec (in other words, to have as close to the same signatures as Java and Swift as possible). The final review has been completed and there are no more anticipated changes. See Issue 941 for a list of most of the changes

API Updates:

Expression type safe API; new literal value based expression.

Removed CBLFullTextIndexOptions and moved all of CBLFullTextIndexOptions's properties into CBLFullTextIndex.