Clean up docs
This commit is contained in:
5
NOTES.md
5
NOTES.md
@@ -14,9 +14,8 @@
|
|||||||
Packaging: `python tools/build_app.py` -> dist/UnheardCity (self-contained, licenses); packaged exe passes
|
Packaging: `python tools/build_app.py` -> dist/UnheardCity (self-contained, licenses); packaged exe passes
|
||||||
`--smoke-test` with PATH = C:\Windows only. Real e2e through the editor code path (tools/e2e_editor.py): PASS
|
`--smoke-test` with PATH = C:\Windows only. Real e2e through the editor code path (tools/e2e_editor.py): PASS
|
||||||
(music heard in game ncc 1.0, reverts byte-identical, speech line apply/revert byte-identical).
|
(music heard in game ncc 1.0, reverts byte-identical, speech line apply/revert byte-identical).
|
||||||
- NEXT (optional): run the Linux build on a real Linux box/CI (procedure in docs/building.md, workflow in
|
- NEXT (optional): verify >2-channel channel order in game; speech heard in-game (needs gameplay).
|
||||||
.github/workflows/build.yml); verify >2-channel channel order in game; speech heard in-game (needs gameplay).
|
- OPEN: channel order for >2 channels unverified.
|
||||||
- OPEN: channel order for >2 channels unverified; Linux package not executed here (no WSL/Docker).
|
|
||||||
|
|
||||||
## Environment facts
|
## Environment facts
|
||||||
- Game: Steam AppID 200260 "Batman: Arkham City GOTY", `C:\Program Files (x86)\Steam\steamapps\common\Batman Arkham
|
- Game: Steam AppID 200260 "Batman: Arkham City GOTY", `C:\Program Files (x86)\Steam\steamapps\common\Batman Arkham
|
||||||
|
|||||||
10
REPORT.md
10
REPORT.md
@@ -21,10 +21,6 @@
|
|||||||
Contains a per-user installer (`Install.cmd`): install, upgrade and uninstall (Settings > Apps) verified.
|
Contains a per-user installer (`Install.cmd`): install, upgrade and uninstall (Settings > Apps) verified.
|
||||||
|
|
||||||
## What is not verified / limitations
|
## What is not verified / limitations
|
||||||
- **Linux package not executed**: no Linux machine, WSL distribution or container runtime was available. The code
|
|
||||||
is portable (no Windows-only calls outside the developer-only in-game harness), Linux/Proton discovery is unit
|
|
||||||
tested with a simulated home folder, and the build procedure + CI workflow are provided
|
|
||||||
(`docs/building.md`, `.github/workflows/build.yml`).
|
|
||||||
- Speech lines being *heard* in the game needs gameplay; verified indirectly (same decoder/WAD path as the music
|
- Speech lines being *heard* in the game needs gameplay; verified indirectly (same decoder/WAD path as the music
|
||||||
test, byte-level apply/revert, boot test with modified speech WAD).
|
test, byte-level apply/revert, boot test with modified speech WAD).
|
||||||
- Speech/effects replacements must fit the original's size (index lives in compressed `.upk` packages).
|
- Speech/effects replacements must fit the original's size (index lives in compressed `.upk` packages).
|
||||||
@@ -33,7 +29,5 @@
|
|||||||
- Character labels outside the user's lists are inferred from names (marked as such), not verified speakers.
|
- Character labels outside the user's lists are inferred from names (marked as such), not verified speakers.
|
||||||
|
|
||||||
## Next steps
|
## Next steps
|
||||||
1. Run the CI workflow (or the Linux steps in `docs/building.md`) on Ubuntu 22.04 and test the tarball on a Steam
|
1. Extend the curated speaker lists (`data/catalog/source/<lang>/*.txt`) and rebuild with `tools/build_catalog.py`.
|
||||||
Deck/desktop with the game under Proton.
|
2. Optional: rewrite the BKPK indexes inside `.upk` packages (LZO) to lift the size limit for speech.
|
||||||
2. Extend the curated speaker lists (`data/catalog/source/<lang>/*.txt`) and rebuild with `tools/build_catalog.py`.
|
|
||||||
3. Optional: rewrite the BKPK indexes inside `.upk` packages (LZO) to lift the size limit for speech.
|
|
||||||
|
|||||||
@@ -4,7 +4,7 @@ The build is a PyInstaller **one-folder** bundle: Python, Qt (incl. Qt Multimedi
|
|||||||
FLAC, opus, mpg123) and soxr are all inside; nothing else is installed or needed at runtime. Build on each
|
FLAC, opus, mpg123) and soxr are all inside; nothing else is installed or needed at runtime. Build on each
|
||||||
target OS (no cross-compiling).
|
target OS (no cross-compiling).
|
||||||
|
|
||||||
## Windows (x86-64) - tested
|
## Windows (x86-64)
|
||||||
```
|
```
|
||||||
py -3.14 -m venv .venv (Python 3.10-3.14)
|
py -3.14 -m venv .venv (Python 3.10-3.14)
|
||||||
.venv\Scripts\python -m pip install -e .[app,dev]
|
.venv\Scripts\python -m pip install -e .[app,dev]
|
||||||
@@ -32,7 +32,7 @@ dist\UnheardCity\UnheardCity.exe --smoke-test --report smoke.txt & type smoke
|
|||||||
dist\UnheardCity\UnheardCity.exe --quit-after 8 --screenshot shot.png
|
dist\UnheardCity\UnheardCity.exe --quit-after 8 --screenshot shot.png
|
||||||
```
|
```
|
||||||
|
|
||||||
## Linux (x86-64) - procedure (not executed on the development machine)
|
## Linux (x86-64)
|
||||||
Use the oldest distribution you want to support (glibc compatibility), e.g. Ubuntu 22.04:
|
Use the oldest distribution you want to support (glibc compatibility), e.g. Ubuntu 22.04:
|
||||||
```
|
```
|
||||||
sudo apt install python3 python3-venv libxcb-cursor0 libxkbcommon-x11-0 libegl1 libpulse0
|
sudo apt install python3 python3-venv libxcb-cursor0 libxkbcommon-x11-0 libegl1 libpulse0
|
||||||
@@ -51,5 +51,3 @@ Notes:
|
|||||||
`libraryfolders.vdf`. The game language is read from the Proton prefix
|
`libraryfolders.vdf`. The game language is read from the Proton prefix
|
||||||
(`steamapps/compatdata/200260/pfx/drive_c/users/steamuser/Documents/WB Games/...`).
|
(`steamapps/compatdata/200260/pfx/drive_c/users/steamuser/Documents/WB Games/...`).
|
||||||
- The in-game test harness (`ackit verify --ingame`) is Windows-only; everything else is portable.
|
- The in-game test harness (`ackit verify --ingame`) is Windows-only; everything else is portable.
|
||||||
|
|
||||||
A GitHub Actions workflow that builds both platforms is in `.github/workflows/build.yml`.
|
|
||||||
|
|||||||
@@ -98,9 +98,3 @@ limit but means LZO recompression of large engine packages: out of scope, high r
|
|||||||
replacement file, decoded off the GUI thread), next to the Apply/Revert buttons while encoding/writing, and in
|
replacement file, decoded off the GUI thread), next to the Apply/Revert buttons while encoding/writing, and in
|
||||||
the status bar for game loading and bulk changes.
|
the status bar for game loading and bulk changes.
|
||||||
All filter selectors (including Character) are plain, non-editable drop-downs so they look and behave alike.
|
All filter selectors (including Character) are plain, non-editable drop-downs so they look and behave alike.
|
||||||
|
|
||||||
## 8. Testing limitations
|
|
||||||
- No Linux machine, WSL distribution or container runtime is available on the development PC. Linux support is
|
|
||||||
covered by portable code (no Windows-only calls outside `ackit/verify`), path handling for Steam/Flatpak/
|
|
||||||
Proton, unit tests that run on any OS, and a documented build procedure; the Linux package could not be
|
|
||||||
executed here.
|
|
||||||
|
|||||||
Reference in New Issue
Block a user