Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
  • Loading branch information
zachhildreth committed Apr 9, 2020
2 parents 34e9315 + b43e195 commit f5c5c72
Showing 1 changed file with 48 additions and 51 deletions.
99 changes: 48 additions & 51 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,21 +2,24 @@

<a align="center" href="https://x-network.io/xcash"><img src="header.png" alt="X-Cash Core"></a>



[![Release](https://img.shields.io/github/v/release/X-CASH-official/android-wallet)](https://github.com/X-CASH-official/android-wallet/releases)
[![chat](https://img.shields.io/discord/470575102203920395?logo=discord)](https://discordapp.com/invite/4CAahnd)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=flat)](https://opensource.org/licenses/MIT)
[![open issues](https://img.shields.io/github/issues-raw/X-CASH-official/android-wallet)](https://github.com/X-CASH-official/android-wallet/issues)
[![License: Apache-2.0](https://img.shields.io/github/license/X-CASH-official/android-wallet)](https://github.com/X-CASH-official-team/android-wallet/blob/master/LICENSE)
[![Discord](https://img.shields.io/discord/470575102203920395?logo=discord)](https://discordapp.com/invite/4CAahnd)

</div>

# X-Cash Android Mobile Wallet

📱 **Securely store and manage your XCASH on your mobile.**
Easily end XCASH publicly or privately, manage your wallets, etc... from your phone!
Easily send XCASH publicly or privately, manage your wallets, etc... from your phone!

## Table of Contents

- [Table of Contents](#table-of-contents)
- [Download](#download)
- [Download & Installation](#download--installation)
- [Features](#features)
- [License](#license)
- [Contributing](#contributing)
Expand All @@ -25,12 +28,15 @@ Easily end XCASH publicly or privately, manage your wallets, etc... from your ph
- [Acknowledgement](#acknowledgement)
- [System Requirements](#system-requirements)
- [Installing from source](#installing-from-source)
- [Cloning the repository](#cloning-the-repository)
- [Dependencies](#dependencies)
- [Develop](#develop)
- [Build Instructions](#build-instructions)

## Download & Installation

## Download
> ⚠️ Only download from the [official release page](https://github.com/X-CASH-official/android-wallet/releases).
Check the [latest release](https://github.com/X-CASH-official/android-wallet/releases)
Download the [latest release](https://github.com/X-CASH-official/android-wallet/releases), transfer the `.apk` file to your phone, and run it. You will need to force your phone to install the app as it is not recognized and distributed through the app store yet.

## Features

Expand All @@ -49,7 +55,7 @@ See your payment history from anywhere, directly on your phone.

## License

> *Cloned from [m2049r](https://github.com/m2049r)'s [xmrwallet](https://github.com/m2049r/xmrwallet).*
> *Originally cloned from [m2049r](https://github.com/m2049r)'s [xmrwallet](https://github.com/m2049r/xmrwallet).*
**X-Cash GUI Wallet is an open-source project managed by the X-Cash Foundation**.
Licensed under the Apache License, Version 2.0. View [License](LICENSE)
Expand Down Expand Up @@ -80,73 +86,64 @@ All security vulnerabilities concerning the X-Cash blockchain will be promply ad

`Android 4.2+` (API 17+)

#### Native
## Installing from source

`arm64-v8a`,`armeabi-v7a`
### Cloning the repository

## Installing from source
```bash
git clone https://github.com/X-CASH-official/android-wallet.git
```

### Dependencies

[Android Studio](https://developer.android.com/studio)

### Develop
#### Libraries

#### Clone repository
**Note:** The libraries mandatory the `.apk` already built. If you wish to update them or rebuild, run the build script at:

```bash
git clone https://github.com/X-CASH-official/android-wallet.git
android-wallet/xcash-libs/build.sh
```

Note we will be using the home directory for the below instructions and have cloned the repository to $HOME
> The build script will install the build tools, the android NDK and build all of the nessary libraries.
The libaries to build the apk are already built, but if you need to update them or rebuild them, run the build script
`$HOME/android-wallet/xcash-libs/build.sh`
#### JDK

The build script will install the build tools, install the android NDK and build all of the nessary libaries
```bash
sudo apt install -y openjdk-8-jdk
```

#### Android Studio

You can download Android Studio here: https://developer.android.com/studio) or run:
```bash
sudo snap install android-studio --classic
```

To build the APK after using the prebuilt libaries, or building the libaries
#### NDK

Install JDK
`sudo apt install -y openjdk-8-jdk`
Open `Android Studio` and verify that the Native Development Kit (NDK) is installed.

Install android studio
`sudo snap install android-studio --classic`
Go to `Files > Settings` and type `SDK`in the search box, then click on the `SDK Tools`tab.

Open project in Android Studio
If the NDK is not installed, you can check the box and click on `Apply`.

Check that the NDK is installed
```
File -> Settings
Type "SDK" in the search box
Click on the "SDK Tools" tab
```
Once done, re-sync `gradle` (elephant icon on the top right)

If the NDK was not installed
```
Check the box next to NDK (side by side)
Click on apply

when it is done, resync gradle by pressing the elephant icon at the top right
```
### Build Instructions

Build APK
Create a key file to sign your APK
#### Sign your `.apk` (optional)

Open an android studio terminal (should have a tab on the bottom) and run this command
```
Open a terminal window in `android-studio` and run:
```bash
keytool -genkey -v -keystore my-release-key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias my-alias
```
Fill it out and then this is your key file

Replace `my-alias` by your name.

Create a signed APK
```
Build -> Generate signed key file or APK
Select APK and click next
Select your keyfile and type in the password. For key alias use "my-alias" and click next
Select release and check the box for V1 and V2 signature versions and click finish
The apk will be located in $HOME/android-wallet/app/release/app-release.apk
```
#### Build the APK

Go to `Build > Generate signed key file or APK`, select `APK` and click `Next`. Give your keyfile and select `release. Check box for V1 and V2 signature and click finish.

The app will be built in :
```android-wallet/app/release/app-release.apk```

0 comments on commit f5c5c72

Please sign in to comment.