Hey Leute,
immer wieder tauchen fragen auf zu Addons, welche sich nicht korrekt installieren lassen.
Dies kann passieren sowohl aus einem Repository als auch bei Addons, welche als ZIP-Datei vorliegen.
Die zwei häufigsten Fehlermeldungen sind:
1) Addon verfügt nicht über die richtige Struktur (ausschließlich Addons aus ZIP-Dateien)
Diese Fehlermeldung tritt häufig auf, wenn man sich ein Addon als ZIP direkt von einem github-Repository lädt, oder der Entwickler einen Fehler beim Einpacken des Addons gemacht hat Der Fehler kann auch bei MacOS/Safari auftreten, da der Browser die Datei automatisch entpackt. Per Definition gibt es eine bestimmte Struktur für Addons in ZIPs, welche wie folgt lauten muss:
script.addon.zip ---> script.addon (Ordner) ---> addon.xml, icon.png etc.
Wenn die oben beschriebene Fehlermeldung auftaucht, lohnt es sich einen Blick ins Innere des Archives zu werfen. Dort findet man bestimmt eine der folgenden Strukturen, welche falsch sind:
script.addon.zip ---> addon.xml, icon.png etc.
oder
script.addon.zip ---> script.addon (Ordner) ---> script.addon (Ordner) ---> addon.xml, icon.png etc.
Die Fehlermeldung kann somit durch Auspacken und korrektes Packen des ZIPs beseitigt werden. Alternativ kann der entpackte Ordner in das Userprofile kopiert werden
special://userprofile/addons
Beispiel unter Windows: %APPDATA%\Roaming\KODI\addons
Danach sollte das Addon im Addonbrowser von KODI gelistet sein und auch benutzbar (entsprechende weitergehende Kompatibilität vorausgesetzt)
2) Voraussetzung nicht erfüllt / Dependency not met
Dieser Fehler ist nicht immer so trivial zu beheben wie der vorige, da es unterschiedliche Gründe geben kann!
Jedes Addon benötigt eine addon.xml, welche definiert was das Addon ist, wie es heisst, welche Version es hat und welche Voraussetzungen es besitzt. Diese Voraussetzungen teilen sich in 2 Teile auf.
a) Allgemeine Voraussetzungen
Diese sind gebunden an die Version von KODI. Eine alte XBMC Installation in der Version 11 verwendet zum Beispiel ein anderes Python als Version 14. Wenn dort die Versionen nicht korrekt aufeinander passen, dann lässt sich das Addon nicht installieren.
Wer jetzt genau wissen will, welche Version von XBMC/KODI welche allgemeinen Voraussetzungen hat, kann ein Blick in die folgende Tabelle werfen:
| XBMC/KODI Version | xbmc.python | xbmc.gui | xbmc.json | xbmc.metadata | xbmc.addon |
| Dharma 10.1 | 1.0 | 2.11 | 2.0 | 1.0 | 0.1 |
| Eden 11 | 2.0 | 3.0 | 4.0 | 1.0 | 11.0 |
| Frodo 12.x | 2.1.0 | 4.0.0 | 6.0.0 | 2.1.0 | 12.0.0 |
| Gotham 13.x | 2.14.0 | 5.0.1 | 6.6.0 | 2.1.0 | 13.0.0 |
| Helix 14.x | 2.19.0 | 5.3.0 | 6.20.0 | 2.1.0 | 14.0.0 |
Die Dependencies in der addon.xml sehen für die allgemeinen Voraussetzungen wie folgt aus:
Beispiel eines Skins für Helix:
<requires>
<import addon="xbmc.gui" version="5.3.0"/>
</requires>Beispiel eines Video-Addons für Helix:
<requires>
<import addon="xbmc.python" version="2.1.0"/>
</requires>Sollte einer dieser Dependencies nicht korrekt aufgelöst werden, gibt es vier Möglichkeiten zur Abhilfe:
Entweder ihr installiert eine XBMC/KODI Version, welche passend für das Addon ist. Ein Update ist in den meisten Fällen sinnvoll, ein Downgrade nicht immer, das sollte man beachten!
Oder ihr nutzt den Holzhammer und passt die Version des benötigten Moduls in der addon.xml mit einem Editor an! ( ACHTUNG: Das muss nicht heissen, dass das Addon danach korrekt funktioniert! )
Ihr entpackt das Addon und verschiebt es manuell nach special://userprofile/addons
Die beste Möglichkeit ist eigentlich euch eine passende Version zu suchen, eventuell hat der Entwickler bereits eine neue, angepasste Version veröffentlicht, oder ihr müsst im Addonbrowser nach Updates suchen!
b) spezielle Abhängigkeiten zu anderen Addons
Manche Addons funktionieren nur in Verbindung mit weiteren Addons. Bei Skins tritt dies sehr häufig auf, da für erweiterte Infos oder Menüs Skripte genutzt werden, doch auch andere Addons können eine Abhängigkeit haben.
Diese Dependency findet man auch in der addon.xml und gibt Aufschluss über die benötigten Addons, welche benötigt werden, damit man das Addon installieren kann und es auch korrekt funktioniert..
Diese Abhängigkeiten sehen in der addon.xml unter anderem so aus:
Abhängigkeit eines Skins zum Skript "SkinShortcuts" zum Erstellen der Menüs:
<requires>
import addon="script.skinshortcuts" version="0.4.4"/>
</requires>Auch hier gibt es wieder mehrere Wege ans Ziel zu kommen:
Ihr löscht die Dependency einfach raus und installiert danach das Addon (Danach wird das installierte Addon mit Sicherheit nicht mehr korrekt funktionieren)
Ihr entpackt das Addon und verschiebt es manuell nach special://userprofile/addons (Danach wird das installierte Addon mit Sicherheit nicht mehr korrekt funktionieren)
Ihr installiert das benötigte Addon vor der Installation des gewünschten Addon und erfüllt somit die Dependency! ( Beste Möglichkeit )
ACHTUNG: Das Bearbeiten der addon.xml sollte nur vorgenommen werden, wenn man weiss was man macht!
mad-max