rockbox

mirror of https://github.com/Rockbox/rockbox.git synced 2025-10-13 10:07:38 -04:00

History

Nick Feldmann 488306e1eb android: target java 1.7 bytecode Java 17 on the host does no longer support targeting Java 1.6. This causes the build to fail. Build Tools 19.x support Java 1.7 bytecode and converts it to dex files for Android 2.2 or later, unless one uses the try-with-resources syntax which requires KitKat. Change-Id: I523746427f9ba3b60bef73fe1379b272cf048a05		2025-01-01 09:59:46 -05:00
..
.externalToolBuilders	android: Add preliminary eclipse support for building the native code, disabled by default.	2012-01-03 23:44:51 +00:00
res	Fix android SDK version and the yes/no screen title	2014-05-15 20:18:48 +10:00
src/org/rockbox	Fix android black screen crash	2014-05-21 18:39:56 +10:00
.classpath	android: Get the port up and running again	2014-03-09 18:11:35 +01:00
.project	android: Add preliminary eclipse support for building the native code, disabled by default.	2012-01-03 23:44:51 +00:00
android.make	android: target java 1.7 bytecode	2025-01-01 09:59:46 -05:00
AndroidManifest.xml	Android: Undo r30293 partly as it prevents installation.	2011-08-14 13:23:46 +00:00
ant.properties	android: Update build system for recent SDK versions and target ice cream sandwich.	2012-01-03 21:15:21 +00:00
build.xml	android: Update build system for recent SDK versions and target ice cream sandwich.	2012-01-03 21:15:21 +00:00
buildapk.sh	android: Get the port up and running again	2014-03-09 18:11:35 +01:00
installToolchain.sh	android: make installToolchains.sh work again	2025-01-01 09:59:34 -05:00
proguard.cfg	android: Update build system for recent SDK versions and target ice cream sandwich.	2012-01-03 21:15:21 +00:00
project.properties	android: Get the port up and running again	2014-03-09 18:11:35 +01:00
README	android: make installToolchains.sh work again	2025-01-01 09:59:34 -05:00

README

This folder contains the java parts needed to build an Rockbox as an
application for android.

* Prerequisites

Download and install the Android SDK[1] and NDK r10e[2], or run installToolchain.sh.
After you extracted the SDK, you need to run the SDKManager in order to
install the actual platform sdk from the available packages tab (SDK Platform
Android 4.4 should work).
In the virtual devices tab you can also setup a emulator.


Then, make sure you have the ANDROID_SDK_PATH and ANDROID_NDK_PATH (pointing to
the each's root directory) environment variables set up, otherwise configure will fail to find the compiler and
compiling the java files will fail. The installToolchain.sh script will provide reasonable values.

* Build instructions

1. Create a separate build folder. Do not build in this source directory.

2. Run "../tools/configure". Choose the "Android" target and input your
   screen resolution.

3. Run "make"

4. Run "make zip". This has to be run the first time, and any time themes
   or plugins have changed. Otherwise you may skip it.

5. Run "make apk"

6. Optional. Install on your target/emulator, using the following command:
   "$ANDROID_SDK_PATH/tools/adb install -r rockbox.apk"


[1]: https://developer.android.com/studio
[2]: https://github.com/android/ndk/wiki/Unsupported-Downloads