TouchDB (CouchDB互換の組込用NoSQL) をiOS開発で使ってみる

TouchDBとは

概要

公式サイトを見ると次のように解説されています。

TouchDB is a lightweight Apache CouchDB-compatible database engine suitable for embedding into mobile or desktop apps. Think of it this way: If CouchDB is MySQL, then TouchDB is SQLite.

訳： TouchDBはlightweightなApach CouchDB互換のDBエンジンで、モバイルやデスクトップアプリへの組み込みに適しています。CouchDBをMySQLとするとTouchDBはSQLiteに相当します。

特徴

モバイル向けのCouchDB互換のNoSQL
CouchBaseのメンバーが開発
iOS用(Objective-C実装)とAndroid用(Java実装)がある。
RestAPIがほとんど一緒(ユーザ管理機能等はなし)
CouchDBでレプリケートできる(例えばモバイルのTouchDBとサーバのCouchDBを同期できる)
コードが350KB(ARM7の場合)と軽量
(デスクトップより)相対的に遅いモバイルCPUでも高速に起動する
省メモリ

詳細は公式:couchbaselabs / TouchDB-iOSを参照してください。

CouchCocoa

CouchCocoa.frameworkのビルド

ローカルリポジトリを作成します。

 git clone https://github.com/couchbaselabs/CouchCocoa
 cd CouchCocoa
 git submodule init
 git submodule update

Xcodeでプロジェクト開いてビルドします。
1. XCodeでプロジェクトを開く
```
 open CouchCocoa.xcodeproj
```
2. 左上のScheme設定を"iOS Framework"に設定
3. メニューでProduct > Build
ビルド結果を確認します。
1. XCode > Preferences > Locations を開く
2. Derived Dataの下のリンクをクリック
3. CouchCocoa-xxxxxx > Build > Products > Release-ios-universalを開いてCouchCocoa.frameworkができていることを確認

TouchDB

TouchDB.frameworkのビルド

ローカルリポジトリを作成します。

 git clone git://github.com/couchbaselabs/TouchDB-iOS.git
 cd TouchDB-iOS
 git submodule init
 git submodule update

Xcodeを開いてビルドします。
1. プロジェクトをXCodeで開く
```
 open TouchDB.xcodeproj
```
2. 左上のScheme設定を"iOS Framework"に設定
3. メニューで`Product > Build
ビルド結果を確認します。
1. XCode > Preferences > Locations を開く
2. Derived Dataの下のリンクをクリック
3. TouchDB-xxxxxx > Build > Products > Release-ios-universalを開いてTouchDB.frameworkができていることを確認

iOSプロジェクトへのTouchDB, CouchCocoaインポート

Xcodeのプロジェクトを開く
先ほどビルドしたCouchCocoa.frameworkをソースツリーのframeworksにドラッグ&ドロップ
先ほどビルドしたTouchDB.frameworkをソースツリーのframeworksにドラッグ&ドロップ
Destinationの"Copy items into~"にチェック
BuildSettingのOther Linkerに-ObjCを追加
BuiodPhaseLink Binary with Libraliesに以下を追加
- CFNetwork.framework
- Security.framework
- SystemConfiguration.framework
- libsqlite3.dylib
- libz.dylib
アプリからTouchDBを利用

didFinishLaunchingWithOptionsなどでDBを起動

例：

       CouchTouchDBServer* server = [CouchTouchDBServer sharedInstance];
        self.database = [server databaseNamed: @"testdb"];
        NSError* error;
        if (![self.database ensureCreated: &error]) {
            NSLog(@"CouchDBが起動しました!");
        }

詳細な使い方はまた書くかもしれませんが、公式サイトを参照してください。