La sauvegarde dans le cloud est une solution de sauvegarde au niveau du système de fichiers qui enregistre et restaure automatiquement les données d’application sans changement de code. Notez que le stockage dans le cloud V2 a été désactivé le 31 janvier 2025 et que la sauvegarde dans le cloud est l’option recommandée pour enregistrer et synchroniser les données d’application sur tous les appareils.
La sauvegarde dans le cloud est un système de sauvegarde des données d’applications des appareils. Elle inclut la sauvegarde dans le cloud de la progression et des paramètres des applications participantes, et permet aux personnes de reprendre là où elles en étaient dans une application. L’utilisation des applications sur de nouveaux casques, la réinstallation des applications ou la réinitialisation d’un appareil sont ainsi facilitées. La sauvegarde dans le cloud utilise Android Auto Backup (Sauvegarde automatique sous Android).
La sauvegarde dans le cloud fonctionne au niveau du système de fichiers, sans codage requis. Les applications sont inscrites par défaut, et vous pouvez supprimer l’inscription ou effectuer des ajustements dans le tableau de bord des équipes de développement. Afin de garantir la sécurité des données de sauvegarde dans le cloud, les données d’applications sont chiffrées dans l’appareil en question et restent chiffrées sur nos serveurs.
Les utilisateur·ices peuvent choisir de supprimer la sauvegarde dans le cloud dans les paramètres de leur casque.
Cas d’utilisation pour les utilisateur·ices de l’application
Comment puis-je voir et supprimer les sauvegardes dans le cloud pour une application que je possède ?
Pour voir les sauvegardes existantes dans toutes vos applications, accédez à l’onglet Sauvegardes dans le cloud sur le site Web Meta Quest.
Sur cette page, vous verrez une liste des applications qui vous appartiennent et un filtre vous permettant d’effectuer une recherche par nom. Si une sauvegarde dans le cloud d’une application existe, vous apercevrez un timestamp, une taille et une option pour supprimer la sauvegarde.
À quel(s) moment(s) une application m’appartenant effectue-t-elle une sauvegarde ?
Les sauvegardes se déroulent automatiquement aux moments suivants :
Une fois par nuit, lorsque l’appareil est inactif, en charge et connecté au Wi-Fi, comme lorsque le système met à jour le système d’exploitation.
Quand l’application est désinstallée, si elle a été installée depuis le Store.
Lors de chaque sortie de l’application, jusqu’à une fois toutes les six heures.
Chaque utilisateur·ice peut disposer de plusieurs « emplacements » de sauvegarde par application achetée et par casque, et chaque exécution de sauvegarde n’écrasera pas l’emplacement précédent. Outre les sauvegardes automatisées, les utilisateur·ices peuvent demander manuellement des sauvegardes en accédant à l’onglet Sauvegardes dans le cloud situé dans les paramètres de l’appareil.
À quel(s) moment(s) une application que je possède restaure-t-elle ses données de sauvegarde dans le cloud ?
La sauvegarde dans le cloud restaure automatiquement la dernière sauvegarde d’une application lorsqu’elle est installée. Les utilisateur·ices peuvent déterminer quelle sauvegarde sera restaurée en accédant à la page Web Sauvegardes dans le cloud. Ici, les utilisateur·ices peuvent aussi demander à restaurer manuellement une sauvegarde spécifiée à tout moment.
Mes données de sauvegarde dans le cloud générées sur un appareil sont-elles transférées vers un autre appareil ?
Oui. Si la sauvegarde dans le cloud ne peut pas trouver de données pour un appairage application + appareil spécifique, alors elle restaurera la sauvegarde la plus récente pour cette application sur tous les appareils possédés.
Prenons l’exemple d’un·e utilisateur·ice qui dispose des données de sauvegarde dans le cloud générées pour une application sur son Meta Quest 2 et qui vient d’acheter un Meta Quest 3. Lors de l’installation de l’application sur son nouveau Meta Quest 3, le système de sauvegarde dans le cloud restaurera les données sauvegardées du Meta Quest 2, car il n’a pas pu trouver d’instance de données sauvegardées pour cette application associée à son Meta Quest 3.
Une fois la sauvegarde dans le cloud effectuée sur le Meta Quest 3, ces données seront sauvegardées sous l’« emplacement » pour leur application achetée, pour leur casque Meta Quest 3. Après ce point, les sauvegardes dans le cloud pour le Meta Quest 2 et le Meta Quest 3 divergeront.
Un·e utilisateur·ice qui souhaite copier les données de sauvegarde dans le cloud entre deux casques peut accéder à l’onglet Sauvegardes dans le cloud sur le site Web Meta Quest et effectuer une restauration des données de sauvegarde dans le cloud en ciblant le casque vers lequel il ou elle souhaite transférer les données. Un nouvel emplacement pour les données de sauvegarde transférées dans le cloud sera automatiquement créé pour le casque ciblé.
Les données de sauvegarde dans le cloud peuvent être transférées des casques de nouvelle génération (c’est-à-dire Quest 3) aux casques de plus anciennes générations (c’est-à-dire Quest 2), et vice versa.
Cas d’utilisation pour les développeur·ses de l’application
Comment puis-je activer la sauvegarde dans le cloud pour mon titre lorsque notre titre a déjà utilisé la version 2 des enregistrements dans le cloud ?
Dans le tableau de bord développeur·se, cliquez sur Développement > Stockage dans le cloud. Dans le menu déroulant, sélectionnez votre application. Sur la page Cloud Storage (stockage dans le cloud), assurez-vous que Enable Automatic Cloud Backup (Activer la sauvegarde automatique dans le cloud) est activé.
En savoir plus sur la procédure pour stocker correctement des données dans la Mise en œuvre technique.
Comment puis-je désactiver la sauvegarde dans le cloud pour mon titre si je ne veux pas qu’il soit utilisé ?
Dans le tableau de bord développeur·se, sous Développement > Stockage dans le cloud, désactivez Activer la sauvegarde automatique dans le cloud.
Implémentation technique
Stockez les données de l’application uniquement dans les répertoires pris en charge, ne dépassez pas la limite de 100 Mo et activez la sauvegarde dans le cloud pour votre application sur le tableau de bord développeur·se.
Si ces conditions sont remplies, l’application procédera à une sauvegarde automatique.
Répertoires qui seront sauvegardés
Auto Backup (Sauvegarde automatique) inclut des fichiers dans la plupart des répertoires affectés à votre application par le système. Vous pouvez localiser les emplacements de ces fichiers en y accédant via un Objet contextuel :
Les emplacements ci-dessus fournis par un contexte de stockage protégé par un dispositif
Tenez compte du fait que les dossiers personnalisés réalisés dans le répertoire racine de l’application ne sont pas sauvegardés. Si vous souhaitez créer des dossiers personnalisés, ils devraient être dans le répertoire renvoyé par getFilesDir().
La sauvegarde automatique sous Android exclut les fichiers localisés dans les répertoires renvoyés par getCacheDir(), getCodeCacheDir() et getNoBackupFilesDir(). Les fichiers enregistrés dans ces emplacements ne sont requis que temporairement, et sont intentionnellement exclus des opérations de sauvegarde.
En outre, tout dossier dans getFilesDir() nommé UnityCache ne sera pas sauvegardé.
Par défaut, ces répertoires exclus sont cache/ et UnityCache/.
Vous pouvez également personnaliser les fichiers/dossiers exclus qui n’ont pas besoin d’être sauvegardés dans le tableau de bord développeur·se, sous Développement > Stockage dans le cloud. Lorsque vous spécifiez des fichiers exclus personnalisés, gardez à l’esprit les détails suivants :
Vous ne pouvez spécifier que les chemins relatifs aux répertoires de fichiers internes/externes du paquet (ce sont les répertoires renvoyés par getFilesDir() ou getExternalFilesDir()).
Exemple : si les données que vous souhaitez exclure sont stockées sous /storage/emulated/0/Android/data/com.company.somegame/files/UE4Game/SomeGame/SomeGame/BigFiles/SomeFile.txt, alors vous spécifieriez UE4Game/SomeGame/SomeGame/BigFiles/SomeFile.txt comme chemin d’exclusion.
Si vous spécifiez une exclusion de fichiers personnalisés, tous les fichiers/dossiers correspondants seront exclus du répertoire de fichiers internes/externes. Vous ne pouvez pas spécifier le répertoire à cibler entre les deux.
Vous ne pouvez pas utiliser de caractères génériques. Les chemins doivent référencer des fichiers exacts ou des dossiers précis.
Les fichiers DLC devraient-ils être stockés dans des répertoires qui seront inclus dans la sauvegarde ?
Placez les fichiers d’enregistrement et les fichiers de configuration des DLC dans l’un des répertoires qui seront sauvegardés.
Ne placez pas de fichiers d’éléments DLC dans un répertoire de sauvegarde.
Les éléments doivent être placés dans un répertoire exclu afin qu’ils ne soient pas sauvegardés. Si la taille totale dépasse 100 Mo, la sauvegarde échouera. Même si ce n’est pas le cas, l’expérience de l’utilisateur·ice pourrait s’en trouver détériorée. Tout d’abord, l’utilisateur·ice importera beaucoup d’informations inutiles. De plus, si l’utilisateur·ice supprime l’application puis la réinstalle après une mise à jour, il ou elle perdra probablement du temps à télécharger d’anciennes versions de fichiers qui seront ensuite presque immédiatement mises à jour. La licence DLC lui permettra de télécharger à nouveau ces fichiers normalement.
Comment puis-je vérifier la date de la dernière sauvegarde de l’application ?
Vous pouvez vérifier la dernière fois qu’une application a été sauvegardée en accédant à la page Sauvegardes dans le cloud sur le site Web Meta Quest.
Vous pouvez également accéder à l’onglet Sauvegardes dans le cloud situé dans les paramètres de votre appareil Meta Quest.
Comment puis-je vérifier quels fichiers ont été inclus dans une sauvegarde ?
Vous pouvez valider quels fichiers sont inclus dans votre sauvegarde en surveillant logcat pendant que l’exécution de cette dernière. Les journaux devraient indiquer quels fichiers, ainsi que leurs tailles respectives, ont été inclus dans une sauvegarde. Cela permet de vérifier si votre application dépasse la limite de sauvegarde de 100 Mo et si vous devez vérifier quels fichiers occupent de la place dans la sauvegarde de votre application, ou si vous voulez valider que toute règle d’exclusion/inclusion de fichiers récemment implémentée fonctionne comme prévu.
Vous pouvez exécuter la commande suivante adb pour filtrer logcat afin d’obtenir uniquement les journaux liés à la sauvegarde :
adb logcat | grep Backup
Tests
Tests de sauvegarde dans le cloud
La commande shell Android bmgr peut être utilisée pour tester le système de sauvegarde. Utilisez la commande suivante pour forcer l’exécution de la sauvegarde pour un paquet spécifié.
bmgr backupnow --monitor-verbose <package-name>
La commande peut être exécutée directement depuis votre hôte local à l’aide de adb shell ou depuis une session adb shell sur votre appareil.
Vous pouvez en savoir plus sur bmgr en exécutant la commande sans options.
Important : l’option de restauration via ADB n’est pas prise en charge. Les restaurations sont effectuées automatiquement lors de l’installation d’une application. Pour transférer les données de sauvegarde vers un autre casque, désinstallez et réinstallez l’application sur cet appareil pour déclencher la restauration.
Remarque : il ne s’agit PAS de la même commande « adb backup », celle-ci n’est pas prise en charge.
Activer la sauvegarde dans le cloud sur une application en direct à des fins de test
Remarque : nous vous recommandons de faire preuve d’EXTRÊME prudence si vous envisagez de le faire, ce que nous vous déconseillons sur une application en direct.
Vous pouvez désactiver la fonctionnalité de sauvegarde et de restauration dans les paramètres de l’appareil à l’aide du bouton de Sauvegarde dans le cloud. Par défaut, elle est activée pour l’ensemble des utilisateur·ices. Vous pouvez effacer les données d’une application spécifique à l’aide d’un nouveau bouton situé dans le panneau de configuration de stockage.
Vous pouvez également désactiver la sauvegarde dans le cloud pour votre application dans le tableau de bord développeur·se. Sous Développement > Stockage dans le cloud, désactivez Activer la sauvegarde automatique dans le cloud.
Résolution des problèmes
Quelles sont les raisons courantes pour lesquelles un répertoire n’est pas sauvegardé ?
Cas courants pour les données d’applications non conformes :
Les données d’applications se trouvent dans un répertoire non pris en charge (comme un dossier personnalisé dans le répertoire racine)
Les données d’applications pour l’application sont supérieures à 100 Mo
Un répertoire contenant des données de sauvegarde a été accidentellement exclu par le développeur ou la ·développeuse
L’application doit-elle être mise à jour ou ouverte pour que la sauvegarde ait lieu ?
En général, non. Si l’application est éligible à la sauvegarde et qu’elle est conforme aux exigences (spécifiées ci-dessus), la sauvegarde s’exécutera d’elle-même.
Comment déclencher manuellement une sauvegarde (par exemple juste avant de restaurer les paramètres d’usine) ?
Les sauvegardes ad-hoc sont prises en charge tant pour les utilisateur·ices que pour les développeur·ses dans le panneau de sauvegarde dans le cloud dans les paramètres de l’appareil. Les développeur·ses peuvent également les tester à l’aide de la commande bmgr sur ADB.
Que se passe-t-il si un·e utilisateur·ice possède une ancienne version du système d’exploitation sans avoir activé son Meta Quest ? Est-il possible de l’activer pour sauvegarder ses enregistrements ?
La sauvegarde dans le cloud nécessite Meta Horizon OS v35 ou version ultérieure. Les exigences habituelles pour les mises à jour du système d’exploitation s’appliquent.
Comment supprimer un enregistrement individuel ?
Accédez au profil Cloud Backups (Sauvegardes dans le cloud). Une option de suppression s’affiche à côté de chaque enregistrement. Cliquez dessus pour supprimer les données enregistrées pour cette application du cloud. Veuillez noter que les suppressions sont permanentes. Si vous supprimez TOUTES les données sauvegardées pour cette application, elles disparaîtront du cloud. Les données sauvegardées de l’application peuvent se trouver sur plusieurs appareils. Pour supprimer complètement l’ensemble des données du cloud, vous devrez peut-être effacer les sauvegardes de cette application sur tous vos appareils.
Quelle sauvegarde est enregistrée lorsqu’un.e utilisateur.rice possède des données d’application sur plusieurs appareils ?
Chaque appareil a son propre historique de sauvegarde. Une sauvegarde générée sur un appareil n’entraînerait pas de conflit ou n’écraserait pas les sauvegardes générées sur d’autres appareils.
Combien de sauvegardes sont stockées pour chaque application ?
Chaque application stocke cinq sauvegardes maximum par appareil. En outre, les deux plus anciennes sauvegardes pour une application sont conservées jusqu’à une semaine après avoir été générées avant d’être écrasées par une nouvelle sauvegarde.
Chaque fois que je désinstalle une application, il est indiqué que mes données peuvent être perdues définitivement. Cela signifie-t-il que la sauvegarde dans le cloud ne fonctionne pas ?
Non, ce message s’affiche afin de vous prévenir. La désinstallation d’une application supprime les données locales, mais ne supprime aucune sauvegarde dans le cloud. Consultez les sauvegardes dans le cloud de votre profil ou accédez à l’onglet Sauvegardes dans le cloud dans les paramètres de l’appareil afin de confirmer que la sauvegarde dans le cloud est sûre.