Building Couchbase Lite

Building The Framework

Checking Out The Code

1. Use Git to clone the Couchbase Lite repository to your local disk. For example: git clone git://github.com/couchbase/couchbase-lite-ios.git
2. cd couchbase-lite-ios
3. If you want to build a nonstandard branch, enter git checkout followed by the branch name.
4. git submodule update --init --recursive. This will clone some external Git repositories into the vendor/ subdirectory.

In the future, you can update to the latest sources by running "git pull" in the Couchbase Lite directory, then git submodule update --recursive.

Building

3. Open CouchbaseLite.xcodeproj.
4. Select the "Continuous iOS", "CBL Mac", or "CBL tvOS" (AppleTV) scheme, depending on which platform you want to build.
5. The next step depends on whether you want an optimized or a debug build:
   • For an optimized build:
     1. Choose "Archive" from the "Product" menu.
     2. Open the Organizer window's Archives tab to find the archive.
     3. Right-click the archive and choose "Show In Finder".
     4. Right-click the archive icon in the Finder and choose "Show Package Contents".
     5. The framework will be inside the "Products" subfolder.
   • For a debug build:
     1. Choose "Build" from the "Product" menu.
     2. Finding the framework can be tricky as it's buried deep in the build directory, whose location varies depending on your Xcode preferences. Look at the build log in the log navigator pane and the last line of output should include its path.

Linking Couchbase Lite Into Your Own App

1. Drag CouchbaseLite.framework into the file list of your app's project window.
2. An alternate trick, if you want to always use the latest self-built version of CouchbaseLite.framework, is to symbolic-link (symlink) it. 1. Either, into your project folder directly:
   $ cd ~/dev/myProject/
$ ln -s ~/dev/couchbase-lite-ios/DerivedData/CouchbaseLite/Build/Products/Debug-ios-universal/CouchbaseLite.framework CouchbaseLite.framework 2. Or, into your project's Framework folder if it has a real mapping to the Frameworks group inside Xcode:
   $ cd ~/dev/myProject/Frameworks
$ ln -s ~/dev/couchbase-lite-ios/DerivedData/CouchbaseLite/Build/Products/Debug-ios-universal/CouchbaseLite.framework CouchbaseLite.framework 3. Then do the drag & drop of the CouchbaseLite.framework symlink from the Finder window into your Xcode project window's Framework group and follow rest of the instructions below as usual. The Copy items into destination group's folder (if needed) and Create groups for any added folders can/should stay selected and it will work properly. NO it will NOT follow the reference of the symlink to make a copy ... that won't happen, so relax.
3. In the window that appears, make sure the checkbox next to your app's target is checked.
4. For an iOS or tvOS target:
5. Go to the "Build Settings" tab of your app target's settings.
6. Find the "Other Linker Flags" row in the "Linker" section, and add the flag -ObjC. (Note the capitalization.)
7. Go to the "Build Phases" tab of the app target's settings.
8. In the "Link Binary with Libraries" section, click the plus button and add CFNetwork.framework, Security.framework, SystemConfiguration.framework, libsqlite3.dylib and libz.dylib.
9. For a Mac OS target, you'll need to make sure the framework is copied into your app's bundle:
10. To to the "Build Settings" tab of your app target's settings.
11. In the "Linker" section, edit "Runpath Search Paths" and add the path "@loader_path/../Frameworks".
12. Now switch to to the "Build Phases" tab.
13. Press the "Add Build Phase" button at the bottom of the window and create a new "Copy Files" phase.
14. Set the phase's destination to "Frameworks".
15. Press the "+" button below the phases' file list and select CouchbaseLite.framework to add it.

Next: Using Couchbase Lite