##Version
Current Version: 0.9.2
Change log:
https://github.com/apigee/usergrid-javascript-sdk/blob/master/changelog.md
##Overview This open source SDK simplifies writing iOS applications that connect to App Services (Usergrid). The repo is located here:
https://github.com/apigee/usergrid-ios-sdk
You can download the SDK here:
To find out more about App Services, which is Apigee's hosted Usergrid solution, see:
http://apigee.com/about/developers
To view the Apigee App Services documentation, see:
http://apigee.com/docs/app_services
##Installing Once you have downloaded the SDK, add the UGAPI folder to your project by dragging and dropping it into your project.
Note: Make sure you check the “Copy items into destination group's folder”, and also make sure the appropriate boxes are checked next to “Add to targets”.
##Getting started If you haven't done so, make sure you know your organization name and your application name. Your organization name will be the same as the username you signed up with.
Within your organization, you can have multiple application namespaces. By default, an application named “Sandbox” has been created for you to use for testing, but you can also log into the Admin Portal and create an application with any name you want.
Once you have your application name, you will want to create a UGClient object like so:
//configure the org and app NSString * orgName = @"ApigeeOrg"; NSString * appName = @"MessageeApp"; //make new client usergridClient = [[UGClient alloc]initWithOrganizationId: orgName withApplicationID: appName];
Now use the usergridClient object to invoke other methods that access the API. For example, to log a user in:
[usergridClient logInUser:username password:password]; UGUser *user = [usergridClient getLoggedInUser];
Or, to create a user:
UGClientResponse *response = [usergridClient addUser:@"myusername" email:@"email@email.com" name:@"my name" password:@"mypassword"];
if (response.transactionState == 0) {
//user created!
}
##Sample Code If you are ready to look at a fully functional app that uses this SDK, check out our Messagee application. It is a twitter-type app that exercises many parts of the API including: Login / Authentication, GET and POST operations, activities (tweets), and social features such as following relationships.
The Messagee Xcode project is located here:
https://github.com/apigee/usergrid-sample-ios-messagee
##Running Tests
The iOS SDK unit tests are written with Nu. You'll need to install the language itself to run the tests, and use the Nukefile to create a Usergrid.framework. For installation directions go here
To compile the Usergrid SDK as an Objective-C framework simple type nuke to build the framework and then nuke install to install it in the /Library/Frameworks path.
To run the unit tests written for the SDK use the command nuke test this will run all tests.
We welcome your enhancements!
Like Usergrid, the Usergrid Objective-C SDK is open source and licensed under the Apache License, Version 2.0.
git checkout -b my-new-feature)git commit -am 'Added some feature')git push origin my-new-feature)##More information For more information on Apigee App Services, visit http://apigee.com/about/developers.
Copyright 2013 Apigee Corporation
Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.