macsis / simstorekit

A simulated version of the iPhone's StoreKit, for testing store UIs on the iPhone Simulator, or even on device without having to set up IAP in Connect.

Simulated StoreKit

The sources in this repository simulate Apple's StoreKit framework.

First of all, this code is available under the CC0 license (which, to be blunt, means it's public domain). Legalities:

To the extent possible under law, Emanuele Vulcano has waived all copyright and related or neighboring rights to Simulated StoreKit. This work is published from Italy.

There. Legalities are done. Let's get to it.

What does this do

This code reimplements the contract of Apple's StoreKit framework exactly, except that it prefixes all classes, protocols and constants with ILSim or kILSim (constants only). This can be used to test a IAP app in the simulator, for example, or to provide beta testers a IAP-based app without requiring them to have IAP test accounts or make purchases. Sky's the limit.

Additionally, the ILSimStoreKit.h header includes a set of preprocessor definitions that can be used to switch an app written for StoreKit (using SK… symbols) to SimStoreKit transparently.

How to use it

Write an app that uses StoreKit.

Where you would import StoreKit, replace:

#import <StoreKit/StoreKit.h>

with

#define ILSimReplaceRealStoreKit 1
#import "ILSimStoreKit.h"

Also make sure you compile all the .m files of SimStoreKit in your app, and that all .h files are on the headers path. (The easiest way is to simply drag them all into your project, but see the next section for caveats.)

The library needs to simulate the IAP server using a property list of products, which is set using environment variables (in Xcode, use Project > Edit Active Executable and look in the second tab to set them up). Env variables you can use and the expected format for the products list are documented at the top of ILSimSKPaymentQueue.h.

This is for testing only!

Do not ship apps containing this code! (Duh!) Currently, SimStoreKit does not have a way to remove itself from the build for release builds, so you'll have to make up something on your own (editing the implementation files to have a #if AllowSimStoreKit or other preprocessor tricks are probably the way to go).