# Android-порт клиента

Цель — тот же клиент `gmod-rs` (SDL3 + wgpu), запускаемый как APK на Android
12+ (API 31+). Отдельного «мобильного движка» нет: карта, физика, Lua и рендер
общие с десктопом.

## Сборка

```bash
./android/build.sh                  # arm64-v8a, APK для телефона
ANDROID_ABI=x86_64 ./android/build.sh  # x86_64, для эмулятора
```

Скрипт использует SDK/NDK, `cargo`, `aapt2`, `d8`, `zipalign`, `apksigner`
(Gradle не нужен). Результат — `target/android/gmod-rs-debug.apk`
(подписан debug-ключом `android/debug.keystore`). Подробности и команды
установки — в `android/README.md`.

## Крейты и target cfg

- `crates/client` теперь и библиотека (`src/lib.rs`), и бинарь (`src/main.rs`).
  Бинарь вызывает `client::run(args)`, Android-сборка — `cargo build --lib`
  с `crate-type = ["cdylib", "rlib"]`.
- Экспорт `SDL_main` (в `lib.rs` под `cfg(target_os = "android")`) — точка
  входа для штатной Java-обвязки SDL3 (`SDLActivity`).
- `steamworks` подключён только для не-Android; команда `net` на Android
  отсутствует.
- `mlua`: на десктопе LuaJIT + `vendored`, на Android — Lua 5.4 + `vendored`
  (LuaJIT не собирается кросс-компилятором mlua). API GMod-скриптов сохраняется.
- `tracing` на Android пишет в logcat (`adb logcat -s gmod-rs`), а не в stdout.

## APK

- Java-классы SDL3 (`org.libsdl.app.*`) взяты из `sdl3-src` (zlib-лицензия) и
  лежат в `android/app/src/main/java`.
- `MainActivity` наследует `SDLActivity`, фиксирует ландшафт и передаёт
  нативной части аргументы `map gm_construct --assets <external files>/...`.
- Нативные библиотеки пакуются как `lib/arm64-v8a/libSDL3.so` и
  `libmain.so` (внутри — `libclient.so` с `SDL_main`).
- Ассеты не входят в APK: их кладут во внешний каталог приложения
  (`Android/data/org.gmodrs.client/files/gmod_server/server`), см. README.

## Управление

Обрабатываются `SDL_EVENT_FINGER_*`; синтетические события мыши от касаний
отключены (`SDL_TOUCH_MOUSE_EVENTS=0`):

- левая половина экрана — аналоговый стик (forward/right идут в тот же
  `Player::update`, что WASD);
- правая половина — обзор свайпом (приращение углов камеры);
- кнопки `JUMP`/`DUCK` — прыжок (с защёлкой короткого тапа) и присед;
- на Android движение сразу бегом (отдельной кнопки Shift нет).

## Проверка

- `cargo clippy -p client --lib --target aarch64-linux-android -- -D warnings`.
- Эмулятор API 35 x86_64: APK запускается, `gm_construct` грузится, кадры
  рисуются (SwiftShader, ~11–14 fps), стик/обзор/прыжок проверены через
  `adb shell input`.
- Реальное arm64-устройство не проверялось (нет устройства); при отладке —
  `adb logcat -s gmod-rs SDL`.