marcammann / csconfigurationmanager

Configuration manager class to manage configurations with JSON or Plist files for Cocoa / CocoaTouch (iOS 6+)

Introduction

CSConfigurationManager allows to load configurations from a PLIST or JSON files in iOS, categorized by CONFIGURATION constant. Also allows to have Default values, which get overwritten by the corresponding CONFIGURATION values.

CONFIGURATION is the name of the constant that XCode uses for the name of the build configuration. So if you have a build configuration called Release and one called Debug, you could set up a configuration like this:

Configuration.json

{
	"Default": {
		"BaseURL": "http://google.com",
		"APIVersion": "v2.x"
		"LogLevel": "Error"
	},
	"Release": {
		"APIVersion": "v2.01"
	},
	"Debug": {
		"LogLevel": "Debug"
	}
}

If you request values from the configuration manager when you built for target Release your returned value for APIVersion would be v2.01.

Usage

Assuming your build target is "Debug"

NSString *path = [[NSBundle bundleForClass:[self class]] pathForResource:@"Configuration" ofType:@"json"];

CSConfigurationManager *configurationManager = [[CSConfigurationManager alloc] initWithContentsOfJSON:path];
[configurationManager valueForKey:@"APIVersion"]; // @"2.x"
[configurationManager valueForKey:@"LogLevel"]; // @"Debug"

Setup

Insert the following to your preprocessor macro build settings:

STRINGIFY(X)=#X
BUILD_TARGET=STRINGIFY(${CONFIGURATION})
USERNAME=STRINGIFY(${USER})
CONFIGURATION_${CONFIGURATION}

Include CSConfigurationManager.h to your file and start using it.