Benutzerdefinierte Erweiterungen installieren
Ab ThingWorx 10.0.0 wird die Plattform mit Apache Tomcat 11 ausgeführt, basierend auf der Jakarta EE 11-Spezifikation. Im Gegensatz zu früheren Versionen, die javax.* packages unterstützten, müssen in Tomcat 11 alle Erweiterungen und Webkomponenten den Namespace jakarta.* verwenden.
Wenn benutzerdefinierte ThingWorx Erweiterungen javax.* verwenden, funktionieren APIs in der ThingWorx 10.0 Umgebung nicht mehr ordnungsgemäß.
In der folgenden Tabelle werden einige Anwendungsfälle und Lösungen aufgeführt.
|
Anwendungsfall
|
Lösung
|
|
Beim Importieren/Installieren von benutzerdefinierten Erweiterungen wird der Fehler NoClassDefFoundError ausgelöst.
|
Aktualisieren Sie das Tag context in der Datei Tomcat/conf/context.xml. Weitere Informationen finden Sie unter CS439388.
|
|
Upgrade von vorherigen Versionen (9.4.x, 9.5.x, 9.6.x, 9.7.x) auf ThingWorx 10.0 durchführen
|
Es wird empfohlen, die Erweiterungen neu zu erstellen oder neu zu kompilieren und sie auf ThingWorx 10.0 neu zu installieren.
|
|
Sie können das Javax to JakarteEE Migration Utility ausführen, um einen Scan auf Referenzen durchzuführen und die Referenzen von javax.* zu jakarta.* zu migrieren. Weitere Informationen finden Sie unter CS442261.
|
|
Wenn Sie benutzerdefinierte Erweiterungen für ThingWorx entwickeln, integrieren Sie JavaScript-Bibliotheken von Drittanbietern nur bei Bedarf. Bevor Sie eine Bibliothek in Ihre Erweiterung einschließen, verifizieren Sie, ob die ThingWorx Platform die Bibliothek bereits bereitstellt. Das Einschließen einer doppelten oder in Konflikt stehenden Version kann zu Kompatibilitätsproblemen führen, insbesondere wenn verschiedene Versionen derselben Bibliothek verwendet werden. Diese Konflikte können zu unerwartetem Verhalten oder zu Anwendungsfehlern führen. Verwenden Sie nach Möglichkeit die Bibliotheken, die mit der ThingWorx Platform gebündelt sind, um solche Probleme zu vermeiden. Sie können die Liste der von ThingWorx in Composer verwendeten JavaScript-Bibliotheken im Menü "Verwalten" unter > anzeigen. Weitere Informationen finden Sie unter
Erweiterungen importieren.