Commit d3696b0c authored by Mathias Jud's avatar Mathias Jud

Documentation: Android update

parent c727184f
Android Instructions
====================
Compatibility
-------------
quul.net has been tested on the following devices:
| Device | 2.3 | 4.x | CM9 |
| ----------------- | --- | --- | --- |
| Samsung Galaxy S2 | Y | N | N |
| HTC Sensation | ? | Y | Y |
| fairphone | ? | Y | ? |
Legend:
* Y = it works
* N = it doesn't work yet
* ? = it wasn't tested yet
Problems & Solutions:
* qaul.net needs the IBSS/Ad-hoc wifi mode. This Wifi-Standard mode was
removed by google.
* On Android < 4.x IBSS mode can be activated via the wext (wireless
extensions).
Some vendors ship also their 4.x devices with wext.
* On Android >= 4 IBSS mode can be activated on some devices via
wpa_supplicant.
* qaul.net needs ARM and Android > 2.3 Gingerbread
(due to before unsupported pthread functions in pjsip).
* The Android device needs to be rooted.
To check wheter your Android Device is known to work with qaul.net check
[README_Android_Devices.md]
Prerequisites
......@@ -41,39 +13,42 @@ Prerequisites
For building the Android version of qaul.net you will need both the Source
Develpment Kit *and* the Native Development Kit
Get the NDK https://developer.android.com/tools/sdk/ndk/index.html
Get the SDK https://developer.android.com/sdk/index.html
* Get the NDK https://developer.android.com/tools/sdk/ndk/index.html
* Get the SDK https://developer.android.com/sdk/index.html
Add `sdk` to `path` if the installer had not done it automatically.
### Needed extra libraries
1. Create directory for extra libs
2. `cd` into it
adb pull /system/lib/libcutils.so
adb pull /system/lib/libwpa_client.so
adb pull /system/bin/ifconfig
adb pull /system/bin/iptables
Get the source
--------------
Download the source from <insert source here> or
get the sources from github: git clone https://github.com/WachterJud/qaul.net.git
Download the source from [https://github.com/WachterJud/qaul.net-ng](github)
git clone https://github.com/WachterJud/qaul.net-ng.git
Build
-----
mkdir builddir
cd builddir
# create a build directory in your qaul.net source directory
mkdir build
cd build
# The compiler needs some libraries in the build directory
# Connect your Android device to your computer and pull the libraries
# from your device to your build directory:
adb pull /system/lib/libcutils.so
adb pull /system/lib/libwpa_client.so
adb pull /system/bin/ifconfig
adb pull /system/bin/iptables
# build the qaul.net Android app
cmake ../ -DPORT=Android -DNDK_ROOT=/path/to/ndk -DEXTRALIB_PATH=./
make
cmake ../path/to/source -DPORT=Android -DNDK_ROOT=/path/to/ndk -DEXTRALIB_PATH=/path/to/extra/lib
make
You will find the newly built apk in `android/bin`.
......
Android Device Compatibility
============================
Requirements
------------
* qaul.net requires the android devices to be rooted!
* qaul.net needs the IBSS/Ad-hoc wifi mode. This Wifi-Standard mode was
removed by google.
* On Android < 4.x IBSS mode can be activated via the wext (wireless
extensions).
Some vendors ship also their 4.x devices with wext.
* On Android >= 4 IBSS mode can be activated on some devices via
wpa_supplicant.
* qaul.net needs ARM and Android > 2.3 Gingerbread
(due to before unsupported pthread functions in pjsip).
* The Android device needs to be rooted.
Device Compatibility List
-------------------------
quul.net has been tested on the following devices:
| Device | 2.3 | 4.x | CM9 |
| ----------------- | --- | --- | --- |
| Samsung Galaxy S2 | Y | N | N |
| HTC Sensation | ? | Y | Y |
| fairphone | ? | Y | ? |
Legend:
* Y = it works
* N = it doesn't work yet
* ? = it wasn't tested yet
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment