
Andrew Hanna

Andrew Hanna

sf package version create erstellt in Ihrem Dev Hub aus den Metadaten
Ihres Projekts eine neue, installierbare Version eines Unlocked- oder
Second-Generation-Managed-Packages. Führen Sie es mit --code-coverage und
ohne --skip-validation aus, wenn Sie diese Version jemals promoten
wollen, sonst bleibt sie eine Beta, die nie in die Produktion gelangt.
Der Befehl nimmt die Paketinhalte aus einem Verzeichnis, oder einen Paket-Alias bzw.
eine 0Ho-ID, und erstellt eine Paketversion im Dev Hub, wie die
Salesforce-CLI-Referenz
beschreibt. Jede Version erhält eine eindeutige Subscriber Package Version ID, die mit
04t beginnt. Endet der Befehl innerhalb seiner Wartezeit, schreibt die CLI einen neuen
Alias wie [email protected] in den Abschnitt packageAliases von
sfdx-project.json.
Neue Versionen starten als Beta. Beta-Versionen lassen sich in Scratch-Orgs und Sandboxes installieren, aber nicht in der Produktion, während promotete, freigegebene Versionen in jeder Org laufen, wie die Trailhead-Einheit zu Unlocked Packages zeigt.
--target-dev-hub übergeben.
sf package create angelegt und
in packageAliases seiner 0Ho-ID zugeordnet.
versionName und
versionNumber. Mit dem Schlüsselwort NEXT, etwa in
1.0.0.NEXT, wird die Build-Nummer automatisch hochgezählt.
Sie wählen noch den Pakettyp? Die Geheimnisse von Second-Generation Managed Packages zeigt die Abwägungen, und wenn Sie ein altes Paket geerbt haben, erklärt Unmanaged Packages und wie Sie davon wegkommen den Ausstieg.
sfdx-project.json die
versionNumber auf einen Wert wie 1.2.0.NEXT.
sf package version create --package MyPkg --installation-key-bypass
--code-coverage --wait 30
aus. Sie müssen entweder --installation-key oder
--installation-key-bypass angeben.
sf package version create report --package-create-request-id 08c...
Status, Fehler und die 04t-ID.
sf package install --package [email protected] --target-org MyScratchOrg --wait
10.
sf package version promote --package [email protected] aus. Das Promoten
lässt sich nicht rückgängig machen.
--code-coverage: führt die paketierten Apex-Tests aus und speichert die
Abdeckung. Zum Promoten nötig, und das Promoten verlangt mindestens 75 Prozent.
--skip-validation: überspringt Abhängigkeits-, Ancestor- und
Metadatenprüfungen zugunsten der Geschwindigkeit. So gebaute Versionen lassen sich
nicht promoten, und das Flag ist nicht mit
--code-coverage kombinierbar.
--async-validation: gibt die Version zurück, bevor die Validierung
fertig ist, damit Tests in CI früher starten.
--definition-file: eine Datei im Scratch-Org-Format mit den Features
und Org-Einstellungen, von denen Ihre Metadaten abhängen.
--version-number und --version-name: überschreiben
sfdx-project.json für einen einzelnen Lauf.
--branch und --tag: halten den Quell-Branch und ein Tag an
der Version fest.
--post-install-script und --uninstall-script:
Apex-Klassen, die nach Installation, Upgrade oder Deinstallation laufen, nur für
Managed Packages.
Drei Ursachen erklären die meisten gescheiterten Promotions:
--skip-validation gebaut. Bauen Sie sie
ohne das Flag neu.
--code-coverage neu. Für org-abhängige Unlocked
Packages wird keine Abdeckung berechnet.
Teilen Sie es in zwei Spuren. Auf Feature-Branches hält
--skip-validation oder --async-validation die Schleife kurz.
Auf dem Release-Branch bauen Sie mit --code-coverage und voller
Validierung, damit das getestete Artefakt auch das ist, das Sie promoten können.
Behalten Sie das Tageskontingent Ihres Dev Hubs mit
sf limits api display und dem Eintrag
PackageVersionCreates im Blick, denn ein Build pro Commit verbraucht es
schnell.
Eine Beta-Installation ist nur so aussagekräftig wie die Daten in der Org, in der sie landet. Serpent lädt Beispiel- oder maskierte Daten als Teil der Umgebungseinrichtung und der Release-Pipelines, sodass Scratch-Orgs und aktualisierte Sandboxes ohne manuelles Skript befüllt zurückkommen, und das Deployen von Daten ist in jedem Plan enthalten, auch im kostenlosen Essentials-Plan. Was jeder Plan umfasst, zeigen die Serpent-Preise.
Ist eine Version promotet, führt der AppExchange-Release-Workflow sie bis zum Subscriber-Upgrade. Liefert Ihr Team noch mit Change Sets aus, beginnen Sie mit dem Playbook von Change Sets zu Continuous Delivery.
Was ist der Unterschied zwischen sf package create und sf package version create?
sf package create registriert das Paket einmalig mit Name und Typ.
sf package version create baut jede installierbare Version davon.
Kann ich eine Beta-Paketversion in der Produktion installieren?
Nein. Beta-Versionen lassen sich in Scratch-Orgs und Sandboxes installieren. Promoten Sie die Version, bevor Sie sie in der Produktion installieren.
Brauchen Unlocked Packages 75 Prozent Codeabdeckung?
Zum Promoten ja. Eine Beta können Sie ohne Abdeckung bauen, freigeben lässt sie sich aber nie.
Was, wenn sf package version create in ein Timeout läuft?
Die Anfrage läuft im Dev Hub weiter. Prüfen Sie sie mit
sf package version create report und der 08c-Anfrage-ID.
Weitere Anleitungen zu Packaging und CI/CD finden Sie in unseren SF Guides.
Unverbindlich.