
Andrew Hanna

Andrew Hanna

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.
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.
--target-dev-hub.
sf package create et
associé à son ID 0Ho dans packageAliases.
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.
sfdx-project.json, réglez
versionNumber sur une valeur comme 1.2.0.NEXT.
sf package version create --package MyPkg --installation-key-bypass
--code-coverage --wait 30. Vous devez passer --installation-key ou
--installation-key-bypass.
sf package version create report --package-create-request-id 08c...
pour obtenir le statut, les erreurs éventuelles et l'ID 04t.
sf package install --package [email protected] --target-org MyScratchOrg --wait
10.
sf package version promote --package [email protected]. La promotion est
irréversible.
--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.
Trois causes expliquent la plupart des promotions refusées :
--skip-validation.
Reconstruisez sans ce flag.
--code-coverage. La couverture n'est pas calculée
pour les packages unlocked dépendants de l'org.
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.
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.
Sans engagement.