iOS-CrackRock 1.0.0

Maintained by Unclaimed.

You want to add pod 'iOS-CrackRock', '~> 1.0' similar to the following to your Podfile:

target 'MyApp' do
  pod 'iOS-CrackRock', '~> 1.0'
end

Then run a pod install inside your terminal, or from CocoaPods.app.

Alternatively to give it a test run, run the command:

pod try iOS-CrackRock


Depends on:
BrynKit/Main	>= 1.2.1
BrynKit/RACHelpers	>= 1.2.1
BrynKit/GCDThreadsafe	>= 1.2.1
BrynKit/EDColor	>= 1.2.1
BrynKit/CocoaLumberjack	>= 1.2.1
CocoaLumberjack	>= 0
ReactiveCocoa	>= 1.4.0
ReactiveCocoa/RACExtensions	>= 1.4.0
StateMachine-GCDThreadsafe	>= 2.0.1
Underscore.m	>= 0.2.0
libextobjc/EXTBlockMethod	>= 0.2.5
libextobjc/EXTScope	>= 0.2.5
libextobjc/EXTSynthesize	>= 0.2.5
libextobjc/NSMethodSignature+EXT	>= 0.2.5

iOS-CrackRock 1.0.0

By
bryn austin bellomy

// iOS crack rock

as in: the irresistible street drug

(unbifurcations)

what

Helpers for brewing that delicious iOS fool-aid.

Github's excellent ReactiveCocoa was used extensively under the hood, and it's highly recommended that you use it to interface with iOS-CrackRock.

how

some useful properties

It'll probably be helpful to add properties like the following to whichever class ends up being responsible for your SECrackRock implementation.

@property (nonatomic, strong, readwrite) SECrackRock *crackRock;
@property (nonatomic, strong, readwrite) NSSet *availablePowerups;
@property (nonatomic, strong, readwrite) NSSet *allProducts;

@property (nonatomic, strong, readonly)  NSSet *paidProducts;
@property (nonatomic, strong, readonly)  NSSet *freeProducts;

declare your IAP products

In addition to regular products, you can declare 'free' products when appropriate. These are useful when your app sells a product -- let's say, for example, Instagram-style photo filters -- but also offers a reduced set of these for free by default.

Because the IAP servers aren't queried for any of your 'free' products, you have to specify all required metadata when initializing these products (basically just name and description, unless you subclass SECrackRockProduct and add others). Your 'paid' products can simply specify a product ID -- the other parameters of -[SECrackRockProduct initWithProductID:readableName:productDescription:isFree:] can simply be given as nil

- (NSSet *) freeProducts
{
    NSArray *productMetadata = @[
        @{  @"product id": @"freeproduct1",
            @"name": @"super jump",
            @"description": @"boing boing boing",
            @"is powerup": @YES,
            @"free": @YES, },

        @{  @"product id": @"freeproduct2",
            @"name": @"power walk",
            @"description": @"get swole",
            @"is powerup": @NO,
            @"free": @YES, },
    ];
    return [self productsFromMetadata: productMetadata];
}

- (NSSet *) paidProducts
{
    NSArray *productMetadata = @[
        @{  @"product id": @"paidproduct1", @"is powerup": @YES, },
        @{  @"product id": @"paidproduct2", @"is powerup": @NO,  },
    ];
    return [self productsFromMetadata: productMetadata];
}

- (NSSet *) productsFromMetadata: (NSArray *)productMetadata
{
    NSMutableSet *products = [NSMutableSet set];
    for (NSDictionary *metadata in productMetadata) {
        SECrackRockProduct *product = nil;
        if ([metadata[@"is powerup"] boolValue] == YES) {
            product = [MyAppPowerUpProduct initWithProductID: metadata[@"product id"]
                                                readableName: metadata[@"name"]
                                          productDescription: metadata[@"description"]
                                                      isFree: metadata[@"free"]];
        }
        else {
            product = [SECrackRockProduct initWithProductID: metadata[@"product id"]
                                               readableName: metadata[@"name"]
                                         productDescription: metadata[@"description"]
                                                     isFree: metadata[@"free"]];
        }
        [products addObject: product];
    }
    return products;
}

initialize the crack rock

Add something like the following to whichever part of your application should bootstrap the in-app purchase functionality. Probably best to do this in -application:didFinishLaunchingWithOptions:.

- (BOOL)              application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    self.crackRock = [[SECrackRock alloc] initWithFreeProducts: freeProducts
                                                  paidProducts: paidProducts];

    // ...
}

reactive crack

Speaking of ReactiveCocoa, you might find some benefit in setting up a few properties like the following.

RAC(self.allProducts) =
    [RACSignal combineLatest: @[
            [RACAbleWithStart([self freeProducts]) distinctUntilChanged],
            [RACAbleWithStart([self paidProducts]) distinctUntilChanged], ]
        reduce:^id (NSSet *freeProducts, NSSet *paidProducts) {
            return [freeProducts setByAddingObjectsFromSet: paidProducts];
        }];

RAC(self.availablePowerups) =
    [[RACAbleWithStart(self.crackRock.freeAndPurchasedProducts)
        distinctUntilChanged]
        map:^id (NSSet *freeAndPurchasedProducts) {
            NSMutableSet *availablePowerups = [NSMutableSet set];

            for (SECrackRockProduct *product in freeAndPurchasedProducts) {
                if ([product isKindOfClass: [MyAppPowerUpProducts class]]) {
                    [availablePowerups addObject: product];
                }
            }
            return availablePowerups;
        }];
}

buy stuff

When you purchase and restore items, SECrackRock's properties will send KVO notifications. You can observe these properties using KVO or a framework like ReactiveCocoa and update the UI and application state accordingly.

[self.crackRock purchase: productID
              completion:^(NSError *error) {
                  if (error != nil) {
                      NSLog(@"purchase error = %@", error);
                      return;
                  }

                  NSLog(@"purchase success!");
              }];

Restoring is just as easy.

[self.crackRock restoreAllPurchases:^(NSError *error) {
    if (error != nil) {
        NSLog(@"error = %@", error);
        return;
    }

    NSLog(@"restore success!");
}];

license (WTFPL)

DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE Version 2, December 2004

Everyone is permitted to copy and distribute verbatim or modified copies of this license document, and changing it is allowed as long as the name is changed.

DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION

You just DO WHAT THE FUCK YOU WANT TO.