Package Dependency

Een gedeclareerde vereiste dat één packageversie een andere packageversie al geïnstalleerd nodig heeft voordat deze kan worden gebouwd of geïnstalleerd.

Definitie

Een package dependency is een gedeclareerde relatie in sfdx-project.json die aangeeft dat één packageversie afhankelijk is van een andere specifieke packageversie, of van een platformvereiste, die aanwezig moet zijn voordat deze kan worden aangemaakt of geïnstalleerd. Salesforce handhaaft deze declaraties strikt: je kunt geen versie van een package aanmaken die afhankelijk is van een andere totdat de versie van die dependency zelf is aangemaakt en beschikbaar is, en installers krijgen de volledige dependencyketen automatisch opgelost tijdens installatie. Dit is vooral belangrijk voor ISV's die meerdere gerelateerde packages uitleveren, een basispackage plus add-ons, waarbij de installatie- en upgradevolgorde over packages heen consistent moet blijven, anders eindigen subscriberorgs met niet-overeenkomende versies. Slecht beheerde dependencies zijn een veelvoorkomende oorzaak van kapotte builds naarmate een 2GP-packageportfolio groeit voorbij één of twee packages. Zie onze gids met 2GP-valkuilen voor veelvoorkomende dependency-valkuilen.

In de praktijk

Hoe het werkt in Serpent

Serpent lost package dependencies automatisch op en ordent ze tijdens builds en promoties, zodat een multi-packageportfolio geen handmatig bijgehouden dependencygraph of handmatige buildvolgorde nodig heeft. Wanneer een taak een package raakt met downstream-afhankelijke packages, toont Serpent de getroffen packages vóór promotie, zodat niets in de verkeerde volgorde wordt uitgeleverd. Zie 2GP CI/CD in Serpent voor hoe multi-package dependencyketens worden afgehandeld.

Serpent lost een package dependency op zodat een package pas installeert na de versie waarvan die afhankelijk is

Veelgestelde vragen