Installation d'extensions personnalisées
A partir de ThingWorx 10.0.0 et versions ultérieures, la plateforme s'exécute avec Apache Tomcat 11, basé sur la spécification Jakarta EE 11. Contrairement aux versions antérieures qui prenaient en charge javax.* packages, Tomcat 11 nécessite que toutes les extensions et tous les composants Web utilisent l'espace de noms jakarta.*.
Si des extensions personnalisées ThingWorx utilisent javax.*, les API ne fonctionneront plus correctement dans l'environnement ThingWorx 10.0.
Le tableau ci-dessous répertorie quelques cas d'utilisation et solutions.
|
Cas d'utilisation
|
Solution
|
||
|---|---|---|---|
|
L'importation et l'installation d'extensions personnalisées déclenchent une erreur NoClassDefFoundError.
|
Mettez à jour la balise context dans le fichier Tomcat/conf/context.xml. Pour plus d'informations, consultez l'article CS439388.
|
||
|
Mise à niveau d'une version précédente (9.4.x, 9.5.x, 9.6.x, 9.7.x) vers ThingWorx 10.0
|
Nous vous recommandons de regénérer ou de recompiler vos extensions et de les réinstaller sur ThingWorx 10.0.
|
Lorsque vous développez des extensions personnalisées pour ThingWorx, n'intégrez des bibliothèques JavaScript tierces que lorsque cela est nécessaire. Avant d'inclure une bibliothèque dans votre extension, vérifiez si ThingWorx Platform fournit déjà la bibliothèque. L'inclusion d'une version en double ou conflictuelle peut entraîner des problèmes de compatibilité, notamment lorsque différentes versions d'une même bibliothèque sont utilisées. Ces conflits peuvent entraîner un comportement inattendu ou des échecs d'application. Pour éviter de tels problèmes, utilisez les bibliothèques fournies avec ThingWorx Platform lorsque cela est possible. Vous pouvez afficher la liste des bibliothèques JavaScript utilisées par ThingWorx sous > dans le menu Gérer de Composer. Pour en savoir plus, consultez la rubrique Importation d'extensions.