
Andrew Hanna

Andrew Hanna

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.
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.
--target-dev-hub.
sf package create en gekoppeld aan zijn 0Ho-ID in
packageAliases.
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.
sfdx-project.json de
versionNumber op bijvoorbeeld 1.2.0.NEXT.
sf package version create --package MyPkg --installation-key-bypass
--code-coverage --wait 30. Je moet --installation-key of
--installation-key-bypass meegeven.
sf package version create report --package-create-request-id 08c...
voor de status, eventuele fouten en de 04t-ID.
sf package install --package [email protected] --target-org MyScratchOrg --wait
10.
sf package version promote --package [email protected]. Promoten kun je
niet ongedaan maken.
--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.
Drie oorzaken verklaren de meeste mislukte promoties:
--skip-validation. Bouw opnieuw
zonder die flag.
--code-coverage. Voor org-dependent unlocked packages wordt
geen dekking berekend.
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.
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.
Vrijblijvend.