How to Install APK with OBB Files for Large Games
Large Android games often ship as APK + OBB. Learn the correct folder path, naming rules, permissions, and fixes when the game asks to download data again.
Large Android games rarely fit in a single APK. Publishers ship a small installer plus OBB expansion files. Sideload only the APK and the game will re-download data—or crash. Here’s the correct path, naming, and fixes for 2026 devices.
1. What an OBB file is
Typical names:
main.<versionCode>.<packageName>.obbpatch.<versionCode>.<packageName>.obb
versionCode must match the APK. packageName must match the app id.
2. Correct folder layout
Android/obb/<packageName>/main.<versionCode>.<packageName>.obb
Android/obb/<packageName>/patch.<versionCode>.<packageName>.obbOn Android 11+, use a file manager that can write under Android/obb, or adb push. Enable “show Android folder” if your OEM hides it.
3. Install order that works
- Download APK + OBB from the same release (same versionCode)
- Copy OBB into
Android/obb/<package>/before or right after installing the APK - Install the APK; open once offline to confirm local data loads
- Grant storage permission if prompted
Confirm the package name on gptoapk.com/en before creating folders—wrong path is the #1 failure.
4. Common failures
| Problem | Cause | Fix |
|---|---|---|
| Game re-downloads everything | OBB missing / wrong name | Rename to main.<vc>.<pkg>.obb |
| Not enough storage | Wrong volume | Use primary storage for Android/obb |
| Black screen then exit | versionCode mismatch | Use APK + OBB from one build |
| Can’t copy into Android/obb | Scoped storage | adb push / capable file managers |
5. adb when the file manager is blocked
adb shell mkdir -p /sdcard/Android/obb/com.example.game
adb push main.123.com.example.game.obb /sdcard/Android/obb/com.example.game/
adb install -r game.apkRead package and versionCode with aapt dump badging game.apk | grep -E 'package:|versionCode'.
6. XAPK / APKM bundles
Some mirrors wrap APK+OBB as XAPK. Prefer knowing the package name so you can verify contents. For sideload safety, see integrity guides on the blog and only use sources that show the Play package id.
7. Updates after install
Keep updating from the same trusted channel with matching APK+OBB pairs, or switch back to a Play build with the same signature when Play works again. Signature mismatch requires uninstall (local saves may be lost unless the game uses cloud saves).
Summary
Successful OBB installs need matching package name + versionCode + path. Copy expansions into Android/obb/<package>/, install the matching APK, and use adb if scoped storage blocks copies. Look up the package id on gptoapk.com/en first.