Please use the form below to provide your feedback. Because your feedback is valuable to us, the information you submit in this form is recorded in our issue tracking system (JIRA), which is publicly available. You can track the status of your feedback using the ticket number displayed in the dialog once you submit the form.

You are viewing the documentation for a prerelease version.

View Latest

Installing Couchbase Lite on Android

    • Beta
      +

      Description — How to install Couchbase Lite on Android
      Abstract — Getting you up and running quickly with Couchbase Lite on android

      Introduction

      Couchbase Lite on Android supports the development of applications in Java or Kotlin.

      You can install Couchbase Lite Community and-or Enterprise editions from the Maven repository. There are separate downloads for Kotlin and Java.

      Enterprise users can also download the Couchbase Lite Vector Search extension library. Installation instructions are included in the step-by-step install guides for both Java and Kotlin.

      Couchbase Lite Quick Steps

      For experienced developers, this is all you need to add _Couchbase Lite for Android 3.2.0-beta.1 to your application projects.

      Kotlin - Enterprise

      1. Create a Kotlin Android app project in Android Studio

      2. Add Couchbase Lite as a dependency in your app-level build.gradle
        implementation 'com.couchbase.lite:couchbase-lite-android-ee-ktx:3.2.0-beta.1'

      3. Add the following maven repo to your repositories (in build.gradle or settings.gradle as required
        https://mobile.maven.couchbase.com/maven2/dev/

      4. Build the project and it will pull Couchbase Lite down.

      Kotlin - Community

      1. Create a Kotlin Android app project in Android Studio

      2. Add Couchbase Lite as a dependency in your app-level build.gradle
        implementation 'com.couchbase.lite:couchbase-lite-android-ktx:3.2.0-beta.1'

      3. Check you have mavenCentral() in repositories (or in settings.gradle)

      4. Build the project and it will pull Couchbase Lite down.

      Java - Enterprise

      1. Create a Java Android app project in Android Studio

      2. Add Couchbase Lite as a dependency in your app-level build.gradle
        implementation 'com.couchbase.lite:couchbase-lite-android-ee:3.2.0-beta.1'

      3. Add the following maven repo to your repositories (in build.gradle or settings.gradle as required
        https://mobile.maven.couchbase.com/maven2/dev/

      4. Build the project and it will pull Couchbase Lite down.

      Java - Community

      1. Create a Java Android app project in Android Studio

      2. Add Couchbase Lite as a dependency in your app-level build.gradle
        implementation 'com.couchbase.lite:couchbase-lite-android:3.2.0-beta.1'

      3. Check you have mavenCentral() in repositories (or in settings.gradle)

      4. Build the project and it will pull Couchbase Lite down.

      That’s it! You''re all set to begin developing powerful Couchbase Lite applications.

      Now, try the Getting Started application, which demonstrates use of key CRUD functionality.

      Kotlin - Step-by-Step Install

      More detailed instructions on getting up and running with Couchbase Lite for Android (Kotlin).

      The Kotlin download also includes the Java version of Couchbase Lite for Android, along with the other dependencies.

      Create or open an existing Android Studio project and include the following entries in the app-level build.gradle file (typically in the app folder).

      The Vector Search extension is an Enterprise only feature.

      • Enterprise Edition

      • Vector Search Beta-1 Extension

      • Community Edition

      1. Include the following in the android {} section:

        android {
// Required only if your project has some Kotlin source code
  kotlinOptions { jvmTarget = 1.8}

  compileOptions {
      targetCompatibility 1.8
      sourceCompatibility 1.8
  }

//   ... other section content as required by user
}

      2. Include the following in the repositories {} section:

        repositories {
  maven { url 'https://mobile.maven.couchbase.com/maven2/dev/' }

//   ... other section content as required by user
}

      3. Include the following in the dependencies{} section:

        dependencies {

  implementation 'com.couchbase.lite:couchbase-lite-android-ee-ktx:3.2.0-beta.1'

//   ... other section content as required by user
}

      Vector Search is only available for 64-bit architectures. You must have Couchbase Lite installed before you can use the Vector Search Extension.

      1. Include the following in the android {} section:

        android {
// Required only if your project has some Kotlin source code
  kotlinOptions { jvmTarget = 1.8}

  compileOptions {
      targetCompatibility 1.8
      sourceCompatibility 1.8
  }

  buildTypes {
    debug {
        packagingOptions.jniLibs.useLegacyPackaging = true
    }
    release {
        packagingOptions.jniLibs.useLegacyPackaging = true
    }
  }

//   ... other section content as required by user
}

      2. Include the following in the repositories {} section:

        repositories {
  maven { url 'https://mobile.maven.couchbase.com/maven2/dev/' }
  google()
  mavenCentral()
//   ... other section content as required by user
}

      3. Include the following in the dependencies{} section:

        dependencies {

  implementation 'com.couchbase.lite:couchbase-lite-android-ee-ktx:3.2.0-beta.1'

  // All standard 64-bit ARM architectures
  implementation 'com.couchbase.lite:couchbase-lite-android-vector-search-arm64-1.0.0-beta.1'

//   ... other section content as required by user
}

        1. For running on x86_64 architectures, include the following in the dependencies{} section instead:

          dependencies {

  implementation 'com.couchbase.lite:couchbase-lite-android-ee-ktx:3.2.0-beta.1'

  implementation 'com.couchbase.lite:couchbase-lite-android-vector-search-x86_64-1.0.0-beta.1'

//   ... other section content as required by user
}

      1. Set the Java Version, include the following in the android {} section:

        android {
  compileOptions {
      sourceCompatibility JavaVersion.VERSION_1_8
      targetCompatibility JavaVersion.VERSION_1_8
  }
//   ... other section content as required by user
}

      2. Ensure your repositories section includes mavencentral()

        repositories {

  mavenCentral()

  //   ... other section content as required by user
}

      3. Add Couchbase Lite to the dependencies{} section:

        dependencies {

  implementation "com.couchbase.lite:couchbase-lite-android-ktx:3.2.0-beta.1"

//   ... other section content as required by user
}

      Java - Step-by-step Install

      More detailed instructions on getting up and running with Couchbase Lite for Android (Java).

      Create or open an existing Android Studio project and install Couchbase Lite using the following method.

      Include the following entries to the app-level build.gradle file (typically in the app folder).

      The Vector Search extension is an Enterprise only feature.

      • Enterprise

      • Vector Search Beta-1 Extension

      • Community

      1. Set the Java Version, include the following in the android {} section:

        android {
// Required only if your project has some Kotlin source code
  kotlinOptions { jvmTarget = 1.8}

  compileOptions {
      targetCompatibility 1.8
      sourceCompatibility 1.8
  }

//   ... other section content as required by user
}

      2. Add the following in the repositories {} section:

        repositories {
  maven { url 'https://mobile.maven.couchbase.com/maven2/dev/' }

//   ... other section content as required by user
}

      3. Add Couchbase Lite to your dependencies{} section:

        dependencies {

  implementation 'com.couchbase.lite:couchbase-lite-android-ee:3.2.0-beta.1'

//   ... other section content as required by user
}

      Vector Search is only available for 64-bit architectures. You must have Couchbase Lite installed before you can use the Vector Search Extension.

      1. Include the following in the android {} section:

        android {
// Required only if your project has some Kotlin source code
  kotlinOptions { jvmTarget = 1.8}

  compileOptions {
      targetCompatibility 1.8
      sourceCompatibility 1.8
  }

  buildTypes {
    debug {
        packagingOptions.jniLibs.useLegacyPackaging = true
    }
    release {
        packagingOptions.jniLibs.useLegacyPackaging = true
    }
  }

//   ... other section content as required by user
}

      2. Include the following in the repositories {} section:

        repositories {
  maven { url 'https://mobile.maven.couchbase.com/maven2/dev/' }
  google()
  mavenCentral()
//   ... other section content as required by user
}

      3. Include the following in the dependencies{} section:

        dependencies {

  implementation 'com.couchbase.lite:couchbase-lite-android-ee-ktx:3.2.0-beta.1'

  // All standard 64-bit ARM architectures
  implementation 'com.couchbase.lite:couchbase-lite-android-vector-search-arm64-1.0.0-beta.1'

//   ... other section content as required by user
}

        1. For running on x86_64 architectures, include the following in the dependencies{} section instead:

          dependencies {

  implementation 'com.couchbase.lite:couchbase-lite-android-ee-ktx:3.2.0-beta.1'

  implementation 'com.couchbase.lite:couchbase-lite-android-vector-search-x86_64-1.0.0-1.0.0-beta.1'

//   ... other section content as required by user
}

      1. Include the following in the android {} section:

        android {
// Required only if your project has some Kotlin source code
  kotlinOptions { jvmTarget = 1.8 }

  compileOptions {
      targetCompatibility 1.8
      sourceCompatibility 1.8
  }

//   ... other section content as required by user
}

      2. Ensure your repositories section includes mavencentral()

        repositories {

  mavenCentral()

  //   ... other section content as required by user
}

      3. Include the following in the dependencies{} section:

        dependencies {
  implementation 'com.couchbase.lite:couchbase-lite-android:3.2.0-beta.1'
//   ... other section content as required by user
}

      Related Content

      How to . . .
      Learn more . . .
      Dive Deeper . . .

      Mobile Forum | Blog | Tutorials