Файлы объектов для управления размером загрузки

• Файлы расширения OBB — мобильные приложения могут иметь один файл расширения в формате opaque binary blob (OBB)⁠ размером до 4 ГБ. Этот файл автоматически скачивается во время установки.
• Обязательные файлы объектов — мобильные приложения могут предоставлять несколько общих файлов объектов практически в любом формате, в том числе OBB. Вы помечаете их как обязательные объекты, чтобы они скачивались во время установки.

• может иметь размер до 4 ГБ;
• во время загрузки вы можете дать ему любое имя, затем он будет переименован в следующем формате: main.[package-name].[version-code].obb;
• по имени файла файловая система файлов объектов определяет, нужно ли обновлять файл расширения OBB на гарнитуре пользователя.

• Если у вас несколько файлов OBB, вы можете загрузить дополнительные OBB в качестве обязательных файлов объектов с помощью файла конфигурации объектов.

• Могут иметь любой формат и любое расширение (в том числе OBB).
• Могут иметь размер до 4 ГБ (рекомендуется не более 2 ГБ).
• Требуют наличия файла конфигурации в процессе загрузки приложения, который отмечает элемент как обязательный.
• Должны иметь одинаковое имя файла во всех версиях сборки. Использование одинакового имени файла во всех версиях сборки позволяет быстрее обновлять пакеты исправлений. В последующих версиях сборок будут скачиваться только изменения в файлах объектов с одинаковыми именами.

• Чтобы уменьшить размер скачиваемого APK с помощью файлов объектов, убедитесь, что для вашего приложения указано, что оно требует подключения к Интернету. Так пользователи смогут скачивать обязательные файлы с Meta. Войдите на панель разработчика⁠. Выберите Распространение > Отправка приложений. Выберите свое приложение в диалоге и следуйте пути, указанному на странице отправки приложений: Draft (Черновик) > App Metadata (Метаданные приложения) > Specs (Спецификации) > Internet Connection (Подключение к Интернету). Выберите Internet connection required for downloadable content (Для скачиваемого контента требуется подключение к Интернету).
• Убедитесь, что в файле манифеста Android имеется разрешение READ_EXTERNAL_STORAGE, поскольку файлы объектов обычно хранятся на внешних носителях. В следующем примере показана соответствующая запись манифеста.

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

• Для OBB-файла расширения укажите путь к файлу OBB в параметре --obb
• Для обязательных файлов объектов и скачиваемого контента укажите каталог, содержащий объекты для загрузки, в параметр --assets_dir.
• Для скачиваемого контента, который также доступен для покупки, или для обязательных объектов укажите путь к файлу конфигурации в параметре --asset_files_config.

ovr-platform-util upload-quest-build
-a 12345 // Specifies the app ID for the app you want to upload the build to
-s 1234 // Specifies the app secret for the app you want to upload the build to.
-d path/to/mygame.zip // Specifies the path to the APK file for the Quest build.
--obb path/to/myGame.obb // Specifies the path to the OBB file for the Quest build.
--assets_dir /path/to/myGame/assets // Specifies the directory containing additional asset files for the Quest build.
--asset_files_config /path/to-config-file.json // Specifies the path to a JSON configuration file that lists the required asset files and their metadata.
-c ALPHA // Specifies the release channel for the build (in this case, "ALPHA").

{
    "asset1.ext": {
        "required": true
    }
}

{
  "scene_12_Q.obb": {
    "required": true,
    "supportedDevices": ["quest"]
  },
  "scene_12_Q2.obb": {
    "required": true,
    "supportedDevices": ["quest2"]
  },
  "scene_12_shared.obb": {
    "required": true,
    "supportedDevices": ["quest", "quest2"]
  }
}

1. Перейдите на Панель разработчика Meta Horizon⁠.
2. Выберите приложение.
3. В области навигации слева выберите Распространение и нажмите Отправка приложений.
4. На странице Отправка приложений в столбце Сборка нажмите гиперссылку отправки, которую нужно просмотреть.
5. Откройте вкладку Файлы расширений.
   На ней есть разделы Файл OBB и Файлы объектов (скачиваемый контент). Значение Да в колонке Обязательный указывает на то, что файл скачивается во время установки приложения.
   На рисунке ниже показан пример вкладки.
   
6. Чтобы отредактировать или скачать файл, нажмите кнопку с тремя токами рядом с колонкой Обязательный.
   Новые файлы необходимо загружать с помощью утилиты командной строки, описанной в статье Загрузка файлов расширения.

• Удаление ранее установленного файла:

    adb uninstall com.oculus.demo // Uninstalls the app
    adb shell rm /sdcard/Android/obb/main.1.com.oculus.demo.obb // Removes the previously installed expansion file for the app with specified location.
  
• Установка файла APK:

    adb push -p bundles.apk /data/local/tmp // Pushes the APK file to the device's temporary storage directory.
    adb shell pm install -g /data/local/tmp/bundles.apk // Installs the APK file on the device, granting all runtime permissions requested by the app.
    adb shell rm /data/local/tmp/bundles.apk // Removes the APK file from the device's temporary storage directory after installation.
  
• Отправка нового файла расширения:

    adb push -p main.1.com.oculus.demo.obb /sdcard/Android/obb/ // pushes the new expansion file to the device's OBB directory
  

• Общие файлы объектов, которые могут быть контентом, скачиваемым во время выполнения, или обязательными объектами, скачиваемыми во время установки.

• Может иметь любой формат и любое расширение (в том числе языковые пакеты).
• Могут иметь размер до 4 ГБ (рекомендуется не более 2 ГБ).
• Требуют наличия файла конфигурации в процессе загрузки приложения, который отмечает элемент как обязательный.

• Для обязательных файлов укажите каталог с загружаемыми объектами в параметре --assets_dir, а в параметре --asset_files_config укажите путь к JSON-файлу конфигурации, в котором определяются обязательные элементы.
  Пример:
  $ ovr-platform-util upload-rift-build -a 12345 -s 1234 -d path/to/mygame.zip --assets_dir /path/to/myGame/assets --asset_files_config /path/to/config-file.json -c ALPHA
  JSON-файл конфигурации содержит записи, позволяющие связать скачиваемый контент с ранее определенными элементами ПВП или идентифицировать элемент по мере необходимости. Обратите внимание: SKU должны соответствовать тем SKU, которые вы определили на панели в предыдущем разделе.
  Пример:

   {
    "asset1.ext": {
        "required": true
    }
   }