SilentDragonAndroid-old/README.md

# SilentDragon Android

SilentDragon Android is an Android frontend for the desktop [SilentDragon](https://git.hush.is/hush/SilentDragon) or [SilentDragonLite](https://git.hush.is/hush/SilentDragonLite) that lets you send and receive shielded payments from your mobile phone. We are currently working on implementing Lite Wallet and HushChat functionality on Android, so follow us on our [Mastodon](https://fosstodon.org/@myhushteam) to stay updated. After this functionality is implemented, we are planning on making an official F-Droid release.

<img height=50% width=50% src="SDA.jpg">

## Installation

The minimum supported Android version is 4.4.x KitKat. There are three ways to install:

1. Direct APK install available at the [Releases page](https://git.hush.is/hush/SilentDragonAndroid/releases). You will need to allow `Install from untrusted sources` on your Android phone in order to install from this source.
1. Via our custom 3rd-party F-Droid repository, which you can [find here](https://hush.is/fdroid).
1. Least recommended method is via the [Google Play Store](https://play.google.com/store/apps/details?id=org.myhush.silentdragon).

## Running SilentDragon

In order to let your Android phone connect to your desktop, you need to run the either desktop 
wallet [SilentDragonLite](https://git.hush.is/hush/SilentDragonLite) or 
[SilentDragon](https://git.hush.is/hush/SilentDragon) fully synced. This is not a full node
on your Android (your poor battery!). It's a remote control for your full node.

Thankfully this should only take a short time with a fast internet connection!
As the Hush network grows, it will take longer. As of December 2021, the Hush blockchain
is over 4GB on disk.

After your node is synced, go to `Apps -> Connect Mobile App` to view the
connection QR Code, which you can scan from the Android App.

### Bugs???

You can file issues in the [issues tab](https://git.hush.is/hush/SilentDragonAndroid/issues).

We appreciate them! Please follow the Gitea issue template, when reasonable.

## Compiling from source

You can also compile and run from source.

On OS X:

    brew doctor
    brew install ant
    brew install maven
    brew install gradle
    brew cask install android-sdk
    brew cask install android-ndk

    touch ~/.android/repositories.cfg
    sdkmanager --update
    sdkmanager "platform-tools" "platforms;android-28"
    gradle build

On Debian-based systems:

    apt-get install -y android-sdk gradle
    touch ~/.android/repositories.cfg
    sdkmanager --update
    sdkmanager "platform-tools" "platforms;android-28"
    gradle build

Make sure you have Gradle 5.4.x or higher, 5.4.1 is known to work:

    ./gradlew wrapper --gradle-version=5.4.1

Or you can use Android Studio on Linux, OS X, or Windows:

    Make sure to install ndkVersion 21.1.6352462.
    Clone the repository and open the project in Android Studio.
    Android Studio will automatically run the initial build process.
    Click the Run button to launch the app after the build process is complete.

## Release Build Process

The first time you create a release build you'll need to create a keystore file and prepare a properties file. The
release keystore is used for app signing and a properties file is used to store
sensitive information about the keystore. **These files should not be committed
to git.** Once you have both of these files you can create a release build for
the Google Play Store. For further information, [click here](release_build_process.md).

## Contributing

Contributions to this project are welcome and encouraged.

## Support

For support or other questions, join us on [Telegram](https://hush.is/telegram), or toot at our [Mastodon](https://fosstodon.org/@myhushteam), or join [Telegram Support](https://hush.is/telegram_support) or [file an issue](https://git.hush.is/hush/SilentDragonAndroid/issues).