History

ThomasV 24054ac399 Merge pull request #3943 from SomberNight/fee_cleanup clean up fees a bit		2018-02-23 10:11:20 +01:00
..
data	Bundle QR scanner with Android app	2017-12-29 23:16:08 +01:00
nfc_scanner	migrating print() to python 3	2017-09-12 17:01:55 +02:00
theming/light	kivy: calculator icon	2016-02-25 14:17:59 +01:00
tools	Bundle QR scanner with Android app	2017-12-29 23:16:08 +01:00
uix	fix #3941	2018-02-21 16:08:32 +01:00
Makefile	misc python3 updates:	2017-08-26 08:28:24 +02:00
Readme.md	kivy readme: manual download of crystax	2018-02-22 13:08:48 +01:00
__init__.py	misc python3 updates:	2017-08-26 08:28:24 +02:00
i18n.py	fix #3941	2018-02-21 16:08:32 +01:00
main.kv	kivy addresses tab: simplify, separate actions from display updates	2017-11-11 11:33:36 +01:00
main_window.py	use string.format instead of old style (%) formatting	2018-02-04 07:26:55 +01:00

Readme.md

Kivy GUI

The Kivy GUI is used with Electrum on Android devices. To generate an APK file, follow these instructions.

1. Install python-for-android (p4a)

p4a is used to package Electrum, Python, SDL and a bootstrap Java app into an APK file. We patched p4a to add some functionality we need for Electrum. Until those changes are merged into p4a, you need to merge them locally (into the master branch):

kivy/python-for-android#1217

Something like this should work:

cd /opt
git clone https://github.com/kivy/python-for-android
cd python-for-android
git remote add agilewalker https://github.com/agilewalker/python-for-android
git checkout a036f4442b6a23
git fetch agilewalker
git merge agilewalker/master

2. Install buildozer

2.1 Buildozer is a frontend to p4a. Luckily we don't need to patch it:

cd /opt
git clone https://github.com/kivy/buildozer
cd buildozer
sudo python3 setup.py install

2.2 Download the Crystax NDK manually. Extract into /opt/crystax-ndk-10.3.2

3. Update the Android SDK build tools

3.1 Start the Android SDK manager:

  ~/.buildozer/android/platform/android-sdk-20/tools/android

3.2 Check the latest SDK available and install it.

3.3 Close the SDK manager.

3.4 Reopen the SDK manager, scroll to the bottom and install the latest build tools (probably v27)

4. Install the Support Library Repository

Install "Android Support Library Repository" from the SDK manager.

5. Create the UI Atlas

In the gui/kivy directory of Electrum, run make theming.

6. Download Electrum dependencies

Run contrib/make_packages.

7. Build the APK

Run contrib/make_apk.

FAQ

Why do I get errors like `package me.dm7.barcodescanner.zxing does not exist` while compiling?

Update your Android build tools to version 27 like described above.

Why do I get errors like `(use -source 7 or higher to enable multi-catch statement)` while compiling?

Make sure that your p4a installation includes commit a3cc78a6d1a107cd3b6bd28db8b80f89e3ecddd2.

I changed something but I don't see any differences on the phone. What did I do wrong?

You probably need to clear the cache: rm -rf .buildozer/android/platform/build/{build,dists}