Files
2026-10-12 18:30:23 +09:00

37 lines
2.8 KiB
Markdown

# AVA2 cross-platform client
Independent AVA2 port, Android arm64 first with macOS arm64 for development. The host, login/selection transport, supported loading/game socket bridge and Python 2 bootstrap are implemented. It is not yet a playable client.
```sh
git submodule update --init --recursive # only when ../sdk is not checked out
cmake -S . -B build/dev -DCMAKE_BUILD_TYPE=Debug
cmake --build build/dev -j 8
ctest --test-dir build/dev --output-on-failure
python3 tools/verify_baseline.py
./build/dev/ava2_client --frames 60 --stdlib build/dev/python27.zip --python-root upstream/python-root
```
SDL3 development package is required for the window host. Use `-DAVA2_BUILD_HOST=OFF` for a build without a window, or `-DAVA2_EMBED_PYTHON=OFF` to disable Python. Python 3 only runs developer tools; gameplay retains Python 2.
`build/dev/ava2_login AUTH_HOST AUTH_PORT GAME_HOST GAME_PORT ACCOUNT` exercises the authentication transport and lists five character slots. Set `AVA2_PASSWORD` securely in the launching environment. No default server is configured. Real AVA2 server verification remains pending; use an isolated development server.
Android CMake builds require the NDK toolchain and an Android SDL3 SDK prefix. The `main` shared library compiles and links for arm64; APK packaging and device verification are pending. Original decoded assets remain in the sibling AVA2 directory; only immutable source/script references are copied into this repository.
See [port status](docs/PORT-PLAN.md), [mobile architecture](docs/MOBILE-ARCHITECTURE.md), [login implementation and verification](docs/LOGIN-TRANSPORT.md), and [active login profile](docs/LOGIN-PROFILE.json).
Windows equivalence is tracked in [the parity audit](docs/WINDOWS-PARITY.md). Preview characters require `--preview-data`; game previews do not prove server gameplay. The static [placeholder inventory](docs/WINDOWS-PARITY-INVENTORY.json) is regenerated with `python3 tools/audit_windows_parity.py`.
The SDK is maintained in its own Git repository
(https://git.slcydia.fun/4v5u09Z5a4Yuc/metin2-SDK.git). By default CMake uses an SDK
checkout beside this repository (`../sdk`, i.e. `chakan` and `sdk` in the same parent
directory). Without it, the build falls back to the pinned `sdk` submodule: clone with
`git clone --recurse-submodules` or run the initialization command above. Any other
checkout can be selected with `-DAVA2_SDK_ROOT=/absolute/path/to/sdk`.
Keep build outputs in `build/dev`, `build/release`, or another named directory
under `build/`, rather than configuring directly into `build/`. Put diagnostic
screenshots, logs, and one-off probes under `build/verification/`; permanent tests
belong in `tests/` and reusable tools in `tools/`. `dist/` contains generated
release packages. Loose game resource directories are used by development and
packaging and should not be treated as disposable caches.