Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Updated README to make it clear this is obsolete

Change-Id: I90624b88ad6a058b7d9f76ec9165c25f217fed22
Reviewed-on: http://review.couchbase.org/24187
Reviewed-by: Jens Alfke <jens@couchbase.com>
Tested-by: Jens Alfke <jens@couchbase.com>
  • Loading branch information...
commit bec206b479cda9920e2a2be303c06b3268c745d2 1 parent abc0542
Jens Alfke snej authored
Showing with 98 additions and 93 deletions.
  1. +3 −93 README.md
  2. +95 −0 README_old.md
96 README.md
View
@@ -1,95 +1,5 @@
-## Mobile Couchbase for iOS
+# STOP!
-Apache CouchDB on iOS provides a simple way to sync your application data across devices and provide cloud backup of user data. Unlike other cloud solutions, the data is hosted on the device by Couchbase Mobile, so even when the network is down or slow (airplane, subway, backyard) the application is responsive to users.
+## Of Historical Interest Only
-What this means for you:
-
-* You can embed the rock solid distributed database, Mobile Couchbase, on your iOS device.
-* Your iOS apps can use Apache CouchDB's well-proven synchronization technology.
-* If you <3 CouchApps, you can deploy them as iOS apps.
-
-### Join us
-
-There is a [Google Group here for Mobile Couchbase][2]. Let's talk about how to optimize the Erlang build, what the best Cocoa APIs are for CouchDB, how to take advantage of replication on mobile devices. It'll be fun.
-
-## Build Or Download?
-
-You have a choice: build the Couchbase framework from source, or [download a pre-compiled version][1]. **If you just want to _use_ Couchbase Mobile in your apps, you will probably want the pre-compiled version.** It will save you the trouble of having to check out this repository, acquire the prerequisites, configure and build. Download it [here][1], then skip to the section "Using The Framework In Your Xcode Projects".
-
-But if you want to contribute to Couchbase Mobile itself, and don't mind getting your hands dirty with Erlang, SpiderMonkey, OpenSSL, fat static frameworks, armv6 vs. armv7 ... then read on.
-
-## Building The Framework
-
-The following instructions can be used to build Mobile Couchbase for devices and simulators, using Xcode 4. (It is possible the projects might still work with Xcode 3, but we're not testing or supporting this anymore. It's difficult enough to get all the moving parts to mesh together in one version of Xcode at a time!)
-
-These instructions assume you are experienced with Xcode and iPhone development. If you have questions or get stuck, ask on the [Google group][2].
-
-### Install Erlang
-
-You will need to have the Erlang compiler installed on your Mac. The easiest way to do this is via the Homebrew package manager. (MacPorts also has Erlang, but it currently doesn't work correctly on Mac OS X 10.7.)
-
-1. If you haven't already, [install homebrew][3].
-2. Enter `sudo brew install erlang` at a shell.
-
-This may take a while to build.
-
-### Get the main repository
-
- git clone git://github.com/couchbaselabs/iOS-Couchbase.git
-
-### Get the submodules
-
- cd iOS-Couchbase/
- git submodule init
- git submodule update
-
-### Open the Xcode workspace
-
- open Couchbase.xcworkspace
-
-### Build the framework
-
-* Select "CouchBase.framework > iOS Device" from the scheme popup in the toolbar.
-* Select "Product > Build For > Build For Archiving" -- this will build an optimized version.
-
-The framework will be created at
-
- DerivedData/Couchbase/Build/Products/Release-universal/Couchbase.framework
-
-### Sanity Check: Run The Empty App
-
-* First build the framework if you haven't already (the app target's dependencies won't correctly build the framework)
-* Select "Empty App" from the scheme popup in the toolbar (choosing the appropriate destination, either device or simulator)
-* Click the Run button
-
-The empty app, as the name implies, doesn't actually do anything. It's just an integration test to make sure CouchDB can initialize and run. If everything goes correctly, the last line logged to the Xcode console should end with "Everything works!". Otherwise the app should log an error message and exit.
-
-## Using The Framework In Your Xcode Projects
-
-1. Open your Xcode project.
-2. Drag the Couchbase.framework you built previously into the “Frameworks” section of the file list in your project window.
-3. Link your target against the Security framework if it doesn't already. Go to the target's Build Phases and open "Link Binary With Libraries". If "Security.framework" isn't in the list, click the "+" button, and add it.
-4. Similarly, if your project doesn't already contain any C++ code, you'll need to add the C++ library ("libstdc++.dylib") using the same steps as above.
-5. Go to the target's Build Phases and add a new Run Script phase.
-6. Paste the following into the script content of the new phase. (NOTE: If you put the Couchbase framework elsewhere, update the path in the 2nd argument to ‘rsync’ accordingly.)
-
-_Important: The `rsync` command below is a single long line. Do not put a newline in the middle!_
-
- # The 'CouchbaseResources' subfolder of the framework contains Erlang code
- # and other resources needed at runtime. Copy it into the app bundle:
- rsync -a "${SRCROOT}/Frameworks/Couchbase.framework/CouchbaseResources" "${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}"
-
-That’s it for the project setup. In your application code, you’ll need to start the CouchbaseMobile object at launch time. (See CouchbaseMobile.h, and see EmptyAppDelegate.m for an example of how to call it.)
-
-
-## License
-
-Portions under Apache, Erlang, and other licenses.
-
-The overall package is released under the Apache license, 2.0.
-
-Copyright 2011, Couchbase, Inc.
-
-[1]: https://github.com/downloads/couchbaselabs/iOS-Couchbase/iOS-Couchbase.zip
-[2]: https://groups.google.com/group/mobile-couchbase
-[3]: https://github.com/mxcl/homebrew
+This is the old (2011) Couchbase Mobile, an attempt to port Apache CouchDB to iOS. **We do not recommend that anyone use this for new development**; it's been superseded by [TouchDB](http://touchdb.org) which is much smaller and faster, and is being actively developed.
95 README_old.md
View
@@ -0,0 +1,95 @@
+## Mobile Couchbase for iOS
+
+Apache CouchDB on iOS provides a simple way to sync your application data across devices and provide cloud backup of user data. Unlike other cloud solutions, the data is hosted on the device by Couchbase Mobile, so even when the network is down or slow (airplane, subway, backyard) the application is responsive to users.
+
+What this means for you:
+
+* You can embed the rock solid distributed database, Mobile Couchbase, on your iOS device.
+* Your iOS apps can use Apache CouchDB's well-proven synchronization technology.
+* If you <3 CouchApps, you can deploy them as iOS apps.
+
+### Join us
+
+There is a [Google Group here for Mobile Couchbase][2]. Let's talk about how to optimize the Erlang build, what the best Cocoa APIs are for CouchDB, how to take advantage of replication on mobile devices. It'll be fun.
+
+## Build Or Download?
+
+You have a choice: build the Couchbase framework from source, or [download a pre-compiled version][1]. **If you just want to _use_ Couchbase Mobile in your apps, you will probably want the pre-compiled version.** It will save you the trouble of having to check out this repository, acquire the prerequisites, configure and build. Download it [here][1], then skip to the section "Using The Framework In Your Xcode Projects".
+
+But if you want to contribute to Couchbase Mobile itself, and don't mind getting your hands dirty with Erlang, SpiderMonkey, OpenSSL, fat static frameworks, armv6 vs. armv7 ... then read on.
+
+## Building The Framework
+
+The following instructions can be used to build Mobile Couchbase for devices and simulators, using Xcode 4. (It is possible the projects might still work with Xcode 3, but we're not testing or supporting this anymore. It's difficult enough to get all the moving parts to mesh together in one version of Xcode at a time!)
+
+These instructions assume you are experienced with Xcode and iPhone development. If you have questions or get stuck, ask on the [Google group][2].
+
+### Install Erlang
+
+You will need to have the Erlang compiler installed on your Mac. The easiest way to do this is via the Homebrew package manager. (MacPorts also has Erlang, but it currently doesn't work correctly on Mac OS X 10.7.)
+
+1. If you haven't already, [install homebrew][3].
+2. Enter `sudo brew install erlang` at a shell.
+
+This may take a while to build.
+
+### Get the main repository
+
+ git clone git://github.com/couchbaselabs/iOS-Couchbase.git
+
+### Get the submodules
+
+ cd iOS-Couchbase/
+ git submodule init
+ git submodule update
+
+### Open the Xcode workspace
+
+ open Couchbase.xcworkspace
+
+### Build the framework
+
+* Select "CouchBase.framework > iOS Device" from the scheme popup in the toolbar.
+* Select "Product > Build For > Build For Archiving" -- this will build an optimized version.
+
+The framework will be created at
+
+ DerivedData/Couchbase/Build/Products/Release-universal/Couchbase.framework
+
+### Sanity Check: Run The Empty App
+
+* First build the framework if you haven't already (the app target's dependencies won't correctly build the framework)
+* Select "Empty App" from the scheme popup in the toolbar (choosing the appropriate destination, either device or simulator)
+* Click the Run button
+
+The empty app, as the name implies, doesn't actually do anything. It's just an integration test to make sure CouchDB can initialize and run. If everything goes correctly, the last line logged to the Xcode console should end with "Everything works!". Otherwise the app should log an error message and exit.
+
+## Using The Framework In Your Xcode Projects
+
+1. Open your Xcode project.
+2. Drag the Couchbase.framework you built previously into the “Frameworks” section of the file list in your project window.
+3. Link your target against the Security framework if it doesn't already. Go to the target's Build Phases and open "Link Binary With Libraries". If "Security.framework" isn't in the list, click the "+" button, and add it.
+4. Similarly, if your project doesn't already contain any C++ code, you'll need to add the C++ library ("libstdc++.dylib") using the same steps as above.
+5. Go to the target's Build Phases and add a new Run Script phase.
+6. Paste the following into the script content of the new phase. (NOTE: If you put the Couchbase framework elsewhere, update the path in the 2nd argument to ‘rsync’ accordingly.)
+
+_Important: The `rsync` command below is a single long line. Do not put a newline in the middle!_
+
+ # The 'CouchbaseResources' subfolder of the framework contains Erlang code
+ # and other resources needed at runtime. Copy it into the app bundle:
+ rsync -a "${SRCROOT}/Frameworks/Couchbase.framework/CouchbaseResources" "${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}"
+
+That’s it for the project setup. In your application code, you’ll need to start the CouchbaseMobile object at launch time. (See CouchbaseMobile.h, and see EmptyAppDelegate.m for an example of how to call it.)
+
+
+## License
+
+Portions under Apache, Erlang, and other licenses.
+
+The overall package is released under the Apache license, 2.0.
+
+Copyright 2011, Couchbase, Inc.
+
+[1]: https://github.com/downloads/couchbaselabs/iOS-Couchbase/iOS-Couchbase.zip
+[2]: https://groups.google.com/group/mobile-couchbase
+[3]: https://github.com/mxcl/homebrew
Please sign in to comment.
Something went wrong with that request. Please try again.