Supported Operating System Versions

    Description — Couchbase Lite on Android — the OS and SDK versions on which this framework is supported
    Related Content — What’s New | Release Notes | Compatibility

    Officially Supported Versions

    The requirements listed below are for the Java/Kotlin SDK on Android.

    If you’re developing with the C/C++ SDK on Android, the minimum API Level is 24. For C/C++ SDK requirements, see Couchbase Lite for C - Android Requirements.

    The operating systems listed in Table 1 are certified Android versions. Couchbase does not test against, nor guarantee support for, uncertified Android versions such as versions built from source.

    Table 1. Supported versions
    Platform Runtime architectures Minimum API Level

    Android

    armeabi-v7a

    24

    Android

    arm64-v8a

    24

    Android

    x86

    24

    Android

    x86_64

    24

    Bluetooth Transport Requirements

    Bluetooth Low Energy (BLE) transport for the Multipeer Replicator requires Android API 29 (Android 10) or later, due to the availability of BLE L2CAP support on that API level.

    Devices running API 24—​28 can still use Couchbase Lite with all non-Bluetooth features, including Wi-Fi-based Multipeer replication. If your application targets API 24—​28, do not include .bluetooth in your MultipeerReplicatorConfiguration.transports set.

    Feature Requirements

    Some features require a greater minimum API level than the general CBL requirement.

    Table 2. Multipeer Replicator API level requirements
    Feature Minimum Android API Notes

    Multipeer Replicator: Wi-Fi transport

    API 24

    Peers must connect to the same Wi-Fi network.

    Multipeer Replicator: Bluetooth Low Energy transport

    API 29

    Requires additional manifest permissions and runtime permission requests. See Bluetooth Platform Configuration.