Maintaining compatibility between plugin versions
Each FxPlug has a unique identifier (UUID). Vuo generates this unique identifier based on your composition’s Bundle Identifier, which you can set in
, under the Exporting tab. Final Cut Pro X uses this identifier to keep track of which plugin provides the effects for clips on the timeline.For example, say you release version 1.0 of a plugin, and people start using it in their Final Cut Pro X projects. Then you want to release version 1.1 of your plugin which fixes a small issue — if the new version has the same Bundle Identifier as version 1.0, then the updated plugin will automatically be used throughout people’s existing Final Cut Pro X projects when they install the plugin. You can even change the name of the plugin (
, under the General tab), and it will continue to be associated with people’s existing Final Cut Pro X projects.
Then, say, you want to release version 2.0 of your plugin, which
differs significantly from version 1. You don’t want the updated
plugin to automatically be used in people’s existing Final Cut
Pro X projects, since the changes in 2.0 might cause unwanted
appearance changes to their projects. In this case, you should
change the Bundle Identifier — for example, add a
.2
suffix, as in
com.mycompany.myplugin.2
— so people will be
able to continue using the old version of your plugin in their
existing projects, while also being able to use the new version
of your plugin when they pick it from Final Cut Pro X’s Effects,
Transitions, or Generators browser.