sfdx-project.json

Die Konfigurationsdatei an der Wurzel jedes Source-Format-Projekts, die Paketverzeichnisse, Namespace und Paketabhängigkeiten deklariert.

Definition

sfdx-project.json ist die Konfigurationsdatei, die jeder Salesforce-CLI-Befehl an der Wurzel eines Source-Format-Projekts liest. Sie deklariert die Paketverzeichnisse (wo der Source liegt, und welches das Standardziel für Retrieve ist), die sourceApiVersion, den registrierten Namespace, falls vorhanden, und bei 2GP-Projekten die Liste der Pakete mit ihren Aliassen und deklarierten Abhängigkeiten von den Versionen der anderen. Sie macht einen Ordner für CLI, VS-Code-Erweiterungen und CI-Tools gleichermaßen als Salesforce-Projekt erkennbar, und sie ist die Datei, die Paket-Aliasse verfolgt, wenn neue Versionen erstellt werden, sodass ein lesbarer Name der tatsächlichen von Salesforce vergebenen Versions-ID zugeordnet wird. Eine fehlerhafte oder veraltete sfdx-project.json ist eine häufige Quelle verwirrender CLI-Fehler, besonders bei der Abhängigkeitsauflösung. Unser Salesforce-CLI-Guide behandelt die Struktur der Datei ausführlicher.

In der Praxis

So funktioniert es in Serpent

Serpent liest die sfdx-project.json eines Projekts automatisch, um Paketstruktur und Abhängigkeiten zu verstehen, und aktualisiert Paket-Aliasse und Versionsreferenzen, während Builds und Promotions stattfinden, sodass niemand die Datei nach jedem Release von Hand bearbeiten muss. Multi-Paket-Repos mit deklarierten Abhängigkeiten funktionieren genauso wie Single-Paket-Repos, ohne zusätzliche Konfiguration. Siehe die Serpent-VS-Code-Erweiterung dafür, wie sich die Projektkonfiguration mit der lokalen Entwicklung synchronisiert.

Git-Integrationseinstellungen in Serpent

Häufige Fragen