🎮 How do I get it running on my phone? (start here)

[molotovgit]

The single most common question is "how do I actually get it onto my phone?" — here's the short version. The full, follow-along guide is docs/SETUP-GAME-FILES.md; start there.

The five steps

1. Find your Zero Hour install on a PC — the folder full of *.big files plus a Data\ folder (retail, EA App/Origin "Ultimate Collection", or Steam). Use the Zero Hour folder, not base Generals.
2. Assemble a clean data folder — copy every *.big + the whole Data\ folder (include Data\Movies\ if you want cutscenes) + the port's dxvk.conf into e.g. C:\gamedata\. No INI editing needed.
3. Pack it: python scripts/package_selfcontained.py C:\gamedata android/app/src/main/assets/ (zips stored + splits into <2 GB .pak parts).
4. Build & install: cd android && ./gradlew assembleDebug then adb install -r app/build/outputs/apk/debug/app-debug.apk.
5. First launch shows "Installing game data…" for ~1–2 min, then it boots. You need ~5 GB free on the phone.

Common gotchas

Symptom	Fix
Black screen after the EA logo	A .big is missing — re-copy all of them (step 2).
"Installing game data…" then it exits	Not enough free space (~5 GB), or the .pak parts didn't build — re-run step 3.
No cutscenes	You didn't include Data\Movies\ (optional).
No sound	Turn up media volume; audio uses OpenSL ES.
Gradle "Java heap space" while packaging	Keep org.gradle.jvmargs=-Xmx4096m in android/gradle.properties.

Ask away

Stuck on a step? Reply below or open a new Q&A discussion with your device model, GPU, Android version, and the app's private log (see CONTRIBUTING.md for where the log lives). Please don't paste game data — describe it instead.