Android Studio maven repository for Allegro 5
Switch branches/tags
Nothing to show
Clone or download
Failed to load latest commit information. Update Mar 2, 2018 don't build for MIPS by default Nov 17, 2017

To use the Allegro Android binaries from Android Studio 2 or 3:

  1. Create a new Android Studio NDK project
  • Use "Start a new Android Studio project" from the welcome dialog or File->New from the menu
  • Check the "Include C++ support" checkbox on the first dialog
  • Leave minimum SDK at 15 on the second dialog
  • Pick "Empty Activity" on the next one
  • Keep "Generate Layout" and "Backwards Compatibility" checked
  • Leave the C++ settings at their defaults
  • Click "Finish"

Android Studio will create these files in your new project's folder (among others):

  • app/src/main/java/.../
  • app/src/main/cpp/native-lib.cpp
  • app/build.gradle
  • app/CMakeLists.txt

Run your project, just to make sure everything works right in your Android Studio installation and with your emulator and/or test device. The test program will display a text which comes from the native library.

  1. In your app/build.gradle, inside of dependencies {}, add this:
implementation 'org.liballeg:allegro5-release:'

or this for Android Studio 2:

compile 'org.liballeg:allegro5-release:'

In Android Studio in the "Android" view this file will be under "Gradle Scripts".

(you can also use -debug instead of -release to use a debug version of Allegro)

Sync your project (Tools->Android). This will make Android Studio download the .aar file from here:

Make sure to build and run your project after this. (It will force Android Studio to unpack the .aar file after downloading it.) It should run the sample project again, unmodified from step 1.

If you prefer, you can remove the implementation/compile line and download the .aar yourself and open with any zip program. Then copy the .jar and .so and .h files to where Android Studio can find them. Right now the .h files live in the "assets" folder which means they get distributed with the .apk, which wastes (a small bit of) space.

  1. In your CMakeLists.txt (under External Build Files in Android Studio), add this to the end and sync:
set(NATIVE_LIB native-lib)
set(JNI_FOLDER ../../../transforms/stripDebugSymbol/debug/0/lib)

Android Studio slightly changes that path from version to version though (search your app/build folder for the location of allegro.cmake if neither works, or see above about manually unpacking the .aar).

Note: If you get an error message about allegro.cmake not being found (or just about cmake failing) - remove those three lines and do a rebuild (which will fail because it cannot find the Allegro headers). Then re-add those three lines and re-build again. This is because Android-Studio may not have unpacked the .aar file with allegro.cmake in it yet on the first run.

  1. Modify app/src/main/java/.../ like this: (Keep the original package name in the first line.)
public class MainActivity extends AllegroActivity {
    static {
    public MainActivity() {

(if you used the debug version above, the libraries will be called "allegro-debug" and so on)

  1. Replace app/src/main/native-lib.cpp with your game's C/C++ code, using Allegro. Use app/CMakeLists.txt to list all of your C/C++ source files and extra dependencies. Hit Run in Android Studio and it will deploy and run your Allegro game on the emulator or actual devices. Build an .apk and upload it to the store and it will just work!

To test that everything works you can initially just paste the following code into the existing native-lib.cpp. It creates a display then fades it from red to yellow every second.

 #include <allegro5/allegro5.h>

 int main(int argc, char **argv) {
     auto display = al_create_display(0, 0);
     auto queue = al_create_event_queue();
     auto timer = al_create_timer(1 / 60.0);
     auto redraw = true;
     al_register_event_source(queue, al_get_display_event_source(display));
     al_register_event_source(queue, al_get_timer_event_source(timer));
     while (true) {
         if (redraw) {
             al_clear_to_color(al_map_rgb_f(1, al_get_time() - (int)(al_get_time()), 0));
             redraw = false;
         ALLEGRO_EVENT event;
         al_wait_for_event(queue, &event);
         if (event.type == ALLEGRO_EVENT_TIMER) {
             redraw = true;
     return 0;
  1. Fine-tuning
  • You can move the assets/*/include folders somewhere else if you don't want them to be in your final .apk
  • If you don't want to compile all the architectures for your game, you can do something like this in your app/build.gradle:
    buildTypes {
      debug { 
         ndk {
           abiFilters "x86", "armeabi-v7a", "armeabi"
  • You will want to modify AndroidManifest.xml to have this attribute for the <activity> element or Allegro will crash: