The ASF SDK lets you sell in-app items for AppCoins (APPC) tokens
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
appcoins-ads [POA/APPC-648] - get campaign from the correct backend according with… Sep 25, 2018
appcoins-contract-proxy [APPC-589] 1-Add minor changes to build script so the build is contai… Sep 19, 2018
appcoins-core [POA/APPC-573] - get campaign id from bds backend instead of blockchain Aug 21, 2018
appcoins-iab [APPC 535] Added permission use for ads and billing. Updated version … Jul 19, 2018
appcoins Codestyle. May 2, 2018
codestyle [APPC-206] Refactor according with the last update of the sdk Apr 3, 2018
ethereumj-android [APPC-662] - ECDSASignature toHex() now returns a normalized encoded … Oct 8, 2018
gradle set version code to 19 and version name to 0.4.5.19b Oct 9, 2018
microraidenj-bds [APPC-589] 1-Add minor changes to build script so the build is contai… Sep 19, 2018
microraidenj [APPC-589] 1-Add minor changes to build script so the build is contai… Sep 19, 2018
scripts [APPC-589] simplified publish script to run locally. Sep 20, 2018
toolbox [POA/APPC-573] - get campaign id from bds backend instead of blockchain Aug 21, 2018
.gitignore [APPC 192] Added new rule on the git ignore Apr 18, 2018
LICENSE Initial commit Oct 16, 2017
README.md Update README.md Oct 8, 2018
README.rst.old Updated readme. Mar 27, 2018
build.gradle [APPC-378] - Updated com.android.tools.build to 3.1.3. Jun 12, 2018
gradle.properties [POA/APPC-648] - correct backend urls Sep 25, 2018
gradlew Android Studio project moved to root. Mar 27, 2018
gradlew.bat Android Studio project moved to root. Mar 27, 2018
settings.gradle [APPC 421] 1-Added address proxy developments to an sdk module. 2-Imp… Jun 25, 2018

README.md

ASF SDK

The ASF SDK gives you the possibility to integrate on your application, transactions with AppCoins (APPC) tokens. Either by enabling in-app purchases with APPC tokens or by rewarding users with APPC tokens when your application is being used.

Abstract

This tutorial will guide you through the process of adding the ASF SDK as a dependency on your project. Then for each separate component of the SDK you can check our wiki pages IAB SDK and User Acquisition SDK.

The integration should be simple enough to be done in under 10 minutes. If this is not the case for you, let us know. The SDK is able to work in the mainnet. You can still use the Ropsten test network, meaning that APPC of all transactions do not have real monetary value, they are used solely for testing purposes.

Prerequisites

  • In order for the ASF SDK to work, you must have an AppCoins compliant wallet installed.
  • Minimum gradle plugin version is 3.0.1.
  • Minimum build tools version is 26.0.1.
  • The Android minimum API Level to use ASF SDK is 21 (Android 5.0).
  • Basic understanding of RxJava not required but is recommended.

Build Script

In your project's buildscript, make sure you have the following:

buildscript {
  repositories {
    jcenter()
    google()
  }
  dependencies {
    classpath 'com.android.tools.build:gradle:3.1.0'

    // NOTE: Do not place your application dependencies here; they belong
    // in the individual module build.gradle files
  }
}

allprojects {
  repositories {
    jcenter()
    google()
    maven { url "https://dl.bintray.com/asf/asf" }
  }
}

And in your app's buildscript, add the following dependency:

dependencies {
    api 'com.asfoundation:appcoins:0.4.5.18b'
}

Or

dependencies {
    api 'com.asfoundation:appcoins-iab:0.4.5.18b'
    api 'com.asfoundation:appcoins-ads:0.4.5.18b'
}

As an example, every time there is an update of the SDKs where no further integration needs to be done, the only thing that should be changed is the version. For example, when the next version is released, the dependencies that should be included in the app's buildscript are:

dependencies {
    api 'com.asfoundation:appcoins:0.4.5.19b'
}

Or

dependencies {
    api 'com.asfoundation:appcoins-iab:0.4.5.19b'
    api 'com.asfoundation:appcoins-ads:0.4.5.19b'
}

Size

As of version 0.4.5.18b, SDK weight is approximately as follows:

  • SDK aar only (without dependencies) - 24KB.

App size increment after adding sdk (assuming no dependencies in common):

  • Without Proguard: 4.5MB.
  • With Proguard: 3.5MB.