Dennis HilkLinux Fix LabEN

Desktop, X11 und Wayland

Eine GNOME-Shell-Erweiterung scheitert nach einem Update

GNOME-Shell-API-Änderungen können Erweiterungen stören. Unterstützte Shell-Versionen vergleichen und die betroffene Erweiterung gezielt deaktivieren.

Redaktionelle Quellenprüfung: Mit den Hinweisen beginnenAnleitung teilen
Auf dieser Seite
  1. Symptome und Geltungsbereich
  2. Mögliche Ursachen
  3. Sicher prüfen
  4. Nächste Schritte nach Befund
  5. Quellen und Prüfung
  6. Verwandte Probleme

Symptome und Geltungsbereich

  • Eine Erweiterung wird nach einem Upgrade deaktiviert oder meldet einen Fehler.
  • Der Fehler verschwindet bei deaktivierter betroffener Erweiterung.

Betroffene Umgebung

GNOME Shell mit Benutzer- oder Systemerweiterungen; Befehle und unterstützte Erweiterungsstände hängen von der installierten Shell ab.

Mögliche Ursachen

Das sind mögliche Erklärungen, keine bestätigte Diagnose. Mehrere unabhängige Fehler können gleichzeitig vorliegen.

  • Die Metadaten können die installierte Shell nicht als kompatibel nennen.
  • Eine verwendete JavaScript-API oder ein Import kann sich geändert haben.

Sicher prüfen

Führe jeweils einen Befehl in der passenden Sitzung aus. Lies zuerst die Erklärung. Großgeschriebene Platzhalter brauchen deine Werte; Werkzeuge und Rechte unterscheiden sich je nach Distribution. Die Website zeigt Befehle an und führt sie niemals aus.

Prüfschritt 1

Liest die Version des installierten Shell-Programms, ohne einen neuen Desktop zu starten.

gnome-shell --version

Ergebnis einordnen: Mit der shell-version-Liste der Erweiterung vergleichen; die laufende Sitzung kann bis zur Neuanmeldung noch eine ältere Version verwenden.

Prüfschritt 2

EXTENSION_UUID durch den genauen Erweiterungsbezeichner einschließlich eines @-Zusatzes ersetzen; als Desktop-Konto ausführen.

gnome-extensions info EXTENSION_UUID

Ergebnis einordnen: Pfad, Zustand und Version lesen. Eine fehlende UUID oder ein Busfehler unterscheidet sich von einer bekannten inkompatiblen oder fehlerhaften Erweiterung.

Nächste Schritte nach Befund

Die konkret betroffene Erweiterung deaktivieren

Wenn die Erweiterung betroffen ist, nur sie mit gnome-extensions disable EXTENSION_UUID oder der Erweiterungsverwaltung deaktivieren. Den vorherigen Zustand notieren und dieselbe Desktop-Aktion prüfen; bei abweichender installierter und laufender Shell neu anmelden.

Vorsicht: Versionsprüfung nicht umgehen oder alle GNOME-Einstellungen zurücksetzen. Systemweit erzwungene Erweiterungen können administrative Regeländerungen benötigen.

Wiederherstellung / Rücknahme: Diese UUID mit gnome-extensions enable EXTENSION_UUID wieder aktivieren, sobald eine passende Version vorliegt; war sie vorher deaktiviert, diesen Zustand erhalten.

Hat dir dieser Hinweis geholfen?

Hinweis teilen#

Eine zur Shell passende Erweiterungsversion installieren

Wenn der Betreuer eine passende Version anbietet, Benutzererweiterung und betreffende Einstellungen sichern und über den offiziellen Erweiterungsdienst oder die Distribution aktualisieren. Bei Systemerweiterungen das zuständige Paket nutzen, statt Dateien manuell auszutauschen.

Vorsicht: Das Ergänzen der Shell-Version in Metadaten repariert keine geänderten APIs. Bei ungeklärter Kompatibilität die Erweiterung deaktiviert lassen.

Wiederherstellung / Rücknahme: Die gesicherte Benutzererweiterung samt Einstellungen oder einen unterstützten Paketstand herstellen; bei Inkompatibilität zur aktuellen Shell deaktiviert lassen.

Hat dir dieser Hinweis geholfen?

Hinweis teilen#

Quellen und Prüfung

Diese Anleitung basiert auf Originalquellen von Projekten oder Distributionen und wurde am genannten Datum redaktionell geprüft. Das ist eine Quellenprüfung, kein Nachweis einer auf deiner Hardware reproduzierten Lösung. Log-Beispiele sind synthetische Testdaten. Versionsabhängige Details müssen zur installierten Ausgabe passen.