Org-Dependent Unlocked Package

Ein Unlocked Package, das gegen Metadaten gebaut wird, die außerhalb des Pakets verbleiben, für Brownfield-Orgs, die sich nicht vollständig modularisieren lassen.

Definition

Ein Org-Dependent Unlocked Package ist eine 2GP-Unlocked-Package-Variante, die auf Metadaten außerhalb des Pakets verweisen darf, benutzerdefinierte Felder, andere Objekte, Berechtigungssätze, ohne jede einzelne davon als formale Abhängigkeit deklarieren zu müssen. Ein Standard-(Org-Independent-)Unlocked-Package muss eigenständig genug sein, um sauber in eine leere Scratch Org zu installieren; ein Org-Dependent-Package kann das nicht, da es davon ausgeht, dass die Ziel-Org bestimmte Metadaten bereits besitzt. Dieser Kompromiss macht es zum praktischen Einstiegspunkt für Teams mit einer großen, verworrenen Legacy-Org, die ihre Metadaten noch nicht sauber in unabhängige Pakete trennen können, aber trotzdem die Versionierungs- und CI/CD-Vorteile von 2GP wollen. Der Haken: Org-Dependent-Pakete lassen sich nicht in eine frische Scratch Org für isolierte Tests installieren, was begrenzt, wie viel die CI-Pipeline vor der Auslieferung an einer Version validieren kann. Siehe unseren 2GP-Fallstricke-Guide dafür, wo das Teams zum Stolpern bringt.

In der Praxis

So funktioniert es in Serpent

Serpent baut und versioniert Org-Dependent Unlocked Packages genauso wie jeden anderen 2GP-Pakettyp, nach Aufgabe verfolgt, mit Abhängigkeitsbewusstsein promotet, ohne dass ein Team sf package version create von Hand skripten muss. Da Org-Dependent-Pakete sich nicht sauber in einer leeren Scratch Org validieren lassen, laufen Serpents Preflight-Checks stattdessen gegen eine repräsentative Sandbox und fangen fehlende Abhängigkeiten ab, bevor ein echtes Deployment das tut. Siehe 2GP CI/CD in Serpent dafür, wie beide Pakettypen in dieselbe Pipeline passen.

Häufige Fragen