Donations library for Android. Supports Google Play Store, Flattr, PayPal, and Bitcoin
Java
Latest commit ada07cd Nov 16, 2016 @dschuermann dschuermann Version 2.5

README.md

Android Donations Lib

Android Donations Lib supports donations by Google Play Store, Flattr, PayPal, and Bitcoin.

It is used in projects, such as OpenKeychain, AdAway, FasterGPS, and NTPSync.

NOTE: Google mailed me to remove PayPal donation capability when publishing on Google Play! Thus, you should build "product flavors" defined by the example: One version with Google Play donation capability and one with Paypal, Flattr, and Bitcoin!

How to import

Add this to your build.gradle:

repositories {
    jcenter()
}

dependencies {
    compile 'org.sufficientlysecure:donations:2.5'
}

Screenshots

Product Flavor: Google Product Flavor: Fdroid
Screenshot Screenshot

Translations

Help translating on Transifex.

Build Example App with Gradle

  1. Have Android SDK "tools", "platform-tools", and "build-tools" directories in your PATH (http://developer.android.com/sdk/index.html)
  2. Export ANDROID_HOME pointing to your Android SDK
  3. Download Android Support Repository, and Google Repository using Android SDK Manager
  4. Execute ./gradlew build

Add the lib to your project

  • The ExampleApp depends on "libraries/Donations" and has two product flavors defined in its gradle configuration.
  • See ExampleApp/build.gradle how to build different product flavors. The build script adds DONATIONS_GOOGLE to the auto generated BuildConfig.java.
  • See DonationsActivity.java how to instantiate the Fragment based on DONATIONS_GOOGLE.
  • When publishing the app you must create managed in-app products for your app in the Google Play Store that matches the ones you defined in private static final String[] GOOGLE_CATALOG
  • Add <uses-permission android:name="android.permission.INTERNET" /> to product flavors that use Flattr
  • Add <uses-permission android:name="com.android.vending.BILLING" /> to product flavors that use Google Play In-app billing

Changelog

2.5

  • Sync translations

2.4

  • Fix NPE without billing service

2.3

  • Publish to JCenter

2.2

  • Updated build files
  • Added bitcoin support (thanks to Oleg Vaskevich)

2.1

  • Permissions are now defined per product flavor, they were removed from library's AndroidManifest

2.0

  • Now uses Gradle Build System (http://tools.android.com/tech-docs/new-build-system)
  • No xml configuration needed anymore!
  • Fragment can be instantiated and used in any Activity.
  • You can build "product flavors" defined by the ExampleApp: One version with Google Play Donation capability and one with Paypal and Flattr! (Google mailed me to remove PayPal donation capability when publishing on Google Play!)

Contribute

Fork Android Donations Lib and do a pull request. I will merge your changes back into the main project.