rodasmith / GreenBits

GreenBits is a Bitcoin Wallet for Android provided by GreenAddress

GreenBits - A native GreenAddress wallet for Android

Build status:

Build requirements

You need to have the following Android developer tools installed:

• "Android SDK Platform-tools" version 25.0.5 recommended
• "Android SDK Tools" version 26.0.2 recommended
• "Android SDK Build-tools" version 25.0.3 recommended
• "Android Support Library" version 25.3.1 recommended
• "Android NDK" version r14b recommended

The above tools can be installed from the Android SDK manager.

GreenBits uses libwally which requires the following to be installed for building:

• SWIG. Most Linux distributions have this packaged, for example on debian sudo apt-get install swig should work.

Clone the repo

git clone https://github.com/greenaddress/GreenBits.git

cd GreenBits

How to build

Cross-compile the native libraries:

This step requires the environment variables ANDROID_NDK and JAVA_HOME to be set correctly.

cd app && ./prepare_fdroid.sh && cd ..

Build the Android app

./gradlew build

This will build both MAINNET and TESTNET builds

For TESTNET only run ./gradlew assembleBtctestnetDebug

Rebuild the checkpoints (optional)

Checkpoint files reduce the amount of data that SPV has to download. The checkpoint data is rebuilt periodically but you may wish to update it if you will be making and testing changes.

To rebuild, start both MAINNET and TESTNET instances of bitcoind on localhost. Make sure they are fully synchronized and have finished booting (verifying blocks, etc).

On MAINNET:

./gradlew --project-dir=bitcoinj/tools buildMainnetCheckpoints && mv bitcoinj/tools/checkpoints app/src/production/assets/checkpoints

On TESTNET:

./gradlew --project-dir=bitcoinj/tools buildTestnetCheckpoints && mv bitcoinj/tools/checkpoints-testnet app/src/btctestnet/assets/checkpoints

Or to build both at once, run:

./buildCheckpoints.sh

If you have docker configured and want to build the app in release mode without having to deal with setting up an Android development environment

cd contrib

docker build -t greenbits_docker .

docker run -v $PATH_TO_GREENBITS_REPO:/gb greenbits_docker

if you don't need to build the Docker image, you can directly do:

docker pull greenaddress/android && docker run -v $PATH_TO_GREENBITS_REPO:/gb greenaddress/android

Acknowledgements

Thanks to Bitcoin Wallet for Android for their QR scanning activity source code!

Thanks to Riccardo Casatta for code and big UX contributions!