Déprécier (Métadonnées)

Marquer un composant de métadonnées comme n'étant plus pris en charge, sans le supprimer, afin de ne pas casser les abonnés existants qui le référencent.

Définition

Déprécier un composant de métadonnées, une classe ou une méthode Apex via l'annotation @deprecated, un champ personnalisé, ou un autre composant de package, le marque comme n'étant plus destiné à un nouvel usage sans réellement le supprimer. Supprimer un composant qu'un org abonné référence déjà casserait purement et simplement ses personnalisations, donc les managed packages privilégient la dépréciation : le composant disparaît des surfaces de développement pour du nouveau travail, comme les listes Setup ou l'autocomplétion de code, mais continue de fonctionner pour tout ce qui en dépend déjà. C'est en pratique une porte à sens unique ; une fois que des abonnés ont construit sur un composant, un ISV ne peut généralement pas le supprimer en toute sécurité tant qu'un changement de version majeure ne donne pas aux clients un chemin de migration clair pour s'en détacher. Notre guide de gestion des métadonnées couvre ce sujet aux côtés d'autres décisions liées au cycle de vie des packages.

En pratique

Comment cela fonctionne dans Serpent

La détection des dépendances de Serpent signale ce qui référence encore un composant avant qu'une équipe n'envisage de le déprécier ou de le supprimer, de sorte que la décision repose sur l'usage réel dans la base de code plutôt que sur une supposition. Voir la gestion des releases dans Serpent pour savoir comment les changements sensibles aux dépendances sont séquencés.

Tableau de bord de statut des releases dans Serpent

Questions fréquentes