Andrew Hanna

Andrew Hanna

sf package version create: Leitfaden für Salesforce-Paketversionen

sf package version create: Leitfaden für Salesforce-Paketversionen

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.

Was macht sf package version create?

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.

Was brauchen Sie, bevor Sie es ausführen?

  • Eine Dev-Hub-Org, als Standard gesetzt oder mit --target-dev-hub übergeben.
  • Ein Paket, einmalig mit sf package create angelegt und in packageAliases seiner 0Ho-ID zugeordnet.
  • Einen Package-Directory-Eintrag mit 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.

Wie erstellt man Schritt für Schritt eine Paketversion?

  1. Version festlegen. Setzen Sie in sfdx-project.json die versionNumber auf einen Wert wie 1.2.0.NEXT.
  2. Version erstellen. Führen Sie 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.
  3. Anfrage prüfen. Läuft die Wartezeit ab, liefert sf package version create report --package-create-request-id 08c... Status, Fehler und die 04t-ID.
  4. Beta testen. Installieren Sie sie in einer Scratch-Org oder Sandbox mit sf package install --package [email protected] --target-org MyScratchOrg --wait 10.
  5. Promoten. Wenn alles besteht, führen Sie sf package version promote --package [email protected] aus. Das Promoten lässt sich nicht rückgängig machen.

Welche Flags von sf package version create sind am wichtigsten?

  • --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.

Warum kann ich meine Paketversion nicht promoten?

Drei Ursachen erklären die meisten gescheiterten Promotions:

  • Sie wurde mit --skip-validation gebaut. Bauen Sie sie ohne das Flag neu.
  • Die Abdeckung fehlt oder liegt unter 75 Prozent. Ergänzen Sie Tests und bauen Sie mit --code-coverage neu. Für org-abhängige Unlocked Packages wird keine Abdeckung berechnet.
  • Die Nummer ist bereits freigegeben. Pro major.minor.patch lässt sich nur eine Version promoten, also erhöhen Sie die Nummer und bauen Sie neu.

Wie führt man sf package version create in CI aus?

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.

FAQ

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.

Ähnliche Artikel

Neugierig auf schnelleres Shipping, bevor Sie einsteigen? Sprechen wir

Unverbindlich.