sfdx-project.json

Le fichier de configuration à la racine de tout projet en source format, déclarant les répertoires de packages, le namespace et les dépendances de packages.

Définition

sfdx-project.json est le fichier de configuration que lit chaque commande Salesforce CLI à la racine d'un projet en source format. Il déclare les répertoires de packages (où réside le source, et lequel est la cible par défaut pour retrieve), le sourceApiVersion, le namespace enregistré le cas échéant, et, pour les projets 2GP, la liste des packages avec leurs alias et leurs dépendances déclarées sur les versions des autres. C'est ce qui rend un dossier reconnaissable comme projet Salesforce pour le CLI, les extensions VS Code et les outils CI, et c'est le fichier qui suit les alias de package à mesure que de nouvelles versions sont créées, afin qu'un nom lisible corresponde à l'ID de version réel attribué par Salesforce. Un sfdx-project.json malformé ou obsolète est une source fréquente d'erreurs CLI déroutantes, en particulier autour de la résolution des dépendances. Notre guide Salesforce CLI détaille davantage la structure du fichier.

En pratique

Comment cela fonctionne dans Serpent

Serpent lit automatiquement le sfdx-project.json d'un projet pour comprendre la structure et les dépendances des packages, et met à jour les alias de package et les références de version au fil des builds et promotions, afin que personne n'ait à modifier le fichier à la main après chaque release. Les repos multi-packages avec dépendances déclarées fonctionnent de la même façon que les repos à package unique, sans configuration supplémentaire. Voir l'extension VS Code de Serpent pour savoir comment la configuration du projet se synchronise avec le développement local.

Paramètres d'intégration Git dans Serpent

Questions fréquentes