升级 ThingWorx 扩展时的注意事项
升级扩展时,可以使用以下最佳做法:
升级到 ThingWorx 8.4 及更高版本
JSON 库不随附于 ThingWorx 8.4 及更高版本。如果您的扩展项目需要 JSON 库,请按如下所示更新 build.gradle 文件:
在相关性块中添加以下代码:
compile group: 'org.json', name: 'json', version: '20090211'
在 gradle 文件中的任意位置添加以下代码:
repositories {
jcenter()
}
升级 Java 支持的扩展
升级 Java 支持的扩展时,可以使用以下最佳做法:
当通过导入新版本升级 Java 支持的扩展时,请重新启动平台。重新启动平台时,系统会将扩展 ZIP 文件放入队列中:
/ThingworxStorage/extensions/upgradequeue
重新启动 Tomcat 服务器后,ThingWorx 将尝试在队列中导入扩展 ZIP 文件。
在重新启动平台后检查应用程序日志,以确保成功导入所有放入队列的扩展。
可就地升级 Java 支持的复杂扩展。但是,在下列情况下,Tomcat 类加载程序不允许对 Java 支持的扩展进行就地升级:
将 Java 支持的新实体添加到 JAR 中时
在 JAR 中删除或重命名 Java 支持的实体时
在这种情况下,请考虑以下解决方法:
如果新实体的服务仅在 JavaScript 中实现,则可以创建该实体。
建议为新功能创建新扩展,并进一步创建单独的 JAR 文件。
更新的扩展会保留旧版本的功能
从先前版本中加载的类会导致扩展保留先前版本的功能。重新启动 Tomcat 以加载更新的扩展。