GTA San Andreas — Android Troubleshooting Guide
==================================================

CRASHES ON LAUNCH / WON'T OPEN
--------------------------------------
Most likely cause: missing or misplaced OBB file, or insufficient storage.
- Confirm the OBB file (if your version needs one) is in exactly:
    Android/obb/com.rockstargames.gtasa/
  and that the filename has not been altered.
- Confirm you have at least 3 GB of free storage, not just "enough" —
  the game may partially unpack before failing if space runs out mid-launch.
- Uninstall completely (including any leftover data folder) and reinstall
  fresh rather than installing over a previous broken install.

"PACKAGE PARSING ERROR" ON INSTALL
--------------------------------------
This means the APK file itself is incomplete or corrupted, almost always
from an interrupted download.
- Re-download the APK file completely; do not resume a partial download.
- Confirm your Android version meets the minimum required by your
  specific APK build — a very old Android version can also trigger this
  error even with a valid file.

GAME INSTALLS BUT SAVES DON'T LOAD / DISAPPEAR
--------------------------------------
- Check that storage permission is actually granted (Android Settings >
  Apps > [game] > Permissions), not just accepted once during a popup
  that may not have registered.
- Avoid using a "clear cache" or storage-cleaner app that targets the
  game's folder — some aggressive cleaners remove save data along with
  actual cache files.

STUTTERING / FRAME DROPS DURING GAMEPLAY
--------------------------------------
- Lower Draw Distance first — see Recommended_Settings.txt. This setting
  affects performance more than any other single option.
- Close background apps, especially other games, browsers with many
  open tabs, or streaming apps.
- If the device gets noticeably hot during play, this is thermal
  throttling, not a bug — let the device cool down and consider a lower
  settings profile for long sessions.

CONTROLS FEEL DELAYED OR UNRESPONSIVE
--------------------------------------
- Test with Frame Limiter toggled to the opposite of its current setting
  — on some devices, uncapped framerate paradoxically increases input
  lag due to thermal throttling rather than reducing it.
- If using a Bluetooth controller, confirm it is fully paired (not just
  connected) before launching — a partial pairing can cause intermittent
  input drops that look like a game bug but aren't.

STILL STUCK?
--------------------------------------
If none of the above resolves your issue, the most useful next step is
usually to note your exact device model, Android version, and free
storage at the time of the crash — that combination narrows down the
cause far faster than describing the symptom alone.
