CouchCocoa 1.1.0

CouchCocoa 1.1.0

×

测试已测试✗
语种语言 Obj-CObjective C
许可证 自定义
发布最后发布2014年5月

由 未声明的 维护。

CouchCocoa 1.1.0

  • 由
  • Jens Alfke

CouchCocoa：TouchDB 和 Apache CouchDB™ 的 Objective-C API

CouchCocoa 是用于在 iOS 和 Mac OS 上操作 TouchDB 和 CouchDB 的中级 Objective-C API。我们所说的“中级”是指：

  • 它不需要了解 HTTP API 的知识，只需了解 CouchDB 的架构。您不需要记住特别的路径或 URL 查询参数。
  • 但是，它不像 CoreData 那样完全抽象出操作数据库的事实。您仍然使用 CouchDB 风格的文档和查询，尽管存在一个 CouchModel 类，它可以帮助映射文档和本地对象之间的一些脏活。

此 API 不是访问 CouchDB 或 TouchDB 唯一的方法——如果您愿意，可以直接使用 NSURLConnection 与 HTTP API 交谈。

试试看！

加入我们

构建说明

先决条件

Xcode 4.3 或更高版本，以及 iOS 4.3 或更高版本的 SDK。

一次性仓库设置

如果您已克隆 CouchCocoa Git 仓库，而不是下载预编译的框架，那么接下来您需要初始化 Git “子模块”。这会将依赖项 JSONKit 克隆到“vendor”子文件夹中

cd CouchCocoa
git submodule init
git submodule update

运行 iOS 示例应用

我们的 iOS 示例程序“Grocery Sync”有它自己的 GitHub 仓库：iOS-Couchbase-Demo。查看它并查阅其 README 文件以获取说明。

运行 Mac OS 示例应用

在Demo/子文件夹中包含了两个简单的Mac演示应用程序。一个允许您编辑一个简单的名单和电子邮件地址列表，另一个是购物清单。（实际上，它们共享大部分相同的源代码；所有的不同之处都在它们的模型类和.xib文件中，多亏了Cocoa绑定的魔力。）要运行它们

  1. 在本地宿主机上启动CouchDB服务器。（您可以使用包管理器如HomeBrew来安装CouchDB。）
  2. 打开CouchCocoa.xcodeproj（在Xcode 4.2或更高版本）
  3. 在工具栏的方案弹出菜单中选择“Demo-Addresses”或“Demo-Shopping”
  4. 按运行按钮

构建框架

（您只有当您签出CouchCocoa源代码并且想要自己构建它时才需要这样做。如果您下载了预编译的框架，请跳到下一节。）

  1. 打开CouchCocoa.xcodeproj
  2. 在工具栏的方案弹出菜单中选择“Mac框架”或“iOS框架”
  3. 产品 > 构建

如果您想运行单元测试，首先确保在本地宿主机上正在运行CouchDB服务器，然后选择产品 > 测试。

框架将位于

  • Mac: build/CouchCocoa/Build/Products/Debug/CouchCocoa.framework
  • iOS: build/CouchCocoa/Build/Products/Debug-universal/CouchCocoa.framework

（build的确切位置将取决于您的Xcode首选项。它可能是项目文件夹的子目录，或者它可能位于Xcode "DerivedData"文件夹中。找到框架的一种方法是在项目导航器中打开Products组，在合适的CouchCocoa.framework上右击，然后选择"在Finder中显示"。）

在您的应用程序中使用框架

Mac OS

  1. 构建Mac框架（见上）。
  2. 将CouchCocoa.framework复制到某个地方，either into your project's folder or into a location shared between all your projects。
  3. 打开您的Xcode项目。
  4. 将复制的框架拖到项目窗口的文件列表中。
  5. 将框架添加到您的目标（如果在前一个步骤中没有提示您）。
  6. 编辑您的目标和添加一个新的复制文件构建阶段。
  7. 设置构建阶段的 destinations to Frameworks，并将CouchCocoa.framework从主项目文件列表拖到其中。

iOS

  1. 构建iOS框架（见上）。
  2. 将CouchCocoa.framework复制到某个地方，either into your project's folder or into a location shared between all your projects。
  3. 打开您的Xcode项目。
  4. 将复制的框架拖到项目窗口的文件列表中。
  5. 将框架添加到您的目标（如果在前一个步骤中没有提示您）。

您可能在iOS设备上运行本地数据库服务器，因为这将允许您的应用程序离线工作（并提高性能。）CouchCocoa.framework不包含CouchDB本身，因此您还应将Couchbase Mobile框架添加到您的应用程序中。使用这两个框架非常简单：当CouchbaseMobile对象调用您的委托方法以告知服务器已启动时，只需使用它给出的URL创建一个CouchServer对象即可。

许可证

在Apache许可证，版本2.0下发布。

作者： Jens Alfke

贡献者： J Chris Anderson、David Venable、Alex McArthur、Jonathon Mah、Pierre Metrailler、Sven A. Schmidt、Katrin Apel。

版权所有 2012，Couchbase，Inc。