Difference between revisions of "Android"

From Minetest Developer Wiki
Jump to navigation Jump to search
m
 
(43 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<big><big><big>'''This page is about the WIP Android port by [[User:Sfan5|sfan5]], not about the official port'''</big></big></big>
+
= Building Android =
  
= Building and Running =
+
See https://github.com/minetest/minetest/blob/master/doc/README.android
== Building ==
 
What you need:
 
* Linux
 
* Android NDK
 
* standalone toolchain made with Android NDK (with <code>android_native_app_glue.h</code> copied into <code><TOOLCHAIN_ROOT>/sysroot/usr/include</code>)
 
:* You need to use clang as gcc produces broken code
 
* Android SDK
 
* Android device
 
* Git
 
* CMake
 
* Ant
 
* ADB (optional but very useful)
 
=== Irrlicht ===
 
Clone <code>https://github.com/sfan5/irrlicht-android</code>.
 
 
 
Make sure you have arm-linux-androideabi-gcc ''(It's ok to use gcc for Irrlicht)'' and arm-linux-androideabi-g++ usable and run <code>make</code> in <code>source/Irrlicht</code>.
 
 
 
This will build Irrlicht as static and shared library and place it in <code>lib/Linux</code>
 
 
 
=== Minetest ===
 
Clone <code>https://github.com/sfan5/minetest</code> and switch to the <code>android_new</code> branch.
 
Configure it using CMake like this:
 
<pre>
 
$ cmake . \
 
    -DCMAKE_C_COMPILER=`which arm-linux-androideabi-clang` \
 
    -DCMAKE_CXX_COMPILER=`which arm-linux-androideabi-clang++` \
 
    -DCMAKE_FIND_ROOT_PATH=<sysroot of your android toolchain> \
 
    -DCMAKE_FIND_ROOT_PATH_MODE_INCLUDE=ONLY \
 
    -DCMAKE_FIND_ROOT_PATH_MODE_LIBRARY=ONLY \
 
    -DCMAKE_FIND_ROOT_PATH_MODE_PROGRAM=BOTH \
 
    -DCMAKE_SYSTEM_NAME=Linux \
 
    -DIRRLICHT_LIBRARY=<path to libIrrlicht.a> \
 
    -DIRRLICHT_INCLUDE_DIR=<path to include/ of Irrlicht> \
 
    -DANDROID=1 \
 
    -DANDROID_SUPPORT_LIBRARY=<path to libandroid_support.a> \
 
    -DANDROID_SUPPORT_INCLUDE_DIR=<patch to <NDK_DIR>/source/android/support/include> \
 
    -DRUN_IN_PLACE=1
 
</pre>
 
Now just enter <code>make package</code>.
 
After make is done go into the <code>Android</code> directory and run <code><SDK_DIR>/tools/android update project --path .</code>.
 
 
 
Then copy the .so using <code><NDK_DIR>/ndk-build</code> and build the apk using <code>ant debug</code>.
 
 
 
You will then have the resources in minetest-''x.x.x''.tar.gz and the apk at <code>Android/bin/Minetest-debug.apk</code>.
 
You will only need to do the "android update project" step once.
 
== Running ==
 
For this step you need minetest-''x.x.x''.tar.gz and Minetest-debug.apk from the previous step.
 
 
 
Put all resource files & folders (builtin, client, ...) into <code>/sdcard/minetest</code> on your Android device.
 
Install <code>Minetest-debug.apk</code>.
 
 
 
Now touch the Minetest icon and the lovely main menu should appear. ;-)
 
 
 
= Dev Notes =
 
== General notes ==
 
* cURL does not work
 
:* TLS support is needed too
 
::* Idea: Use GnuTLS or LibreSSL, because OpenSSL is a nightmare to cross-compile and its code is shit<ref name="openssl-sucks>http://opensslrampage.org/</ref>
 
* Add Bluetooth support for local multiplayer (maybe)
 
:* see (http://people.csail.mit.edu/albert/bluez-intro/x559.html or http://people.csail.mit.edu/albert/bluez-intro/x502.html) and https://github.com/sfan5/minetest/tree/bluetooth
 
* OpenAL with Android support: https://github.com/AerialX/openal-soft-android
 
== Getting stuff to work without libCrystax ==
 
* Frequently crashes after going through <code>std::ios_base::~ios_base()</code>
 
:* Probably related to removal of libCrystax
 
* Pressing a button now roughly equals taking away a wood piece of a unstable Jenga tower
 
* Options:
 
:* use libc++
 
::* currently a problem with includes
 
:* avoid destructing any streams
 
::* This is not a good idea
 
:* Go back to Crystax toolchain
 
::* uhh... no!
 
 
 
 
 
References:
 
<references/>
 

Latest revision as of 19:42, 18 June 2022