Andrew Hanna

Andrew Hanna

sf package version create : guide des versions de packages Salesforce

sf package version create : guide des versions de packages Salesforce

sf package version create construit dans votre Dev Hub une nouvelle version installable d'un package unlocked ou managed de deuxième génération, à partir des métadonnées de votre projet. Lancez-le avec --code-coverage et sans --skip-validation si vous voulez un jour promouvoir cette version, sinon elle reste une bêta qui n'atteindra jamais la production.

Que fait sf package version create ?

La commande prend le contenu du package dans un répertoire, ou un alias de package ou un ID 0Ho, et crée une version de package dans le Dev Hub, comme le décrit la référence Salesforce CLI. Chaque version reçoit un ID unique de version de package abonné qui commence par 04t. Quand la commande se termine dans son délai d'attente, la CLI écrit un nouvel alias comme [email protected] dans la section packageAliases de sfdx-project.json.

Les nouvelles versions démarrent en bêta. Les versions bêta s'installent dans les scratch orgs et les sandboxes mais pas en production, tandis que les versions promues et publiées s'installent dans n'importe quelle org, comme le montre l'unité Trailhead sur les packages unlocked.

De quoi avez-vous besoin avant de la lancer ?

  • Une org Dev Hub, définie par défaut ou passée avec --target-dev-hub.
  • Un package, créé une fois avec sf package create et associé à son ID 0Ho dans packageAliases.
  • Une entrée de répertoire de package avec versionName et versionNumber. Le mot-clé NEXT, comme dans 1.0.0.NEXT, incrémente le numéro de build pour vous.

Vous hésitez encore sur le type de package ? Les secrets des packages managed de deuxième génération détaille les compromis, et si vous avez hérité d'un ancien package, les packages unmanaged et comment en sortir explique la marche à suivre.

Comment créer une version de package étape par étape ?

  1. Définissez la version. Dans sfdx-project.json, réglez versionNumber sur une valeur comme 1.2.0.NEXT.
  2. Créez la version. Lancez sf package version create --package MyPkg --installation-key-bypass --code-coverage --wait 30. Vous devez passer --installation-key ou --installation-key-bypass.
  3. Suivez la demande. Si le délai expire, lancez sf package version create report --package-create-request-id 08c... pour obtenir le statut, les erreurs éventuelles et l'ID 04t.
  4. Testez la bêta. Installez-la dans une scratch org ou une sandbox avec sf package install --package [email protected] --target-org MyScratchOrg --wait 10.
  5. Promouvez. Si tout passe, lancez sf package version promote --package [email protected]. La promotion est irréversible.

Quels flags de sf package version create comptent le plus ?

  • --code-coverage : exécute les tests Apex du package et enregistre la couverture. Indispensable pour promouvoir, et la promotion exige au moins 75 pour cent.
  • --skip-validation : saute les contrôles de dépendances, d'ancêtre et de métadonnées pour aller plus vite. Les versions construites ainsi ne peuvent pas être promues, et le flag ne se combine pas avec --code-coverage.
  • --async-validation : renvoie la version avant la fin de la validation, pour que les tests démarrent plus tôt en CI.
  • --definition-file : un fichier au format scratch org qui liste les fonctionnalités et paramètres d'org dont dépendent vos métadonnées.
  • --version-number et --version-name : remplacent les valeurs de sfdx-project.json pour une exécution.
  • --branch et --tag : enregistrent la branche source et un tag sur la version.
  • --post-install-script et --uninstall-script : des classes Apex exécutées après l'installation, la mise à niveau ou la désinstallation, pour les packages managed uniquement.

Pourquoi ne puis-je pas promouvoir ma version de package ?

Trois causes expliquent la plupart des promotions refusées :

  • Elle a été construite avec --skip-validation. Reconstruisez sans ce flag.
  • La couverture manque ou reste sous 75 pour cent. Ajoutez des tests et reconstruisez avec --code-coverage. La couverture n'est pas calculée pour les packages unlocked dépendants de l'org.
  • Le numéro est déjà publié. Une seule version peut être promue par major.minor.patch : incrémentez le numéro et reconstruisez.

Comment exécuter sf package version create en CI ?

Séparez deux voies. Sur les branches de fonctionnalité, --skip-validation ou --async-validation raccourcit la boucle. Sur la branche de release, construisez avec --code-coverage et la validation complète, pour que l'artefact testé soit celui que vous pouvez promouvoir. Surveillez l'allocation quotidienne de votre Dev Hub avec sf limits api display et la ligne PackageVersionCreates, car un build à chaque commit l'épuise vite.

Une installation bêta ne vaut que par les données de l'org où elle arrive. Serpent charge des données d'exemple ou masquées dans le cadre de la mise en place des environnements et des pipelines de release, si bien que scratch orgs et sandboxes rafraîchies reviennent peuplées sans script manuel, et le déploiement de données figure dans chaque offre, y compris l'offre gratuite Essentials. Consultez les tarifs de Serpent pour le contenu de chaque offre.

Une fois la version promue, le workflow de release AppExchange la mène jusqu'aux mises à niveau des abonnés. Si votre équipe livre encore avec des change sets, commencez par le playbook des change sets à la livraison continue.

FAQ

Quelle est la différence entre sf package create et sf package version create ?

sf package create enregistre le package une seule fois, avec son nom et son type. sf package version create construit chacune de ses versions installables.

Puis-je installer une version bêta en production ?

Non. Les versions bêta s'installent dans les scratch orgs et les sandboxes. Promouvez la version avant de l'installer en production.

Les packages unlocked exigent-ils 75 pour cent de couverture de code ?

Pour la promotion, oui. Vous pouvez construire une bêta sans couverture, mais elle ne pourra jamais être publiée.

Que faire si sf package version create expire ?

La demande continue dans le Dev Hub. Suivez-la avec sf package version create report et l'ID de demande 08c.

D'autres guides sur le packaging et la CI/CD vous attendent dans nos SF Guides.

Articles similaires

Curieux de livrer plus vite avant de vous lancer ? Parlons-en

Sans engagement.