obb-manager

Documentation

Overview

OBB storage manager lifecycle example.

Demonstrates how to create an Android storage manager, check whether an OBB (Opaque Binary Blob) file is mounted, and query its mounted path.

OBB files are large binary assets (up to 2 GB each) that Android games and apps use to store resources that exceed the APK size limit. The system mounts an OBB as a virtual filesystem at a path under /storage/emulated/0/Android/obb/<package>/. Once mounted, the application reads assets from the mounted path like ordinary files.

Typical OBB workflow:

1. Create a storage manager.
2. Check if the OBB is already mounted (IsObbMounted).
3. If not mounted, mount it (MountObb with an async callback).
4. Obtain the mounted path (MountedObbPath) to read assets.
5. When done, unmount the OBB (UnmountObb with an async callback).
6. Close the manager to release native resources.

This example covers steps 1, 2, 4, and 6. Steps 3 and 5 (asynchronous mount/unmount) require a running ALooper on the calling thread, which is beyond the scope of this minimal example.

This program must run on an Android device.