Repository files navigation

Couchbase Lite is an embedded lightweight, document-oriented (NoSQL), syncable database engine.

Couchbase Lite 2.0+ has a completely new set of APIs. The implementation is on top ofCouchbase Lite Core, which is also a new cross-platform implementation of database CRUD and query features, as well as document versioning.

This repo contains the code for the community editions of the Java-language family of productsfor Couchbase Lite 2.0+. This includes Java language products for the JVM, and Java and Kotlin language products for AndroidCouchbase Lite 2.0+ is a completely new product, utterly divergent from the 1.0 version

Please file any issues for either Java or Kotlin language products, here. Be sure to specify which product and version you are using!

See: Developer GuideAndroid,JVM

See:

• Learn Couchabase forAndroid
• TodoAndroid,Java Desktop,Java Web Service

This project is a git repository with submodules. To check it out, clone this root repository:

git clone https://github.com/couchbase/couchbase-lite-java-ce-root --recurse-submodules

or

git clone https://github.com/couchbase/couchbase-lite-java-ce-rootgit submodule update --init --recursive

There are two important top level directories:

• ce - This contains directories for product-specific code for each of the products, JVM and Java or Kotlin for Android
• common - This contains code that is used by the entire Java language product family

To build this product you will, first, have to clonehttps://github.com/couchbase/couchbase-lite-core and builda LiteCore library appropriate for your application. There are instructions in that repository that willguide you through doing that.

Next you will have to install the LiteCore library in the directory /common/lite-core.You can use the shell script etc/install_lite_core.sh to do that

To build a product, navigate to the product home directory (ce/android, ce/android-ktx or ce/java) and follow the detailed insturctions there.Note that building the Kotlin extensions depend on a CouchbaseLite Android library: Use the gradle task publishToMavenLocal tocreate a library that the Kotlin build can use.

The top level gradle build will build both products if everything is correctly configured. At the very least, you will need:

• the appropriate LiteCore installed in./common/lite-core/<os>/<abi>/{lib,include}
• local.properties files in both this the product directories

If you minify (Proguard) an application that uses CouchbaseLite you will need to add a few rules to yourProguard configuration. The rules are listedhere

Apache 2license.