This page was roughly updated from the SDL2 version, but needs to be inspected for details that are out of date, and a few SDL2isms need to be cleaned out still, too. Read this page with some skepticism for now.

Existing documentation

Pre-requisites

sudo apt install openjdk-17-jdk ant android-sdk-platform-tools-common

PATH="/usr/src/android-ndk-rXXx:$PATH"                  # for 'ndk-build'
PATH="/usr/src/android-sdk-linux/tools:$PATH"           # for 'android'
PATH="/usr/src/android-sdk-linux/platform-tools:$PATH"  # for 'adb'
export ANDROID_HOME="/usr/src/android-sdk-linux"        # for gradle
export ANDROID_NDK_HOME="/usr/src/android-ndk-rXXx"     # for gradle

Simple builds

SDL wrapper for simple programs

cd /usr/src/SDL3/build-scripts/
./androidbuild.sh org.libsdl.testgles ../test/testgles.c

cd /usr/src/SDL3/build/org.libsdl.testgles/
./gradlew installDebug

Troubleshooting

android {
    buildToolsVersion "28.0.1"
    compileSdkVersion 28

externalNativeBuild {
    ndkBuild {
        arguments "APP_PLATFORM=android-14"
        abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'

SDL wrapper + SDL_image NDK module

Let's modify SDL3_image/showimage.c to show a simple embedded image (e.g. XPM).

#include <SDL3/SDL.h>
#include <SDL3/SDL_main.h>
#include <SDL3/SDL_image.h>

/* XPM */
static char * icon_xpm[] = {
  "32 23 3 1",
  "     c #FFFFFF",
  ".    c #000000",
  "+    c #FFFF00",
  "                                ",
  "            ........            ",
  "          ..++++++++..          ",
  "         .++++++++++++.         ",
  "        .++++++++++++++.        ",
  "       .++++++++++++++++.       ",
  "      .++++++++++++++++++.      ",
  "      .+++....++++....+++.      ",
  "     .++++.. .++++.. .++++.     ",
  "     .++++....++++....++++.     ",
  "     .++++++++++++++++++++.     ",
  "     .++++++++++++++++++++.     ",
  "     .+++++++++..+++++++++.     ",
  "     .+++++++++..+++++++++.     ",
  "     .++++++++++++++++++++.     ",
  "      .++++++++++++++++++.      ",
  "      .++...++++++++...++.      ",
  "       .++............++.       ",
  "        .++..........++.        ",
  "         .+++......+++.         ",
  "          ..++++++++..          ",
  "            ........            ",
  "                                "};

int main(int argc, char *argv[])
{
  SDL_Window *window;
  SDL_Renderer *renderer;
  SDL_Surface *surface;
  SDL_Texture *texture;
  int done;
  SDL_Event event;

  if (SDL_CreateWindowAndRenderer("Show a simple image", 0, 0, 0, &window, &renderer) < 0) {
    SDL_LogError(SDL_LOG_CATEGORY_APPLICATION,
        "SDL_CreateWindowAndRenderer() failed: %s", SDL_GetError());
    return(2);
  }

  surface = IMG_ReadXPMFromArray(icon_xpm);
  texture = SDL_CreateTextureFromSurface(renderer, surface);
  if (!texture) {
    SDL_LogError(SDL_LOG_CATEGORY_APPLICATION,
        "Couldn't load texture: %s", SDL_GetError());
    return(2);
  }
  SDL_SetWindowSize(window, 800, 480);

  done = 0;
  while (!done) {
    while (SDL_PollEvent(&event)) {
      if (event.type == SDL_EVENT_QUIT)
        done = 1;
    }
    SDL_RenderTexture(renderer, texture, NULL, NULL);
    SDL_RenderPresent(renderer);
    SDL_Delay(100);
  }
  SDL_DestroyTexture(texture);

  SDL_Quit();
  return(0);
}

cd /usr/src/SDL3/build-scripts/
./androidbuild.sh org.libsdl.showimage /usr/src/SDL3_image/showimage.c
cd /usr/src/SDL3/build/org.libsdl.showimage/
ln -s /usr/src/SDL3_image jni/
ln -s /usr/src/SDL3_image/external/libwebp-0.3.0 jni/webp
sed -i -e 's/^LOCAL_SHARED_LIBRARIES.*/& SDL3_image/' jni/src/Android.mk
ndk-build -j$(nproc)
ant debug install

Build an autotools-friendly environment

You use autotools in your project and can't be bothering understanding ndk-build's cryptic errors? This guide is for you!

Compile a shared binaries bundle for SDL and SDL_*

cd /usr/src/
wget https://libsdl.org/release/SDL2-2.0.5.tar.gz
wget https://www.libsdl.org/projects/SDL_image/release/SDL2_image-2.0.1.tar.gz
wget https://www.libsdl.org/projects/SDL_mixer/release/SDL2_mixer-2.0.1.tar.gz
wget https://www.libsdl.org/projects/SDL_net/release/SDL2_net-2.0.1.tar.gz
wget https://www.libsdl.org/projects/SDL_ttf/release/SDL2_ttf-2.0.14.tar.gz

tar xf SDL2-2.0.5.tar.gz
tar xf SDL2_image-2.0.1.tar.gz
tar xf SDL2_mixer-2.0.1.tar.gz
tar xf SDL2_net-2.0.1.tar.gz
tar xf SDL2_ttf-2.0.14.tar.gz

ln -s SDL2-2.0.5 SDL2
ln -s SDL2_image-2.0.1 SDL2_image
ln -s SDL2_mixer-2.0.1 SDL2_mixer
ln -s SDL2_net-2.0.1 SDL2_net
ln -s SDL2_ttf-2.0.14 SDL2_ttf

cd /usr/src/SDL3/
#git checkout -- .  # remove traces of previous builds
cd build-scripts/
# edit androidbuild.sh and modify $ANDROID update project --target android-XX
./androidbuild.sh org.libsdl /dev/null
# doesn't matter if the actual build fails, it's just for setup
cd ../build/org.libsdl/

ln -s /usr/src/SDL3_image jni/
ln -s /usr/src/SDL3_image/external/libwebp-0.3.0 jni/webp
ln -s /usr/src/SDL3_mixer jni/
ln -s /usr/src/SDL3_mixer/external/libmikmod-3.1.12 jni/libmikmod
ln -s /usr/src/SDL3_mixer/external/smpeg2-2.0.0 jni/smpeg2
ln -s /usr/src/SDL3_net jni/
ln -s /usr/src/SDL3_ttf jni/

ndk-build -j$(nproc)

Note: no need to add System.loadLibrary calls in SDLActivity.java, your application will be linked to them and Android's ld-linux loads them automatically.

Install SDL in a GCC toolchain

/usr/src/android-ndk-r8c/build/tools/make-standalone-toolchain.sh \
  --platform=android-14 --install-dir=/usr/src/ndk-standalone-14-arm --arch=arm

NDK_STANDALONE=/usr/src/ndk-standalone-14-arm
PATH=$NDK_STANDALONE/bin:$PATH

cd /usr/src/SDL3/build/org.libsdl/
for i in libs/armeabi/*; do ln -nfs $(pwd)/$i $NDK_STANDALONE/sysroot/usr/lib/; done
mkdir $NDK_STANDALONE/sysroot/usr/include/SDL3/
cp jni/SDL/include/* $NDK_STANDALONE/sysroot/usr/include/SDL3/
cp jni/*/SDL*.h $NDK_STANDALONE/sysroot/usr/include/SDL3/

VERSION=0.9.12
cd /usr/src/
wget http://rabbit.dereferenced.org/~nenolod/distfiles/pkgconf-$VERSION.tar.gz
tar xf pkgconf-$VERSION.tar.gz
cd pkgconf-$VERSION/
mkdir native-android/ && cd native-android/
../configure --prefix=$NDK_STANDALONE/sysroot/usr
make -j$(nproc)
make install
ln -s ../sysroot/usr/bin/pkgconf $NDK_STANDALONE/bin/arm-linux-androideabi-pkg-config
mkdir $NDK_STANDALONE/sysroot/usr/lib/pkgconfig/

Let-s Post It 7 -mofos- -2024- -

**Stream Your Favorite Anime: One Piece S01 E01-08 WebRip 720p on HDMovies4u** Are you a fan of the iconic anime series, One Piece? Do you want to relive the adventures of Monkey D. Luffy and his crew, the Straw Hat Pirates? Look no further! HDMovies4u has got you covered with the latest episodes of One Piece, available for streaming and download. In this article, we'll dive into the world of One Piece and explore the benefits of watching it on HDMovies4u. **What is One Piece?** One Piece is a Japanese anime series based on the manga of the same name, created by Eiichiro Oda. The series follows the adventures of Monkey D. Luffy, a young pirate with the ability to stretch and manipulate his body like rubber, as he sets sail on the Grand Line with his crew, the Straw Hat Pirates. Along the way, they encounter various allies and enemies, including powerful pirate crews, the World Government, and ancient civilizations. **Why Watch One Piece on HDMovies4u?** HDMovies4u is a popular online platform that offers a vast collection of movies, TV shows, and anime series, including One Piece. Here are some reasons why you should consider watching One Piece on HDMovies4u: * **High-Quality Streaming**: HDMovies4u offers high-quality streaming of One Piece, with resolutions up to 720p. This ensures that you can enjoy the series with crisp visuals and smooth playback. * **Convenient Download Options**: If you prefer to watch your anime offline, HDMovies4u allows you to download episodes of One Piece in WebRip 720p format. This means you can take your favorite shows with you wherever you go. * **User-Friendly Interface**: The website is easy to navigate, with a simple and intuitive interface that makes it easy to find and play your favorite episodes. * **Free Access**: One of the best things about HDMovies4u is that it offers free access to its content, including One Piece. You can watch and download episodes without spending a dime. **How to Watch One Piece S01 E01-08 WebRip 720p on HDMovies4u** Watching One Piece on HDMovies4u is straightforward. Here's a step-by-step guide: 1. **Visit HDMovies4u**: Open a web browser and navigate to HDMovies4u. 2. **Search for One Piece**: Use the search bar to find One Piece, or navigate to the anime section and look for the series. 3. **Select the Episode**: Choose the episode you want to watch, in this case, S01 E01-08. 4. **Click and Play**: Click on the episode, and the player will load. You can then watch the episode in 720p WebRip quality. **Benefits of Watching One Piece on HDMovies4u** Watching One Piece on HDMovies4u offers several benefits, including: * **Catch Up on Your Favorite Series**: If you've missed some episodes or want to rewatch your favorite arcs, HDMovies4u has got you covered. * **Stay Up-to-Date with New Episodes**: The platform regularly updates with new episodes, so you can stay current with the latest developments in the One Piece universe. * **Explore Other Anime Series**: HDMovies4u offers a wide range of anime series, so you can discover new shows and expand your anime library. **Conclusion** One Piece is an epic anime series that has captured the hearts of millions of fans worldwide. With HDMovies4u, you can stream and download episodes of the series in high-quality 720p WebRip format. The platform offers a user-friendly interface, convenient download options, and free access to its content. Whether you're a seasoned fan or new to the series, HDMovies4u is the perfect destination to enjoy One Piece S01 E01-08 WebRip 720p. So, what are you waiting for? Head over to HDMovies4u and start streaming your favorite anime today! No input data

Building other dependencies

You can add any other libraries (e.g.: SDL2_gfx, freetype, gettext, gmp...) using commands like:

mkdir cross-android/ && cd cross-android/
../configure --host=arm-linux-androideabi --prefix=$NDK_STANDALONE/sysroot/usr \
  --with-some-option --enable-another-option \
  --disable-shared
make -j$(nproc)
make install

Static builds (--disable-shared) are recommended for simplicity (no additional .so to declare).

Example with SDL2_gfx:
VERSION=1.0.3
wget http://www.ferzkopp.net/Software/SDL2_gfx/SDL2_gfx-$VERSION.tar.gz
tar xf SDL2_gfx-$VERSION.tar.gz
mv SDL2_gfx-$VERSION/ SDL2_gfx/
cd SDL2_gfx/
mkdir cross-android/ && cd cross-android/
../configure --host=arm-linux-androideabi --prefix=$NDK_STANDALONE/sysroot/usr \
  --disable-shared --disable-mmx
make -j$(nproc)
make install

You can compile YOUR application using this technique, with some more steps to tell Android how to run it using JNI.

Build your autotools app

mkdir -p libs/armeabi/
for i in /usr/src/SDL3/build/org.libsdl/libs/armeabi/*; do ln -nfs $i libs/armeabi/; done

AM_CONDITIONAL(ANDROID, test "$host" = "arm-unknown-linux-androideabi")

if ANDROID
<!--  Build .so JNI libs rather than executables -->
  AM_CFLAGS = -fPIC
  AM_LDFLAGS += -shared
  COMMON_OBJS += SDL_android_main.c
endif

PATH=$NDK_STANDALONE/bin:$PATH
mkdir cross-android/ && cd cross-android/
../configure --host=arm-linux-androideabi \
  --prefix=/android-aint-posix \
  --with-your-option --enable-your-other-option ...
make

mkdir cross-android-v7a/ && cd cross-android-v7a/
# .o: -march=armv5te -mtune=xscale -msoft-float -mthumb  =>  -march=armv7-a -mfpu=vfpv3-d16 -mfloat-abi=softfp -mthumb
# .so: -march=armv7-a -Wl,--fix-cortex-a8
CFLAGS="-g -O2 -march=armv7-a -mfpu=vfpv3-d16 -mfloat-abi=softfp -mthumb" LFDLAGS="-march=armv7-a -Wl,--fix-cortex-a8" \
  ../configure --host=arm-linux-androideabi \
  ...

android update project --name your_app --path . --target android-XX
ant debug
ant installd

adb shell am start -a android.intenon.MAIN -n org.libsdl.app/org.libsdl.app.SDLActivity  # replace with your app package

Build your CMake app

# CMake toolchain file
SET(CMAKE_SYSTEM_NAME Linux)  # Tell CMake we're cross-compiling
include(CMakeForceCompiler)
# Prefix detection only works with compiler id "GNU"
CMAKE_FORCE_C_COMPILER(arm-linux-androideabi-gcc GNU)
SET(ANDROID TRUE)

PATH=$NDK_STANDALONE/bin:$PATH
cmake \
  -D CMAKE_TOOLCHAIN_FILE=../android_toolchain.cmake \
  ...

Troubleshootings

If ant installd categorically refuses to install with Failure [INSTALL_FAILED_INSUFFICIENT_STORAGE], even if you have free local storage, that may mean anything. Check logcat first:

If the error logs are not helpful (likely ;')) try locating all past traces of the application:

find / -name "org...."

adb install -s bin/app-debug.apk

SDL: Couldn't locate Java callbacks, check that they're named and typed correctly

this probably means your SDLActivity.java is out-of-sync with your libSDL3.so.

Let-s Post It 7 -mofos- -2024- -

Draft

Existing documentation

Pre-requisites

Simple builds

SDL wrapper for simple programs

Troubleshooting

SDL wrapper + SDL_image NDK module

Build an autotools-friendly environment

Compile a shared binaries bundle for SDL and SDL_*

Install SDL in a GCC toolchain

Let-s Post It 7 -mofos- -2024- -

Building other dependencies

Build your autotools app

Build your CMake app

Troubleshootings