iOS-CrackRock 1.0.0

iOS-CrackRock 1.0.0

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

Maintained by Unclaimed.


Downloads

Total16
Week0
Month0

Installs

Apps4
powered by Segment

GitHub

Stars13
Watchers2
Forks0
Issues0
Contributors1
Pull Requests0

Code

Files11
LOCLines of Code 809


 
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
 

  • By
  • bryn austin bellomy

// iOS crack rock

as in: the irresistible street drug

crackrock

(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

Copyright (C) 2004 Sam Hocevar <[email protected]>

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

  1. You just DO WHAT THE FUCK YOU WANT TO.