Fix Quest launch crashes, version the APK like the tarball, and support native builds in Android Studio
build / build (push) Successful in 2m13s

- patchelf gl4es's embedded SONAME to libGL.so so AGP's jniLibs packaging
  (which drops any file not literally named "*.so") and the dynamic
  linker's NEEDED-entry resolution (by embedded SONAME, not filename)
  finally agree - fixes the "library \"libGL.so.1\" not found" crash seen
  on real Quest hardware.
- QuestShockActivity now checks that res/data and res/sound exist before
  starting the native engine, showing an explanatory dialog instead of
  crashing on init_popups' unchecked NULL resource load when a fresh
  install has no game data copied in yet.
- dist/questshock-<version>-android-arm64.apk is now versioned from the
  same git-tag-or-dev-placeholder scheme as the desktop tarball
  (build-image/version.sh, shared by both via the Makefile and
  build-apk.sh).
- build-image/prepare-android-project.sh (prep logic extracted out of
  build-apk.sh) can now stage android/ for a native build directly in
  Android Studio (--host-paths), exporting the prebuilt SDL2/SDL2_mixer/
  fluidsynth-lite/gl4es libraries and writing host-resolvable paths,
  instead of only ever building inside the Docker image.
- Corrected GET_ASSETS.txt/GET_ASSETS_QUEST.txt, which wrongly described
  merging res/pc/hd and res/pc/cdrom trees out of the raw installer's
  sshock.kpf - an already-installed copy's res/data res/sound can just
  be copied directly, with extract_assets.sh only needed from the raw
  installer.
This commit is contained in:
ml
2026-07-23 06:42:45 +02:00
parent 3da137da09
commit ac640762d7
14 changed files with 304 additions and 100 deletions
+19 -43
View File
@@ -1,9 +1,9 @@
#!/usr/bin/env bash
# Builds the Quest APK from a scratch, patched copy of engine/ (see
# android/engine-patches/ - engine/ itself is never modified) plus the
# Android SDL2/SDL2_mixer/fluidsynth-lite prebuilt into this image at
# /opt/prebuilt/android/*. Run via ../run-image.sh (or directly, if
# already inside this image - see the Makefile's `apk` target).
# Builds the Quest APK - see build-image/prepare-android-project.sh (which
# this calls) for how android/ gets a scratch, patched copy of engine/,
# the Android SDL2/SDL2_mixer/fluidsynth-lite/gl4es prebuilts, and bundled
# assets staged in. Run via ../run-image.sh (or directly, if already
# inside this image - see the Makefile's `apk` target).
#
# Unlike build-engine.sh, this step needs network access: Gradle/AGP's
# own dependency resolution isn't prebuilt into the image (see
@@ -12,53 +12,29 @@ set -euo pipefail
REPO_ROOT="$(pwd)"
ANDROID_DIR="$REPO_ROOT/android"
SCRATCH_ENGINE="$REPO_ROOT/build/android-engine"
echo "== Preparing a scratch, patched copy of engine/ =="
rm -rf "$SCRATCH_ENGINE"
mkdir -p "$(dirname "$SCRATCH_ENGINE")"
cp -a "$REPO_ROOT/engine" "$SCRATCH_ENGINE"
for p in "$ANDROID_DIR"/engine-patches/*.patch; do
patch -p1 -d "$SCRATCH_ENGINE" < "$p"
done
bash "$REPO_ROOT/build-image/prepare-android-project.sh"
echo "== Wiring up prebuilt Android SDL2_mixer/fluidsynth-lite (BUNDLED mode, like the desktop build) =="
mkdir -p "$SCRATCH_ENGINE/build_ext/built_sdl_mixer" "$SCRATCH_ENGINE/build_ext/fluidsynth-lite"
cp -a /opt/prebuilt/android/sdl2_mixer/. "$SCRATCH_ENGINE/build_ext/built_sdl_mixer/"
mkdir -p "$SCRATCH_ENGINE/build_ext/fluidsynth-lite/src"
cp -a /opt/prebuilt/android/fluidsynth-lite/lib/. "$SCRATCH_ENGINE/build_ext/fluidsynth-lite/src/"
cp -a /opt/prebuilt/android/fluidsynth-lite/include/. "$SCRATCH_ENGINE/build_ext/fluidsynth-lite/include/"
echo "engineDir=$SCRATCH_ENGINE" > "$ANDROID_DIR/engine.properties"
echo "== Staging bundled assets (shaders, soundfont, get-assets text) =="
ASSETS_DIR="$ANDROID_DIR/app/src/main/assets"
rm -rf "$ASSETS_DIR"
mkdir -p "$ASSETS_DIR/shaders" "$ASSETS_DIR/res"
# GLES ports of engine/shaders/ (see android/gles-shaders/ and
# android/engine-patches/04-android-opengl-es-render.patch) - not
# engine/shaders/ itself, which is desktop-only GLSL.
cp -a "$ANDROID_DIR/gles-shaders/." "$ASSETS_DIR/shaders/"
cp "/opt/prebuilt/soundfont/default.sf2" "$ASSETS_DIR/res/soundfont.sf2"
cp "$REPO_ROOT/res/assets/GET_ASSETS_QUEST.txt" "$ASSETS_DIR/GET_ASSETS_QUEST.txt"
echo "== Staging prebuilt Android SDL2/SDL2_mixer/fluidsynth-lite/gl4es .so's into jniLibs =="
JNI_LIBS_DIR="$ANDROID_DIR/app/src/main/jniLibs/arm64-v8a"
rm -rf "$ANDROID_DIR/app/src/main/jniLibs"
mkdir -p "$JNI_LIBS_DIR"
find /opt/prebuilt/android/sdl2/lib /opt/prebuilt/android/sdl2_mixer/lib /opt/prebuilt/android/fluidsynth-lite/lib \
/opt/prebuilt/android/gl4es/lib \
-name '*.so' -exec cp -a {} "$JNI_LIBS_DIR/" \;
echo "== Determining version (shared with 'make package', see build-image/version.sh) =="
git config --global --add safe.directory "$REPO_ROOT" 2>/dev/null || true
VERSION="$("$REPO_ROOT/build-image/version.sh")"
# versionName (VERSION, above) can be anything, but Android's versionCode
# must be a positive, monotonically-increasing integer - the commit count
# is a simple, deterministic stand-in for that.
VERSION_CODE="$(git -C "$REPO_ROOT" rev-list --count HEAD)"
echo "Version: $VERSION (versionCode $VERSION_CODE)"
echo "== Building the APK (gradlew assembleDebug) =="
cd "$ANDROID_DIR"
./gradlew --no-daemon assembleDebug
./gradlew --no-daemon assembleDebug \
"-PquestshockVersionName=$VERSION" "-PquestshockVersionCode=$VERSION_CODE"
APK="$ANDROID_DIR/app/build/outputs/apk/debug/app-debug.apk"
[ -f "$APK" ] || { echo "BUILD FAIL: $APK not found after assembleDebug" >&2; exit 1; }
mkdir -p "$REPO_ROOT/dist"
cp "$APK" "$REPO_ROOT/dist/questshock-debug.apk"
PKG_NAME="questshock-$VERSION-android-arm64.apk"
cp "$APK" "$REPO_ROOT/dist/$PKG_NAME"
echo "== Done =="
echo "APK: $REPO_ROOT/dist/questshock-debug.apk"
echo "APK: $REPO_ROOT/dist/$PKG_NAME"