Package: Deinstallieren

Löschen eines Packages aus einer Verbindung und anschließende Aktualisierung des Package-Index.

Bezeichnung

Name

pm.Uninstall

Aliase

Uninstall

Konfiguration

Optionen

Package (package)

Name des Package

Löschung erzwingen (force)

Löscht das Package aus der Verbindung. Ohne diese Option wird das Package als veraltet markiert.

Beschreibung

Das Modul prüft zunächst, ob andere in der Verbindung installierte Packages von dem zu löschenden Package abhängig sind. Dazu wird der Index ausgelesen und die Abhängigkeiten für jedes Package aus der Metadaten-Variable des Package ausgewertet. Bestehen Abhängigkeiten, wird der Vorgang abgebrochen.

Keine Abhängigkeitsprüfung bei nicht konfiguriertem Index

Ist der Index nicht konfiguriert, wird das Package ohne Prüfung gelöscht, egal ob andere installierte Packages davon abhängig sind. Dadurch können abhängige Packages beeinträchtigt werden.

Daher ist die dringende Empfehlung den Index vor dem Löschen von Packages zu konfigurieren, um die Abhängigkeitsprüfung zu ermöglichen.

Falls keine Abhängigkeiten gefunden wurden, werden im darauf folgenden Schritt alle enthaltenen Objekte gelöscht oder als veraltet markiert. Wenn dieser Schritt erfolgreich verläuft, wird die verbliebene Ordnerstruktur gelöscht und das Package aus dem Index entfernt. Sollte es Probleme beim Löschen einzelner Objekte geben, wird eine Fehlermeldung protokolliert und der Vorgang abgebrochen. Der Index bleibt unverändert und die Ordnerstruktur des Packages bleibt erhalten, enthält aber nur noch die Objekte, welche nicht gelöscht werden konnten.

Beispiele

Ein Package als veraltet markieren. So wird das Package in den definierten Ordner (z.B. _DEPRECATED) verschoben und die Objekte entsprechend der konfigurierten Regeln umbenannt.

./b4A pm.Uninstall --package B4A.PM -C TEST-0001

Ein Package löschen.

./b4A pm.Uninstall --package B4A.PM -C TEST-0001 --force