android: build apk using new python3 p4a toolchain

2018-11-23 23:17:08 +01:00
parent a53dded50f
commit f095b35663
2 changed files with 58 additions and 39 deletions
--- a/electrum/gui/kivy/Readme.md
+++ b/electrum/gui/kivy/Readme.md
@@ -1,6 +1,9 @@
 # Kivy GUI

-The Kivy GUI is used with Electrum on Android devices. To generate an APK file, follow these instructions.
+The Kivy GUI is used with Electrum on Android devices.
+To generate an APK file, follow these instructions.
+
+Recommended env: Ubuntu 18.04

 ## 1. Preliminaries

@@ -21,10 +24,7 @@ sudo apt-get install python3-kivy

 ## 3. 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):
-
-3.1 [kivy/python-for-android#1217](https://github.com/kivy/python-for-android/pull/1217)
+We need some functionality not in p4a master, so for the time being we have our own fork.

 Something like this should work:

@@ -32,12 +32,9 @@ 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 remote add sombernight https://github.com/SomberNight/python-for-android
 git fetch --all
-git checkout 93759f36ba45c7bbe0456a4b3e6788622924cbac
-git cherry-pick a2fb5ecbc09c4847adbcfd03c6b1ca62b3d09b8d  # openssl-fix
-git cherry-pick a0ef2007bc60ed642fbd8b61937995dbed0ddd24  # disable backups
+git checkout f74226666af69f9915afaee9ef9292db85a6c617
 ```

 ## 4. Install buildozer
@@ -51,31 +48,57 @@ sudo python3 setup.py install
 ```

 4.2 Install additional dependencies:
+
 ```sh
 sudo apt-get install python-pip
 ```
-and the ones listed
-[here](https://buildozer.readthedocs.io/en/latest/installation.html#targeting-android).

-You will also need
+(from [buildozer docs](https://buildozer.readthedocs.io/en/latest/installation.html#targeting-android))
 ```sh
-python3 -m pip install colorama appdirs sh jinja2
+sudo pip install --upgrade cython==0.21
+sudo dpkg --add-architecture i386
+sudo apt-get update
+sudo apt-get install build-essential ccache git libncurses5:i386 libstdc++6:i386 libgtk2.0-0:i386 libpangox-1.0-0:i386 libpangoxft-1.0-0:i386 libidn11:i386 python2.7 python2.7-dev openjdk-8-jdk unzip zlib1g-dev zlib1g:i386
+```
+
+4.3 Download Android NDK
+```sh
+cd /opt
+wget https://dl.google.com/android/repository/android-ndk-r14b-linux-x86_64.zip
+unzip android-ndk-r14b-linux-x86_64.zip
+```
+
+## 5. Some more dependencies
+
+```sh
+python3 -m pip install colorama appdirs sh jinja2 cython==0.29
+sudo apt-get install autotools-dev autoconf libtool pkg-config python3.7
 ```


-4.3 Download the [Crystax NDK](https://www.crystax.net/en/download) manually.
-Extract into `/opt/crystax-ndk-10.3.2`
+## 6. Create the UI Atlas
+In the `electrum/gui/kivy` directory of Electrum, run `make theming`.

-
-## 5. Create the UI Atlas
-In the `gui/kivy` directory of Electrum, run `make theming`.
-
-## 6. Download Electrum dependencies
+## 7. Download Electrum dependencies
 ```sh
 sudo contrib/make_packages
 ```

-## 7. Try building the APK and fail
+## 8. Try building the APK and fail
+
+### 1. Try and fail:
+
+```sh
+contrib/make_apk
+```
+
+Symlink android tools:
+
+```sh
+ln -sf ~/.buildozer/android/platform/android-sdk-24/tools ~/.buildozer/android/platform/android-sdk-24/tools.save
+```
+
+### 2. Try and fail:

 ```sh
 contrib/make_apk
@@ -84,47 +107,43 @@ contrib/make_apk
 During this build attempt, buildozer downloaded some tools,
 e.g. those needed in the next step.

-## 8. Update the Android SDK build tools
+## 9. Update the Android SDK build tools

 ### Method 1: Using the GUI

  Start the Android SDK manager in GUI mode:
  
-    ~/.buildozer/android/platform/android-sdk-20/tools/android
+    ~/.buildozer/android/platform/android-sdk-24/tools/android

  Check the latest SDK available and install it
  ("Android SDK Tools" and "Android SDK Platform-tools").
  Close the SDK manager. Repeat until there is no newer version.
  
  Reopen the SDK manager, and install the latest build tools
-  ("Android SDK Build-tools"), 27.0.3 at the time of writing.
+  ("Android SDK Build-tools"), 28.0.3 at the time of writing.
  
+  Install "Android 9">"SDK Platform".
  Install "Android Support Repository" from the SDK manager (under "Extras").

 ### Method 2: Using the command line:

  Repeat the following command until there is nothing to install:

-    ~/.buildozer/android/platform/android-sdk-20/tools/android update sdk -u -t tools,platform-tools
+    ~/.buildozer/android/platform/android-sdk-24/tools/android update sdk -u -t tools,platform-tools

  Install Build Tools, android API 19 and Android Support Library:

-    ~/.buildozer/android/platform/android-sdk-20/tools/android update sdk -u -t build-tools-27.0.3,android-19,extra-android-m2repository
+    ~/.buildozer/android/platform/android-sdk-24/tools/android update sdk -u -t build-tools-28.0.3,android-28,extra-android-m2repository

+  (FIXME: build-tools is not getting installed?! use GUI for now.)

-## 9. Build the APK
+## 10. Build the APK

 ```sh
 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.
-Also make sure you have recent SDK tools and platform-tools

 ## 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}`
--- a/electrum/gui/kivy/tools/buildozer.spec
+++ b/electrum/gui/kivy/tools/buildozer.spec
@@ -31,7 +31,7 @@ version.filename = %(source.dir)s/electrum/version.py
 #version = 1.9.8

 # (list) Application requirements
-requirements = python3crystax==3.6, android, openssl, plyer, kivy==master, libsecp256k1
+requirements = python3, android, openssl, plyer, kivy==master, libffi, libsecp256k1

 # (str) Presplash of the application
 #presplash.filename = %(source.dir)s/gui/kivy/theming/splash.png
@@ -55,22 +55,22 @@ fullscreen = False
 android.permissions = INTERNET, WRITE_EXTERNAL_STORAGE, READ_EXTERNAL_STORAGE, CAMERA

 # (int) Android API to use
-#android.api = 14
+android.api = 28

 # (int) Minimum API required (8 = Android 2.2 devices)
-#android.minapi = 8
+android.minapi = 21

 # (int) Android SDK version to use
-#android.sdk = 21
+android.sdk = 24

 # (str) Android NDK version to use
-#android.ndk = 9
+android.ndk = 14b

 # (bool) Use --private data storage (True) or --dir public storage (False)
 android.private_storage = True

 # (str) Android NDK directory (if empty, it will be automatically downloaded.)
-android.ndk_path = /opt/crystax-ndk-10.3.2
+android.ndk_path = /opt/android-ndk-r14b

 # (str) Android SDK directory (if empty, it will be automatically downloaded.)
 #android.sdk_path =