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.