You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
You've made yourself a boss meteor server and a web client to match. Then one day you decide to write a native iOS client and the only easy way to display your content is with a WebView, Cordova, and/or some other non-optimal hackery.
3
+
Easily connect your applications written in Objective-C to server applications that communicate with the [DDP protocol created by Meteor] and, if required by your server, authenticate with [SRP]. Out of the box, this library allows your iOS applications to communicate and authenticate with Meteor servers or any server using the DDP/SRP protocols.
4
4
5
-
What you really want is for your iOS app to communicate directly with the Meteor server, to support Meteor auth, and to perform live updates. No problem.
5
+
## :heavy_exclamation_mark::sparkles:
6
+
7
+
September 2013: We are marking our first release, `version 0.1.0`! This includes (with lots of help from @ewindso):
8
+
9
+
* several changes that help stabilize the application in real world scenarios (i.e. reconnect).
10
+
* We added the ability to send DDP messages that invoke methods on your server (i.e. [Meteor.call](http://docs.meteor.com/#meteor_call)).
11
+
* You can listen for a notification that confirms a subscription request you've made is ready, there are notifications for auth failure, and you can now get notifications on a per collection basis if you want.
12
+
* You can now unsubscribe from updates for specific collections on the server.
13
+
* Finally, the ObjectiveDDP library and Example projects have been configured to play nicely with the latest Xcode version 5.
6
14
7
15
Requirements
8
16
--------------
9
-
ObjectiveDDP should run well in iOS projects using ARC and iOS 5 or above (ok well maybe not iOS 7, yet) and with the more recent versions of xcode. If you don't know what ARC is and a cocoapod sounds like something that goes in the fancy office coffee machine then you should probably ask one of your iOS nerd friends to help you out.
17
+
ObjectiveDDP should run well in iOS projects using ARC and iOS 5.0 or above. If you don't know what ARC is and a cocoapod sounds like something that goes in the fancy office coffee machine then you should probably ask one of your iOS nerd friends to help you out.
10
18
11
19
Quick Start: The Sample App
12
20
--------------
13
21
ObjectiveDDP ships with a todo application (of course) that illustrates much about how ObjectiveDDP helps a native iOS app interact with a Meteor server. To run it:
14
22
15
23
* Clone this repo and navigate to the Example app:
**NOTE: The app currently points to a hosted version of the meteor server and has a hardcoded user name. This will change soon.**
42
+
**NOTE: The app connects to a meteor server [http://ddptester.meteor.com](http://ddptester.meteor.com)and has a hardcoded user name.**
45
43
46
44
Development: Writing Your Own App
47
45
--------------
48
46
49
-
_Note: ObjectiveDDP is a brand new project and is very much subject to change. Please check this readme and the project wiki frequently for updates._
47
+
_Note: ObjectiveDDP is a work in progress and subject to change. Although we do make an effort to remain backwards compatible with the original API, please check this readme and the project wiki frequently for updates to stay up to date._
50
48
51
49
#### ObjectiveDDP Boilerplate ####
52
50
The example application illustrates everything you need to know about integrating ObjectiveDDP into your iOS application. You can also reference the technical walkthrough in the wiki [ios boilerplate] section for the step by step details of creating a simple iOS app that can connect to a meteor server.
53
51
54
52
#### Development Branch: The Bleeding Edge ####
55
-
The master branch of this repo is "stable" and should generally be the one used for linking to projects via cocoapods. Active development happens on the development branch - feel free to use it to experiment with the latest features.
53
+
Please use this branch if you have forked the project and plan to send pull requests. It is also useful for testing new features that you read about in issues but are not in the master branch yet.
56
54
57
55
#### Tests ####
58
56
All tests are in the Specs directory and tests (which are actually the best documenatation) for the DDP protocol implementation are in the [ddp tests] file.
@@ -68,18 +66,20 @@ This project is independent, open source, and is not affiliated with Meteor. If
68
66
69
67
####Contributors####
70
68
71
-
@stevemanuel
72
-
@ewindso
73
-
@boundsj (author)
69
+
*@stevemanuel
70
+
*@ewindso
71
+
*@boundsj (author)
74
72
75
73
License
76
74
--------------
77
-
**MIT**
78
-
75
+
**[MIT]**
76
+
[DDP protocol created by Meteor]: https://github.com/meteor/meteor/blob/devel/packages/livedata/DDP.md
0 commit comments