Fichiers d’éléments permettant de gérer la taille du téléchargement

• Fichiers d’extension OBB : les applications mobiles peuvent avoir un fichier d’extension qui doit être au format opaque binary blob (OBB)⁠. D’une taille maximale de 4 Go, ce fichier se télécharge automatiquement au moment de l’installation.
• Fichiers d’éléments obligatoires : les applications mobiles peuvent fournir plusieurs fichiers d’éléments génériques, qui peuvent avoir pratiquement n’importe quel format, notamment le format OBB. Vous les marquez comme des éléments obligatoires afin qu’ils soient téléchargés au moment de l’installation.

• La taille maximale est de 4 Go.
• Le fichier peut être nommé comme vous le souhaitez au moment de l’importation. Il sera ensuite renommé avec le format suivant : main.[package-name].[version-code].obb.
• Le système de fichiers d’éléments utilise le nom du fichier pour déterminer si le fichier d’extension OBB doit être mis à jour sur le casque d’un·e utilisateur·ice.

• Si vous avez plusieurs fichiers OBB, vous pouvez importer les OBB supplémentaires en tant que fichiers d’éléments obligatoires à l’aide du fichier de configuration des éléments.

• Ils peuvent avoir n’importe quel format, avec n’importe quelle extension de fichier (notamment les fichiers OBB supplémentaires).
• Chaque fichier peut avoir une taille maximale de 4 Go, bien qu’une taille maximale de 2 Go soit recommandée.
• Ils exigent un fichier de configuration pendant le processus d’importation de l’application qui marque l’élément comme obligatoire.
• Le nom du fichier doit être le même pour toutes les versions. Utiliser le même nom de fichier dans toutes les versions permet d’accélérer les mises à jour basées sur des correctifs. Seules les modifications apportées aux fichiers d’éléments portant le même nom seront téléchargées dans vos versions ultérieures.

• Pour réduire la taille du téléchargement de votre APK à l’aide des fichiers d’éléments, assurez-vous que votre application indique Connexion Internet requise, ce qui permet aux utilisateur·ices de télécharger les fichiers obligatoires à partir de Meta.
  1. Connectez-vous au tableau de bord des développeurs⁠.
  2. Sélectionnez Distribution > Soumissions de l’application.
  3. Sélectionnez votre application dans la boîte de dialogue et suivez le chemin de la page de soumission des applications, Brouillon > App Metadata (Métadonnées de l’application) > Specs (Spécifications) > Connexion Internet.
  4. Choisissez Connexion Internet requise pour les contenus téléchargeables.
• Assurez-vous que le fichier manifeste Android dispose de l’autorisation READ_EXTERNAL_STORAGE, car les fichiers d’éléments sont généralement stockés sur un support externe. L’exemple suivant montre l’entrée du manifeste.

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

• Pour un fichier OBB d’extension, utilisez le paramètre --obb pour spécifier le chemin d’accès au fichier OBB.
• Pour les fichiers d’éléments obligatoires ou DLC, utilisez le paramètre --assets_dir pour spécifier le répertoire qui contient les éléments à importer.
• Pour les DLC également disponibles à l’achat ou pour les éléments obligatoires, utilisez le paramètre --asset_files_config pour spécifier un chemin d’accès au fichier de configuration.

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. Accédez au tableau de bord développeur·ses Meta Horizon⁠.
2. Sélectionnez votre application.
3. Dans le volet de navigation de gauche, sélectionnez Distribution > Soumissions de l’application.
4. Sur la page App Submission (Soumission d’une application), dans la colonne Version, cliquez sur l’hyperlien de la soumission à afficher.
5. Cliquez sur l’onglet Fichiers d’extension.
   L’onglet affiche les sections du fichier OBB et des fichiers d’éléments (DLC). Dans la colonne Obligatoire, Oui indique que le fichier est importé au moment de l’installation de l’application.
   L’image suivante montre un exemple d’onglet.
   
6. Pour modifier/télécharger le fichier, cliquez sur les points de suspension à côté de la colonne Obligatoire.
   Vous devez importer de nouveaux fichiers à l’aide de l’utilitaire en ligne de commande décrit dans la section Importation des fichiers d’extension.

• Pour supprimer un fichier précédemment installé :

    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.
  
• Pour installer le fichier 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.
  
• Pour pousser le nouveau fichier d’extension :

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

• Fichiers d’éléments génériques, qui peuvent être des contenus téléchargés au moment de l’exécution, ou des éléments obligatoires, téléchargés lors de l’installation.

• Ils peuvent avoir n’importe quel format, avec n’importe quelle extension de fichier, notamment les packs de langues.
• Chaque fichier peut avoir une taille maximale de 4 Go, bien qu’une taille maximale de 2 Go soit recommandée.
• Ils exigent un fichier de configuration pendant le processus d’importation de l’application qui marque l’élément comme obligatoire.

• Pour les fichiers obligatoires, le paramètre --assets_dir permet de spécifier le répertoire qui contient les éléments à importer et le paramètre --asset_files_config permet d’inclure un chemin d’accès au fichier de configuration JSON qui spécifie les éléments obligatoires.
  Par exemple :
  $ 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
  Le fichier de configuration JSON contient des entrées permettant d’associer votre DLC aux articles d’Achat intégré que vous avez définis précédemment, ou d’identifier un article comme obligatoire. Notez que chaque SKU doit correspondre à un SKU que vous avez défini dans le tableau de bord dans la section précédente.
  Par exemple :

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