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?
Navigate to the Content Library.
Create a new managed app or click into an existing managed app.
Click Upload Build.
Drag and drop the APK or click Browse to select it from your PC's file system.
Toggle on Add bundled files with build (optional).
Click Select Files then select the OBB file from your PC's file system.
Click Upload.
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 to the app's OBB folder (i.e. Android/obb/<app package name>).
Can I install an individual set of files to my app's OBB directory instead of uploading and installing a single OBB file?
Yes. You can upload addressable files (or Unity AssetBundles) alongside app builds to ArborXR and specify the exact installation directory for the bundled files (e.g. Android/obb/{com.package.name}). This eliminates the need for custom hosting servers and ensures that the correct assets are delivered seamlessly with every app version. When deployed via ArborXR, both the application and its dedicated content are installed together, guaranteeing an error-free experience before the app even launches. Learn more.