- ios/build.sh builds static SDL3 + FreeType, then the .app (code only, embedded Python); signs ad hoc and runs on a simulator, or signs with a development profile and installs with devicectl (device path untested). Simulator-only SDL patch: accept the simulator Metal device for SDL_GPU. - ios/Info.plist.in: landscape, full screen, launch screen, file sharing. - Data dir is Documents on iOS; ios/push_assets.py stages the client root lower-cased (iOS is case-sensitive, the client opens lower-cased paths) and copies it into the app container. - EffectData path normalisation folds A-Z like the effect cache key. - android/push_assets.py: test-rundir base layer + svside/, which the game phase needs (also fixes Android); --lowercase (ASCII only). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
AVA2 Android client
Gradle project for the arm64-v8a APK: SDL3 SDLActivity + libmain.so (the client, with the
embedded CPython 2.7). The APK holds code only. Game data (ymir work, maps, sound, python-root,
python27.zip) lives in the app's external files directory, see below.
Architecture and roadmap: docs/MOBILE-ARCHITECTURE.md.
Requirements
- Android SDK with platform 35, NDK 27.2.12479018 and CMake 3.22.1 (
sdkmanager "ndk;27.2.12479018" "cmake;3.22.1") - JDK 17+ (
brew install openjdk@21;build.shfinds it automatically) - The SDK checkout beside this repository (
../sdk), as for the desktop build
Build
android/build.sh # debug APK; installs and launches it when a phone is attached
android/build.sh release # release APK
android/build.sh deps # only build SDL3 + FreeType into build/android-deps
The first run downloads and builds SDL3 and FreeType once into build/android-deps. The SDL
Java sources are copied from the same SDL release so they always match libSDL3.so. The debug
APK compiles C++ as RelWithDebInfo; a Debug build is too slow to judge frame rate.
Overrides: ANDROID_HOME, ANDROID_NDK_HOME, JAVA_HOME, AVA2_SDK_ROOT, AVA2_SOURCE_DIR
(CMake source tree to build instead of this checkout), ADB_SERIAL.
Android Studio can open this directory after android/build.sh deps has run once.
Game data on the phone
android/push_assets.py # after android/build.sh, with the phone attached
Stages assets/loose + upstream/python-root (scripts win) + python27.zip as hard links in
build/android-data/root and sends them with adb push --sync to
/sdcard/Android/data/com.metin2.ava2/files, where the client starts. The first push moves
about 2.9 GB; later pushes only send changed files. The three assets/loose symlinks into the
decoded pack_maker tree are remapped to --pack-maker (default ../AVA2/TEST/1. Client DEV/pack_maker).
Uninstalling the app deletes this directory.
Running the desktop client inside build/android-data/root exercises the same flattened layout.
Logs: adb logcat -s SDL SDL/APP AndroidRuntime DEBUG.