Andrew Hanna

Andrew Hanna

sf package version create: gids voor Salesforce-packageversies

sf package version create: gids voor Salesforce-packageversies

sf package version create bouwt in je Dev Hub een nieuwe, installeerbare versie van een unlocked of second-generation managed package op basis van de metadata in je project. Draai het met --code-coverage en zonder --skip-validation als je die versie ooit wilt promoten, anders blijft het een bèta die nooit productie bereikt.

Wat doet sf package version create?

Het commando neemt de packageinhoud in een map, of een package-alias of 0Ho-ID, en maakt een packageversie aan in de Dev Hub, zoals de Salesforce CLI-referentie beschrijft. Elke versie krijgt een unieke subscriber package version ID die begint met 04t. Als het commando binnen de wachttijd klaar is, schrijft de CLI een nieuwe alias zoals [email protected] in de sectie packageAliases van sfdx-project.json.

Nieuwe versies starten als bèta. Bètaversies installeer je in scratch orgs en sandboxes, maar niet in productie, terwijl gepromote, vrijgegeven versies in elke org werken, zoals de Trailhead-unit over unlocked packages laat zien.

Wat heb je nodig voordat je het draait?

  • Een Dev Hub-org, ingesteld als standaard of meegegeven met --target-dev-hub.
  • Een package, eenmalig aangemaakt met sf package create en gekoppeld aan zijn 0Ho-ID in packageAliases.
  • Een package directory-item met versionName en versionNumber. Met het sleutelwoord NEXT, zoals in 1.0.0.NEXT, wordt het buildnummer automatisch opgehoogd.

Twijfel je nog over het packagetype? De geheimen van second-generation managed packages zet de afwegingen op een rij, en heb je een oud package geërfd, dan legt unmanaged packages en hoe je ervan afstapt de uitweg uit.

Hoe maak je stap voor stap een packageversie aan?

  1. Stel de versie in. Zet in sfdx-project.json de versionNumber op bijvoorbeeld 1.2.0.NEXT.
  2. Maak de versie aan. Draai sf package version create --package MyPkg --installation-key-bypass --code-coverage --wait 30. Je moet --installation-key of --installation-key-bypass meegeven.
  3. Controleer het verzoek. Is de wachttijd verstreken, draai dan sf package version create report --package-create-request-id 08c... voor de status, eventuele fouten en de 04t-ID.
  4. Test de bèta. Installeer hem in een scratch org of sandbox met sf package install --package [email protected] --target-org MyScratchOrg --wait 10.
  5. Promoot. Als alles slaagt, draai je sf package version promote --package [email protected]. Promoten kun je niet ongedaan maken.

Welke flags van sf package version create zijn het belangrijkst?

  • --code-coverage: draait de verpakte Apex-tests en slaat de dekking op. Nodig om te promoten, en promoten vereist minimaal 75 procent.
  • --skip-validation: slaat afhankelijkheids-, ancestor- en metadatacontroles over voor snelheid. Zo gebouwde versies zijn niet te promoten, en de flag gaat niet samen met --code-coverage.
  • --async-validation: geeft de versie terug voordat de validatie klaar is, zodat testen in CI eerder kan starten.
  • --definition-file: een bestand in scratch-org-stijl met de features en org-instellingen waarvan je metadata afhangt.
  • --version-number en --version-name: overschrijven sfdx-project.json voor één run.
  • --branch en --tag: leggen de bronbranch en een tag vast op de versie.
  • --post-install-script en --uninstall-script: Apex-klassen die draaien na installatie, upgrade of verwijdering, alleen voor managed packages.

Waarom kan ik mijn packageversie niet promoten?

Drie oorzaken verklaren de meeste mislukte promoties:

  • Hij is gebouwd met --skip-validation. Bouw opnieuw zonder die flag.
  • Dekking ontbreekt of ligt onder 75 procent. Voeg tests toe en bouw opnieuw met --code-coverage. Voor org-dependent unlocked packages wordt geen dekking berekend.
  • Het nummer is al vrijgegeven. Per major.minor.patch kan maar één versie gepromoot worden, dus hoog het nummer op en bouw opnieuw.

Hoe draai je sf package version create in CI?

Splits het in twee banen. Op featurebranches houdt --skip-validation of --async-validation de lus kort. Op de releasebranch bouw je met --code-coverage en volledige validatie, zodat het artefact dat je test ook het artefact is dat je kunt promoten. Houd het dagelijkse tegoed van je Dev Hub in de gaten met sf limits api display en de regel PackageVersionCreates, want een build bij elke commit verbruikt dat snel.

Een bèta-installatie is maar zo nuttig als de data in de org waar hij landt. Serpent laadt voorbeeld- of gemaskeerde data als onderdeel van de omgevingsinrichting en releasepipelines, zodat scratch orgs en ververste sandboxes gevuld terugkomen zonder handmatig script, en data deployen zit in elk plan, ook in het gratis Essentials-plan. Bekijk de prijzen van Serpent voor wat elk plan bevat.

Is een versie gepromoot, dan brengt de AppExchange-releaseworkflow hem naar subscriber-upgrades. Levert je team nog met change sets, begin dan eerst met het playbook van change sets naar continuous delivery.

FAQ

Wat is het verschil tussen sf package create en sf package version create?

sf package create registreert het package eenmalig, met naam en type. sf package version create bouwt elke installeerbare versie ervan.

Kan ik een bèta-packageversie in productie installeren?

Nee. Bètaversies installeer je in scratch orgs en sandboxes. Promoot de versie naar vrijgegeven voordat je hem in productie installeert.

Hebben unlocked packages 75 procent codedekking nodig?

Om te promoten wel. Je kunt een bèta zonder dekking bouwen, maar die kan nooit vrijgegeven worden.

Wat als sf package version create een time-out geeft?

Het verzoek loopt door in de Dev Hub. Controleer het met sf package version create report en de 08c-verzoek-ID.

Meer how-to's over packaging en CI/CD vind je in onze SF Guides.

Gerelateerde artikelen

Benieuwd naar sneller releasen voordat je instapt? Laten we praten

Vrijblijvend.