Files
AVA2/android/README.md
T
shenleiandClaude Opus 5.5 60fa7f7d82 android: add push_assets.py for development game data
Stages assets/loose + upstream/python-root (scripts win, case-insensitive)
+ python27.zip as a hard-link tree in build/android-data/root and sends it
to the app's external files directory with adb push --sync, so later runs
only transfer changed files. The committed assets/loose symlinks into the
old machine's pack_maker tree (bgm, sound/ui, icon/icon) are remapped to
the local pack_maker. The desktop client reaches the login screen inside
the staged tree with no missing-effect errors.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-12 18:58:00 +09:00

47 lines
2.1 KiB
Markdown

# 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.sh` finds it automatically)
- The SDK checkout beside this repository (`../sdk`), as for the desktop build
## Build
```bash
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
```bash
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`.