iOS

The iOS Couchbase Mobile SDK is based on the same Erlang codebase as Syncpoint server. It adds about 3MB to the download size.

*The latest download*: [iOS Couchbase 2.0.1|http://files.couchbase.com/developer-previews/mobile/ios/nightlybuild/ios-couchbase-2.0.1-3.zip]

The download includes: Couchbase Mobile 2.0.1 (An Xcode Framework ready for embedding in your iOS applications), API Documentation, and CouchCocoa, our native client library.

[CouchCocoa docs|http://couchbaselabs.github.com/CouchCocoa/docs/]

Here is an [introductory screencast to coding with Couchbase on iOS|http://vimeo.com/29754387]

[Jens iOS session from CouchConf SF|http://vimeo.com/32300070]

[Repo manifest if you want to become a contributor.|https://github.com/couchbaselabs/iOS-Couchbase-manifest] See also [Contributing to Couchbase].

h3. Getting Started

{color:#5b5352}These instructions assume you have created a "Frameworks" folder in the root of your Xcode project, and have copied the downloaded Couchbase.framework there. Folks building multiple iOS apps may prefer to store the framework in a shared location. If you didn't put it in the Frameworks subfolder of your project, you'll want to edit the rsync line below in step 5.{color}
{color:#5b5352} {color}
{color:#5b5352}Wherever you put the downloaded Couchbase.framework, here's how to add it to a project:{color}
{color:#5b5352} {color}
# {color:#5b5352}Open your Xcode project.{color}
# {color:#5b5352}Drag the Couchbase.framework into the “Frameworks” section of the file list in your project window. In the sheet that opens, make sure there's a checkbox next to your app's target.{color}
# {color:#5b5352}You will need to link some libraries with your project: Go to the target's Build Phases, open "Link Binary With Libraries", click the "+" button, and add "libstdc++.dylib", "Security.framework" and "libz.dylib" from the iOS section.{color}
# {color:#5b5352}Go to the target's Build Phases and add a new Run Script phase.{color}
# {color:#5b5352}Paste the following into the script content of the new phase. (IMPORTANT: This assumes you put the framework in a "Frameworks" subfolder. If you put it elsewhere, update the path in the 2nd argument to ‘rsync’ accordingly.){color}

{color:#5b5352}{_}Important: The `rsync` command below is a single long line. Do not put a newline in the middle\!_{color}
{color:#222222}    # The 'CouchbaseResources' subfolder of the framework contains {color}

{color:#5b5352}In your MyAppDelegate.h file, add the declaration that you implement the Couchbase protocol, by importing the header file and adding "CouchbaseDelegate" inside the brackets:{color}
{color:#6e371a}\#import <Couchbase/CouchbaseMobile.h>{color}

{color:#a61390}@interface{color}{color:#222222}&nbsp;MyAppDelegate&nbsp;{color}{color:#002200}:{color}{color:#222222}&nbsp;UIResponder <UIApplicationDelegate, CouchbaseDelegate>{color}
{color:#5b5352}In MyAppDelegate.m, in add this code to your didFinishLaunchingWithOptions callback:{color}
{color:#222222}CouchbaseMobile{color}{color:#002200}\*{color}{color:#222222}&nbsp;cb&nbsp;{color}{color:#002200}={color}{color:#222222}&nbsp;{color}{color:#002200}\[{color}{color:#002200}\[{color}{color:#222222}CouchbaseMobile alloc{color}{color:#002200}\]{color}{color:#222222}&nbsp;init{color}{color:#002200}\]{color}{color:#222222};{color}
{color:#222222}cb.delegate&nbsp;{color}{color:#002200}={color}{color:#222222}&nbsp;self;{color}
{color:#002200}\[{color}{color:#222222}cb start{color}{color:#002200}\];{color}
{color:#222222}NSAssert{color}{color:#002200}(\!cb.error{color}{color:#222222},&nbsp;{color}{color:#bf1d1a}@{color}{color:#bf1d1a}"Error launching Couchbase: %@"{color}{color:#222222}, cb.error{color}{color:#002200}){color}{color:#222222};{color}
{color:#5b5352}Now all you need is a callback for when Couchbase is ready (and one in case of error):{color}
{color:#002200}\-{color}{color:#002200}({color}{color:#a61390}void{color}{color:#002200}){color}{color:#222222}couchbaseMobile{color}{color:#002200}:{color}{color:#002200}({color}{color:#222222}CouchbaseMobile{color}{color:#002200}\*{color}{color:#002200}){color}{color:#222222}couchbase didStart{color}{color:#002200}:{color}{color:#002200}({color}[NSURL|http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSURL_Class/]{color:#002200}\*{color}{color:#002200}){color}{color:#222222}serverURL&nbsp;{color}{color:#002200}{{color}
{color:#222222}&nbsp; &nbsp; NSLog{color}{color:#002200}({color}{color:#bf1d1a}@{color}{color:#bf1d1a}"Couchbase is Ready, go\! %@"{color}{color:#222222}, serverURL{color}{color:#002200}){color}{color:#222222};{color}
{color:#002200}}{color}

{color:#002200}\-{color}{color:#002200}({color}{color:#a61390}void{color}{color:#002200}){color}{color:#222222}couchbaseMobile{color}{color:#002200}:{color}{color:#002200}({color}{color:#222222}CouchbaseMobile{color}{color:#002200}\*{color}{color:#002200}){color}{color:#222222}couchbase failedToStart{color}{color:#002200}:{color}{color:#002200}({color}[NSError|http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSError_Class/]{color:#002200}\*{color}{color:#002200}){color}{color:#222222}error&nbsp;{color}{color:#002200}{{color}
{color:#222222}&nbsp; &nbsp; NSAssert{color}{color:#002200}({color}{color:#a61390}NO{color}{color:#222222},&nbsp;{color}{color:#bf1d1a}@{color}{color:#bf1d1a}"Couchbase failed to initialize: %@"{color}{color:#222222}, error{color}{color:#002200}){color}{color:#222222};{color}
{color:#002200}}{color}
{color:#5b5352}When Couchbase Mobile launches it will call your code with its local serverURL. At that point it is up to you how to interact with it. &nbsp;Most of our example apps use&nbsp;{color}[CouchCocoa|https://github.com/couchbaselabs/CouchCocoa]{color:#5b5352}&nbsp;to interact with Couchbase, but there are plenty of options for how to use Couchbase, with people using everything from raw REST connections, to Core Data interfaces, to WebView interfaces. Couchbase can fit any iOS application.{color}