A newer version of this documentation is available.

Installation - Couchbase Lite on Objective-C

March 23, 2025

+ 12

Description — Installing Couchbase Lite on Objective-C

Get Started

Create or open an existing Xcode project and install Couchbase Lite 3.0.15 using one of the Install Methods methods shown.

Couchbase Lite is distributed as an xcframework, to support this:

Get the binary download here — Extend with Mobile.
Unpack the download
Within Finder, Drag CouchbaseLite.xcframework to the Xcode navigator.
Click on Project General Embedded Binary and add CouchbaseLite.xcframework to this section.
Import the xcframework and start using it in your project.
```
objc
Copy
#include <CouchbaseLite/CouchbaseLite.h>
...
```

The minimum required version of Carthage is 38.0

In your Cartfile, add the following.

Couchbase Lite Community Edition

ruby
Copy
binary "https://packages.couchbase.com/releases/couchbase-lite-ios/carthage/CouchbaseLite-Community.json" ~> 3.0.15

Couchbase Lite Enterprise Edition

ruby
Copy
binary "https://packages.couchbase.com/releases/couchbase-lite-ios/carthage/CouchbaseLite-Enterprise.json" ~> 3.0.15

Run carthage update --platform ios.
Drag CouchbaseLite.xcframework from Carthage/Build/ to the Xcode navigator.
Click on Project > General > Embedded Binary and add CouchbaseLite.xcframework to this section.

The minimum required version of Cocoapods is 1.9

In your Podfile, add the following.

Couchbase Lite Community Edition

ruby
Copy
target '<your target name>' do
  use_frameworks!
  pod 'CouchbaseLite', '3.0.15'
end

Couchbase Lite Enterprise Edition

ruby
Copy
target '<your target name>' do
  use_frameworks!
  pod 'CouchbaseLite-Enterprise', '3.0.15'
end

How to . . .

Learn more . . .

Dive Deeper . . .