Developers are suggested to use the KOReader emulator on linux and mac. The only reason to develop against an android emulator is to fix or enhance the platform support.

While the minimum API supported is 14 (Ice Cream Sandwitch) there's no way to test changes on anything below API17 using emulators. So please check your changes in a real device instead.

Obtaining source code, required build tools etc are described in readme :

• building-prerequisites
• getting-the-source
• for-android-devices

add emulator path to your paths (to start AVD without Android Studio):

export PATH=$PATH:'~/Android/Sdk/tools' ;

~/Android/Sdk/tools that's default path to emulator (from Android Studio)

Release APKs are not signed. You need to sign them before install. See apksigner. Debug packages are signed with AOSP test keys and are recommended for development and debugging.

./kodev release android

./kodev release --debug android

ANDROID_ARCH=x86 ./kodev release android

ANDROID_ARCH=x86 ./kodev release --debug android

Don't forget to cd platform/android/luajit-launcher && ./mk-luajit.sh clean && cd - when changing architectures.

More info: https://github.com/koreader/koreader/pull/3353

cd platform/android/luajit-launcher
make lint

emulator -avd {avd_name}

If the emulator won't start on your system, try preloading the relevant libstdc++ for your system:

LD_PRELOAD='/usr/$LIB/libstdc++.so.6' emulator -avd Nexus_5X_API_23

Note: Some emulators are broken for different reasons. Please check known working emulator at the end of this document.

./kodev run android will automatically take care of it for you, but besides installing the APK through the usual means (e.g., dragging it onto the emulator, copying it over to the device and manually installing it) you can also run ADB yourself:

adb install koreader-android-arm-linux-androideabi-{version_id}.apk

Note: You need to have adb in system path (In ubuntu sudo apt install android-tools-adb.) Emulator has to be the same architecture (ARM Koreader on ARM AVD) otherwise you will get error here complaining about inconsistent architecture.

./kodev log android or to see all android logs: adb logcat

Basic principle explained in https://mhandroid.wordpress.com/2011/01/25/how-cc-debugging-works-on-android/

See some notes on using gdb here.

Run ndk-gdb from platform/android/luajit-launcher. You'll need that in your $PATH:

export PATH=$PATH:whatever/android-ndk-r15c/prebuilt/linux-x86_64/bin

Diff to work around error:

--- android-ndk-r15c-orig/build/gmsl/__gmsl     2017-07-21 11:03:50.000000000 +0200
+++ android-ndk-r15c/build/gmsl/__gmsl  2019-01-10 21:20:16.847568638 +0100
@@ -509,7 +509,7 @@
 # Arguments: 1: A number in human-readable integer form
 # Returns:   Returns the integer encoded as a string of x's
 # ----------------------------------------------------------------------------
-int_encode = $(__gmsl_tr1)$(wordlist 1,$1,$(__gmsl_input_int))
+int_encode = $(__gmsl_tr1)$(wordlist 1,$(words $1),$(__gmsl_input_int))
 
 # The arithmetic library functions come in two forms: one form of each
 # function takes integers as arguments and the other form takes the

Without a rooted device you can't browse around in /data but you can execute commands like this:

adb exec-out run-as org.koreader.launcher ls /data/user/0/org.koreader.launcher/files/

We try to maintain compatibility with API level 14.

https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels

• https://github.com/koreader/koreader/issues/3148#issuecomment-330079180
• https://github.com/koreader/koreader/blob/master/README.md
• https://github.com/koreader/koreader/issues/3385