subsurface/packaging/android
Dirk Hohndel 006d630142 build-system/Android: add missing install-qt.sh
This file is copied from the QBS project. It's under LGPL and therefore
compatible with our licensing. While it would be possible to retrieve
this file at build time from the original project, for now it seemed
easier to include it in our repo.

Signed-off-by: Dirk Hohndel <dirk@hohndel.org>
2020-04-27 11:04:29 -07:00
..
.gitignore Import subsurface-android build script 2015-03-09 12:53:01 -07:00
android-build-wrapper.sh GitHub Actions: use the Qt 5.13.2 based Android build container 2020-04-25 13:18:41 -07:00
build.sh build-system/android: remove libusb at QTest 2020-04-25 13:18:41 -07:00
install-qt.sh build-system/Android: add missing install-qt.sh 2020-04-27 11:04:29 -07:00
qt-installer-noninteractive.qs builld-system: switch Android to Qt 5.13.1 2019-10-05 08:19:31 -07:00
README cleanup: fix image reference in Android README 2020-04-18 17:38:09 -07:00
variables.sh build-system/Android: update some dependency versions 2020-04-25 13:18:41 -07:00
warning-ndk18b.txt Android build: add explanation for huge hack 2018-12-30 11:20:34 -08:00

Tool repo to crosscompile subsurface to android-arm
---------------------------------------------------

Dependencies:

1. android_sdk, android_ndk and Qt for android. See step 0.
2. cmake
3. ant
4. Java JDK
5. working adb is recommended
6. dependencies of libdivecomputer and subsurface -
   visit http://subsurface.hohndel.org/documentation/building/

By far the easiest way to do this is using the Android build container which is
used to create the official builds. That has all the dependencies ready and
makes things a lot easier.

Run the docker image: docker://subsurface/android-builder:5.13.10

Check out the sources inside the container, make sure the following links
are available in parallel to the source directory

        ln -s /android/Qt .
        ln -s /android/android-ndk-r18b .
        ln -s /android/android-sdk-linux .

and run the build wrapper from the directory above the source directory

        bash -x subsurface/packaging/android/android-build-wrapper.sh

This should create a pair of unsigned but otherwise working APKs (for 32 and 64
bit ARM).

Alternatively, steps to install using your own Linux machine:

Step 0.
Grab..
Android ndk from: http://developer.android.com/tools/sdk/ndk/index.html
Android sdk from: http://developer.android.com/sdk/index.html#download
And QT for android from: http://qt-project.org/downloads

Step 1.
Extract and install these into known directories.
Have a look in the top of build.sh for where the cross build tool expects
them. By default thats is: ../../../android-ndk-r9d ../../../android-sdk-linux
and ../../../Qt/5.5 (or Qt/5.6)

Step 2.
Run bash build.sh in the terminal. By default it builds for arm but you
can pass x86 as first arg to build.sh to have it build for x86. Nice when
debugging in a fast emulator.
The script will download and build the whole dependency chain.

After this, subsurface will be built for android.

The output folder is subsurface-build-arm/android_build and your newly
created apk shows up as:
subsurface-build-arm/android_build/bin/QtApp-debug.apk

Where the x86 apk shows up when built for x86 is left as a exercise for the
reader.