GroundControl 2.1.0

GroundControl 2.1.0

TestsTested
LangLanguage Obj-CObjective C
License MIT
ReleasedLast Release Dec 2014

Maintained by Mattt.


Downloads

Total154,216
Week0
Month0

Installs

Apps446
Pod Tries18
Test Targets77
Watch Apps4
powered by Segment

GitHub

Stars1,953
Watchers100
Forks121
Issues4
Contributors8
Pull Requests1

Code

Files2
LOCLines of Code 91


  • By
  • Mattt Thompson

Remote configuration for iOS

Break free of the two-week tyranny of the App Store approval process!

Many developers don't realize that they are allowed to remotely control the behavior of their app (provided that the application isn't downloading any new code).

GroundControl gives you a dead-simple way to remotely configure your app, allowing you to add things like feature flags, impromptu A/B tests, or a simple "message of the day".

It's built on top of AFNetworking, and provides a single category on NSUserDefaults (just add #import "NSUserDefaults+GroundControl.h" to the top of any file you want to use it in).

This project is part of a series of open source libraries covering the mission-critical aspects of an iOS app's infrastructure. Be sure to check out its sister projects: SkyLab, CargoBay, houston, and Orbiter.

Client Code

NSURL *URL = [NSURL URLWithString:@"http://example.com/defaults.plist"];
[[NSUserDefaults standardUserDefaults] registerDefaultsWithURL:URL];

...or if you need callbacks for success/failure, and prefer not to listen for a NSUserDefaultsDidChangeNotification:

NSURL *URL = [NSURL URLWithString:@"http://example.com/defaults.plist"];
[[NSUserDefaults standardUserDefaults] registerDefaultsWithURL:URL
  success:^(NSDictionary *) { 
    // ... 
} failure:^(NSError *) { 
    // ...
}];

...or if you need to use an HTTP method other than GET, or need to set any special headers, specify an NSURLRequest:

NSURL *URL = [NSURL URLWithString:@"http://example.com/defaults.plist"];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:URL];
[[NSUserDefaults standardUserDefaults] registerDefaultsWithURLRequest:request
  success:^(NSURLRequest *, NSHTTPURLResponse *, NSDictionary *) { 
    // ... 
} failure:^(NSURLRequest *, NSHTTPURLResponse *, NSError *) { 
    // ... 
}];

Server Code

GroundControl asynchronously downloads and reads a remote plist file. This could be a static file or generated dynamically, like in the following examples (see also the complete Sinatra application found in example/server):

Ruby

require 'sinatra'
require 'plist'

get '/defaults.plist' do
  content_type 'application/x-plist'

  {
    'Greeting' => "Hello, World",
    'Price' => 4.20,
    'FeatureXIsLaunched' => true
  }.to_plist
end

Python

from django.http import HttpResponse
import plistlib

def property_list(request):
    plist = { 
         'Greeting': "Hello, World", 
         'Price': 4.20, 
         'FeatureXIsLaunched': True, 
         'Status': 1 
    }

    return HttpResponse(plistlib.writePlistToString(plist))

Node.js

var plist = require('plist'),
    express = require('express')

var host = "127.0.0.1"
var port = 8080

var app = express()
app.use(app.router)

app.get("/", function(request, response) { 
        response.send(plist.build(
            {
                'Greeting': "Hello, World", 
                'Price': 4.20, 
                'FeatureXIsLaunched': true, 
                'Status': 1
            }
        ).toString())
})

app.listen(port, host)

Contact

Mattt Thompson
@mattt

License

GroundControl is available under the MIT license. See the LICENSE file for more info.