Skip to content

couchbase/couchbase-lite-ios

Repository files navigation

Couchbase Lite for iOS and MacOS

License

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

Couchbase Lite implementation is on top of Couchbase Lite Core, which is also a new cross-platform implementation of database CRUD and query features, as well as document versioning.

Requirements

  • Xcode 26.4+
  • iOS 15.0+
  • macOS 13.0+

Installation

Swift Package

Community Edition

dependencies: [
        .package(name: "CouchbaseLiteSwift",
                 url: "https://github.com/couchbase/couchbase-lite-swift.git", 
                 from: "4.0.0"),
    ],

Enterprise Edition

dependencies: [
        .package(name: "CouchbaseLiteSwift",
                 url: "https://github.com/couchbase/couchbase-lite-swift-ee.git", 
                 from: "4.0.0"),
    ],

More detailed information on how to setup is available here: swift package manager

CocoaPods

Swift Package Manager is the recommended installation method for new projects. CocoaPods remains supported; add the pod that matches the API and edition you want to your Podfile:

API Community Edition Enterprise Edition
Objective-C CouchbaseLite CouchbaseLite-Enterprise
Swift CouchbaseLite-Swift CouchbaseLite-Swift-Enterprise
target '<your target name>' do
  use_frameworks!
  pod 'CouchbaseLite-Swift'
end

How to build the framework files

  1. Clone the repo and update submodules
$ git clone https://github.com/couchbase/couchbase-lite-ios.git
$ cd couchbase-lite-ios
$ git submodule update --init --recursive
  1. Run ./Scripts/build_xcframework.sh to build an XCFramework for either Swift or Objective-C API.
# For building the Swift XCFramework
$ ./Scripts/build_xcframework.sh -s CBL_Swift -o output

# For building the ObjC XCFramework
$ ./Scripts/build_xcframework.sh -s CBL_ObjC -o output

Documentation

License

Like all Couchbase source code, this is released under the Apache 2 license.

About

Lightweight, embedded, syncable NoSQL database engine for iOS and MacOS apps.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors