Deprecate (Metadaten)

Eine Metadatenkomponente als nicht mehr unterstützt kennzeichnen, ohne sie zu löschen, damit bestehende Abonnenten, die darauf verweisen, nicht kaputtgehen.

Definition

Das Deprecaten einer Metadatenkomponente, einer Apex-Klasse oder -Methode über die @deprecated-Annotation, eines Custom Fields oder einer anderen Paketkomponente, kennzeichnet sie als nicht mehr für neue Verwendung vorgesehen, ohne sie tatsächlich zu entfernen. Das Löschen einer Komponente, auf die eine Abonnenten-Org bereits verweist, würde deren Anpassungen unmittelbar zerstören, weshalb Managed Packages Deprecation bevorzugen: Die Komponente verschwindet aus Oberflächen für neue Entwicklung, etwa Setup-Listen oder Code-Vervollständigung, funktioniert aber weiterhin für alles, was bereits davon abhängt. In der Praxis ist das eine Einbahnstraße; sobald Abonnenten auf einer Komponente aufgebaut haben, kann ein ISV sie in der Regel erst sicher entfernen, wenn ein Major-Versionswechsel Kunden einen klaren Migrationspfad davon weg gibt. Unser Leitfaden zum Metadatenmanagement behandelt dies neben anderen Entscheidungen zum Paket-Lebenszyklus.

In der Praxis

So funktioniert es in Serpent

Die Abhängigkeitserkennung von Serpent markiert, was noch auf eine Komponente verweist, bevor ein Team erwägt, sie zu deprecaten oder zu entfernen, sodass die Entscheidung auf der tatsächlichen Nutzung im gesamten Codebase beruht statt auf einer Vermutung. Siehe Release-Management bei Serpent dafür, wie abhängigkeitsbewusste Änderungen sequenziert werden.

Häufige Fragen