cocos2dx-store | app purchase & virtual economy library | Blockchain library

cocos2dx-store 4.6.3
Clone this repository recursively: git clone --recursive https://github.com/soomla/cocos2dx-store.git
Run ./build_all from project directory
Take created binaries from build directory and use it!
If you didn't already, clone the Cocos2d-x framework from here, or download it from the Cocos2d-x website. Make sure the version you clone is supported by SOOMLA's cocos2dx-store (the tag is the version).
Clone soomla-cocos2dx-core and cocos2dx-store into the extensions folder located at the root of your Cocos2d-x framework. $ git clone git@github.com:soomla/soomla-cocos2dx-core.git extensions/soomla-cocos2dx-core $ git clone git@github.com:soomla/cocos2dx-store.git extensions/cocos2dx-store
cocos2dx-store uses a fork of the jansson library for JSON parsing. Clone it into the external directory at the root of your Cocos2d-x framework. $ git clone git@github.com:soomla/jansson.git external/jansson
Create your own implementation of CCStoreAssets that will represent the assets in your specific game. For a complete example refer to cocos2dx-store-example.
Make sure to include the Cocos2dxStore.h header whenever you use any of the cocos2dx-store functions: #include "Cocos2dxStore.h"
Initialize CCSoomla and CCSoomlaStore with the class you just created, a customSecret and other params: soomla::CCSoomla::initialize("ExampleCustomSecret"); YourImplementationAssets *assets = YourImplementationAssets::create(); __Dictionary *storeParams = __Dictionary::create(); storeParams->setObject(__String::create("ExamplePublicKey"), "androidPublicKey"); storeParams->setObject(__Bool::create(true), "testPurchases"); storeParams->setObject(__Bool::create(true), "SSV"); storeParams->setObject(__Bool::create(true), "verifyOnServerFailure"); soomla::CCSoomlaStore::initialize(assets, storeParams); Custom Secret - is an encryption secret you provide that will be used to secure your data. Android Public Key - is the public key given to you from Google. (iOS doesn't have a public key). Test Purchases - allows testing IAP on Google Play. (iOS doesn't have this functionality). SSV - enables Fraud Protection. (in order to activate it in Google Play see the related section below). verifyOnServerFailure - if you use Fraud Protection, optionally you set this param, if you want to get purchases automatically verified in case of network failures during the verification process. Choose the secret wisely. You can't change it after you launch your game! Initialize CCSoomlaStore ONLY ONCE when your application loads.
You'll need to subscribe to store events to get notified about in-app purchasing related events. refer to the Event Handling section for more information.
Add jansson (external/jansson/) to your project (just add it as a source folder, make sure to check "create group").
For each of the following XCode projects:
Cocos2dXCore.xcodeproj (extensions/soomla-cocos2dx-core/).
Cocos2dXStore.xcodeproj (extensions/cocos2dx-store/). a. Drag the project into your project. b. Add its targets to your Build Phases->Target Dependencies. c. Add its .a files to Build Phases->Link Binary With Libraries.
Add the following directories to Build Settings->Header Search Paths (with the recursive option): $(SRCROOT)/../cocos2d/extensions/soomla-cocos2dx-core/Soomla $(SRCROOT)/../cocos2d/extensions/soomla-cocos2dx-core/build/ios/headers $(SRCROOT)/../cocos2d/extensions/cocos2dx-store/Soomla
Add -ObjC to your project Build Settings->Other Linker Flags.
Make sure you have these 3 Frameworks linked to your XCode project: Security, libsqlite3.0.dylib, StoreKit.
Import cocos2dx-store module into your project's Android.mk by adding the following: //Add this line along with your other LOCAL_WHOLE_STATIC_LIBRARIES LOCAL_WHOLE_STATIC_LIBRARIES += cocos2dx_store_static //Add this line at the end of the file, along with the other import-module calls $(call import-module, extensions/cocos2dx-store)
Add the following jars to your android project's classpath: From extensions/soomla-cocos2dx-core/build/android: SoomlaAndroidCore.jar Cocos2dxAndroidCore.jar square-otto-1.3.2.jar
Update your AndroidManifest.xml to include permissions and the SoomlaApp: <uses-permission android:name="android.permission.INTERNET"/> <uses-permission android:name="com.android.vending.BILLING"/> <application ... android:name="com.soomla.SoomlaApp"> ... </application>
Add AndroidStoreGooglePlay.jar from extensions/cocos2dx-store/build/android/billing-services/google-play to your classpath:
Update your AndroidManifest.xml: ... <uses-permission android:name="com.android.vending.BILLING"/> <application ... <activity android:name="com.soomla.store.billing.google.GooglePlayIabService$IabActivity" android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen"/> <meta-data android:name="billing.service" android:value="google.GooglePlayIabService"/> </application>
Read our tutorial on how to define your in-app products in Google Play.
Start IAB Service in background (optional) // Start Iab Service #if (CC_TARGET_PLATFORM == CC_PLATFORM_ANDROID) CCSoomlaStore::getInstance()->startIabServiceInBg(); #endif // Stop Iab Service #if (CC_TARGET_PLATFORM == CC_PLATFORM_ANDROID) CCSoomlaStore::getInstance()->stopIabServiceInBg(); #endif This is not mandatory, your game will work without this, but we recommend it because it enhances performance. The idea here is to preemptively start the in-app billing setup process with Google's servers. In many games the user has to navigate into the in-game store, or start a game session in order to reach the point of making purchases. You want the user experience to be fast and smooth and prevent any lag that could be caused by network latency and setup routines you could have done silently in the background. Don't forget to close the Iab Service when your store is closed.
In case you want to turn on Fraud Protection you need to get clientId, clientSecret and refreshToken as explained in Google Play Purchase Verification and use them like this: storeParams->setObject(__String::create(<YOU_CLIENT_ID>), "clientId"); storeParams->setObject(__String::create(<YOUR_CLIENT_SECRET>), "clientSecret"); storeParams->setObject(__String::create(<YOUR_REFRESH_TOKEN>), "refreshToken");
Add in-app-purchasing-1.0.3.jar and AndroidStoreAmazon.jar from extensions/cocos2dx-store/build/android/billing-services/amazon to your classpath:
Update your manifest: <receiver android:name = "com.amazon.inapp.purchasing.ResponseReceiver" > <intent-filter> <action android:name = "com.amazon.inapp.purchasing.NOTIFY" android:permission = "com.amazon.inapp.purchasing.Permission.NOTIFY" /> </intent-filter> </receiver> <meta-data android:name="billing.service" android:value="amazon.AmazonIabService" />
Read our tutorial on how to define your in-app products in the Amazon Appstore.
Read our tutorial on how to define your in-app products in the App Store.
Use SOOMLA's Fraud Protection (Optional) As you probably know, fraud on IAP is pretty common. Hackers can crack their smartphones to think that a purchase was made when the payment isn't actually transferred to you. To help game developers with this issue, we created a verification server that you can use instantly through the framework. All you need to do is let cocos2dx-store know that you want to verify purchases. You can do this by passing an extra parameter to CCSoomlaStore: storeParams->setObject(Bool::create(true), "SSV"); soomla::CCStoreService::initShared(assets, storeParams);