Plugin upgrade behavior is undefined

[frazierjason]

This plugin author couldn't find any TouchPortal developer documentation that outlines what happens when the same plugin .tpp file is reimported when it was already installed before (whether same version, newer version, or downgrade). Therefore, the behavior is undefined.

Anecdotally, it works fine, but sometimes in development the currently running plugin instance doesn't stop in time, and TP doesn't actually get it uninstalled correctly when over-installing the new one. This results in the reinstall failing to complete. The workaround is to just reinstall it again. It can be avoided by first going to the plugin settings and stopping the plugin instance, before doing the upgrade.

All issues can be avoided by opening the TP application settings, going to Plugin section, select this plugin on the right, and use the trash can icon to uninstall. The next import will be successful, and you won't lose any settings (you will lose your old plugin debug logs though).

[frazierjason]

TouchPortal plugin-general chat on Discord indicates that a reinstall of the same plugin name will completely replace the plugin's folder contents. As stated above, informally it should work, but if any trouble arises, safest to uninstall and reinstall the plugin (all settings will be retained automatically).