stackmob-ios-push-sdk

https://www.stackmob.com

Getting started

Add the StackMobPush SDK to your app

Configure the StackMob SDK to use your StackMob account

Development

Testing

Kiwi specs run just like OCUnit tests. In Xcode ⌘U will run all the tests for the current scheme.

    describe(@"a public method or feature", ^{
        beforeEach(^{
            //set up
            [[someClass stubAndReturn:aResult] aMethod];
        });
        context(@"when some precondition exists", ^{
            beforeEach(^{
                //set the precondition
            });
            it(@"should have a specific behavior", ^{
                //verify the behavior
                [[aThing shouldNot] equal:someOtherThing];
            });
            pending(@"should eventually have another behavior", ^{
                //pending specs will not execute and generate warnings
                [[[anObject should] receive] aMethodWith:anArgument];
                [anObject doStuff];
            });
            context(@"and another condition exists", ^{
                //...
            });
        });
    });

Integration Tests

Unit tests do not make network requests against StackMob. The project includes a seperate target of integration tests to verify communication with the StackMob API.

1. cp integration-tests/StackMobCredentials.plist.example integration-tests/StackMobCredentials.plist
2. open integration-tests/StackMobCredentials.plist
3. Set the public and private keys for the StackMob account you want the tests to use.
4. Run the "integration-tests" scheme.

Using the SDK in a test app during development

1. Install the SDK in your app using CocoaPods
2. Replace /Pods/StackMobPush with a symlink to your development copy of the SDK
3. Your app's Pods project will use the current source of your development copy of the SDK on every build.

Submitting pull requests

1. Fork the repository on github and clone your fork.
2. Create a topic branch: git checkout -b make_sdk_better.
3. Write some tests for your change.
4. Make the tests pass.
5. Commit your changes.
6. (Go to #2.)
7. Make sure your topic branch is up to date with any changes other developers have added to master while you were working: git checkout master && git pull && git checkout - && git merge master (git rebase master for local branches if you prefer).
8. Push your topic branch to your fork: git push origin make_sdk_better.
9. Create a pull request on github asking StackMob to merge your topic branch into StackMob's master branch.