From 654c43a709aafcab32d775e6c9581b45d5847fff Mon Sep 17 00:00:00 2001 From: George G Date: Sun, 29 Nov 2020 00:18:12 +0200 Subject: [PATCH] README: More detailed Android building instructions I tried to build the android app and experienced a lot of problems which I solved after a lot of trial and error, so I thought others can skip them. Another tip I didn't know how exactly to include it, so I'll leave it here: If you get errors about `node-sass` not getting installed, change your NodeJS version to v11 (v11.15.0) using nvm: https://github.com/nvm-sh/nvm. --- README.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index f453421d532..d771e05a4f4 100644 --- a/README.md +++ b/README.md @@ -104,7 +104,16 @@ npm run start:desktop Before building the release version for a platform, run the `clean-all` command to delete any untracked files in your current working directory. (Be sure to stash any uncommitted changes you've made.) This guarantees consistency across builds for the current state of this repository. -The `final` commands build the production version of the app, and bundle it with the release version of the platform being built. +You still need to follow the [Cordova Android Platform Guide](https://cordova.apache.org/docs/en/latest/guide/platforms/android/) to set up your development environment. Specifically, you will need to set the `ANDROID_HOME` environment variable, include the Android SDK's tools, tools/bin, and platform-tools directories to your PATH: +``` +export ANDROID_HOME=/Development/android-sdk +export PATH=${PATH}:/Development/android-sdk/platform-tools:/Development/android-sdk/tools +``` + +You may also need to install `gradle` independently in your distribution (e.g. `sudo apt install gradle` for Ubuntu). + +The `final` commands build the production version of the app, and bundle it with the release version of the platform being built. The build will fail if no `copay.keystore` in the `..\copay` directory is provided. Produce a new android keystore named `copay.keystore` and include a signed key named `copay_play` to finish the build. + ### Android