Skip to main content
OBB Files

Steps to upload .obb files alongside the .apk.

Josh Franzen avatar
Written by Josh Franzen
Updated over a week ago

What are .obb files and are they supported?

.obb files allow you to install additional asset files with your apps. ArborXR does not enforce any file size limits to the .apk, so moving assets into .obb files is not necessary on ArborXR, but it is supported.


Does the naming convention of the .obb file matter?

Yes. It is crucial to follow this pattern:

main.<versionCode>.<package name>.obb


How do I upload .obb files?

If your app includes .obb files you must upload a zipped folder containing the .apk and any corresponding .obb files. For more information about uploading apps to ArborXR, see this article.

⚠️ The .obb(s) and .apk must be sent directly to a zipped folder. The .zip will fail to upload if there are sub-folders.


Is there a file size limitation with .obb files?

Yes, the .obb file cannot be larger than 4GB. This is because the Android operating system often uses the FAT32 file system and this file system has a maximum file size limit of 4GB, meaning no single file, including .obb files, can be larger than 4GB.


Can I manage .obb files separately from their corresponding .apk files?

No, .obb and .apk files must be managed together. This means that even if your update contains changes only to the .apk or only to the .obb expansion file, you must increment the versionCode (Bundle Version Code in Unity's Player Settings) of the .apk and upload both files together.


Are .obb files automatically installed alongside their corresponding .apk?

Yes. When you select an app that contains an .obb file and add it to an individual ungrouped device or to a device group, the .obb file will be installed alongside the .apk.


Did this answer your question?