Restauration et cache de la bibliothèque
Après la résolution, le Libraries.lock.json Le fichier de verrouillage contient le graphe de dépendances complet avec les versions exactes. Avant d'être chargées par le compilateur, les bibliothèques doivent être présentes dans le système de fichiers du projet. Le cache de bibliothèques gère cela. Si une bibliothèque est absente du cache, elle sera restaurée à partir de ses sources. Le projet ne pourra être compilé qu'après cette restauration.
cache de la bibliothèque
Le cache de la bibliothèque se trouve dans le répertoire racine du projet et porte le nom suivant : .library-cache Le répertoire racine est le dossier <project name>.fbsdev ou <project name>.fbslib Les bibliothèques sont stockées dans le cache sous forme de bibliothèques compilées. Le chemin d'accès dans le cache suit une convention fixe.
.library-cache/Company/Title/Version/Title.compiled-library
Les espaces en début et en fin de nom de fichier sont supprimés. Les caractères non autorisés dans les noms de fichiers sont remplacés par un encodage du modèle objet. Le format sur disque est identique à celui d'un dépôt de bibliothèque. Une bibliothèque pointant vers un projet de bibliothèque source via un chemin relatif n'est pas placée dans le cache. Elle sera chargée dans l'espace de travail en tant que projet modifiable.
Restauration des bibliothèques manquantes
Lors de la restauration, les bibliothèques manquantes sont stockées dans le cache de bibliothèques. Une bibliothèque est considérée comme manquante lorsqu'elle est listée dans le cache. Libraries.lock.json Le fichier est introuvable dans le cache à l'emplacement spécifié. Les bibliothèques existantes restent inchangées. Elles proviennent des sources configurées, notamment les dépôts de bibliothèques et un serveur de déploiement.
Vous pouvez utiliser le Restaurer les bibliothèques disparues La commande permet de lancer vous-même le processus de restauration. Vous devrez effectuer une restauration manuelle principalement si le fichier de verrouillage est déjà complet, mais que les bibliothèques du cache sont manquantes. Ce problème survient souvent après une extraction depuis un système de contrôle de version : le projet contient le Libraries.lock.json fichier, mais le .library-cache Le dossier n'est généralement pas archivé non plus. Une restauration permettra de récupérer l'état exact de la bibliothèque tel que défini dans le fichier de verrouillage. Il ne sera pas nécessaire de relancer la résolution.
Astuce
Lorsque vous lancez manuellement une résolution de bibliothèque, les bibliothèques sont restaurées automatiquement. Aucune restauration supplémentaire n'est nécessaire dans ce cas.