Asset-Dateien zur Verringerung der Download-Größe

• OBB-Erweiterungsdateien – Mobile Apps können eine Erweiterungsdatei mit einer Größe von bis zu 4 GB im Opaque Binary Blob (OBB)⁠-Format verwenden. Diese Datei wird bei der Installation automatisch heruntergeladen.
• Erforderliche Asset-Dateien – Mobile Apps können mehrere generische Asset-Dateien in praktisch allen Formaten bereitstellen, darunter auch das OBB-Format. Wenn du diese Assets als erforderlich markierst, werden sie bei der Installation heruntergeladen.

• Kann bis zu 4 GB groß sein.
• Du kannst die Datei beim Upload frei benennen. Anschließend wird sie wie folgt umbenannt: main.[package-name].[version-code].obb.
• Das System für Asset-Dateien stellt anhand des Dateinamens fest, ob die OBB-Erweiterungsdatei auf dem Headset eines*r Nutzer*in aktualisiert werden muss.

• Falls du mehr als eine OBB-Datei verwendest, kannst du die zusätzlichen OBBs mit der Asset-Konfigurationsdatei als erforderliche Assets hochladen.

• Können beliebige Formate und Dateierweiterungen haben (inklusive zusätzlicher OBB-Dateien).
• Können jeweils bis zu 4 GB groß sein, allerdings wird eine maximale Größe von 2 GB empfohlen.
• Müssen beim Hochladen der App mit einer Konfigurationsdatei als erforderlich markiert werden.
• Sollten in allen Versionen deines Builds denselben Dateinamen haben. Wenn du denselben Dateinamen in allen Versionen deines Builds verwendest, werden Patch-Updates schneller ausgeführt. In späteren Versionen deiner Builds werden nur Änderungen von Asset-Dateien mit dem jeweils gleichen Namen heruntergeladen.

• Um die Downloadgröße deiner APK-Datei mit Asset-Dateien zu reduzieren, solltest du angeben, dass deine App eine Internetverbindung benötigt, damit die Nutzer*innen die erforderlichen Dateien von Meta herunterladen können. Melde dich beim Developer Dashboard⁠ an. Wähle Distribution > Eingereichte Apps aus. Wähle deine App im Dialog aus und folge dem Pfad auf der Seite für eingereichte Apps: Entwurf > App-Metadaten > Spezifikationen > Internetverbindung. Wähle Internetverbindung zum Herunterladen von Inhalten erforderlich aus.
• Stelle sicher, dass die Android-Manifestdatei die Berechtigung READ_EXTERNAL_STORAGE enthält, da Asset-Dateien normalerweise im externen Speicher abgelegt werden. Das folgende Beispiel zeigt den Manifesteintrag.

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

• Verwende im Fall einer OBB-Erweiterungsdatei den Parameter --obb, um den Pfad zur OBB-Datei anzugeben.
• Falls du erforderliche oder DLC-Asset-Dateien verwendest, gib den Parameter --assets_dir an, um das Verzeichnis zu definieren, das die hochzuladenden Assets enthält.
• Für käuflich erwerbbare DLCs oder für erforderliche Assets kannst du mit dem Parameter --asset_files_config einen Pfad zur Konfigurationsdatei angeben.

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. Gehe zum Meta Horizon Developer Dashboard⁠.
2. Wähle deine App aus.
3. Wähle in der Navigation links Distribution > Eingereichte Apps aus.
4. Klicke auf der Seite Eingereichte Apps in der Spalte Build auf den Hyperlink der Einreichung, die du abrufen möchtest.
5. Klicke auf den Tab Erweiterungsdateien.
   Der Tab enthält Abschnitte für die OBB-Datei und für Objektdateien (DLC). Der Wert Yes in der Spalte Erforderlich gibt an, dass die Datei bei der Installation der App heruntergeladen wird.
   Die folgende Abbildung zeigt ein Beispiel für den Tab.
   
6. Klicke auf den Button mit den drei Punkten neben der Spalte Erforderlich, um die Datei zu bearbeiten oder herunterzuladen.
   Neue Dateien müssen mit dem unter Erweiterungs- und generische Asset-Dateien hochladen beschriebenen Befehlszeilenprogramm hochgeladen werden.

• Zuvor installierte Datei entfernen:

    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-Datei installieren:

    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.
  
• Neue Erweiterungsdatei kopieren:

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

• Generische Asset-Dateien können Inhalte enthalten, die zur Runtime heruntergeladen werden, oder erforderliche Assets, die bei der Installation heruntergeladen werden.

• Können beliebige Formate und Dateierweiterungen haben, darunter auch Sprachpakete.
• Können jeweils bis zu 4 GB groß sein, allerdings wird eine maximale Größe von 2 GB empfohlen.
• Müssen beim Hochladen der App mit einer Konfigurationsdatei als erforderlich markiert werden.

• Gib für erforderliche Dateien mit dem Parameter --assets_dir das Verzeichnis an, das die hochzuladenden Dateien enthält, sowie den Parameter „ --asset_files_config“ mit einem Pfad zur JSON-Konfigurationsdatei, die die erforderlichen Objekte definiert.
  Zum Beispiel:
  $ 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
  Die JSON-Konfigurationsdatei enthält Einträge, um deine DLC den zuvor definierten IAP-Elementen zuzuordnen oder um ein Element als erforderlich zu definieren. Dabei muss jede SKU mit einer der SKUs übereinstimmen, die du im vorherigen Abschnitt im Dashboard definiert hast.
  Zum Beispiel:

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