Mac Dev Center Mac OS X Reference Library Apple Applications: Final Cut Pro/Final Cut Express FxPlug Reference

Introduction

Defines a host method for identifying the version of a plug-in used in a project when the project was first created.

Discussion

This protocol was first released in FxPlug framework version 1.2.1.

Methods

-versionAtCreation

Returns the version number of a plug-in used in a project when project was first created.

Returns the version number of a plug-in used in a project when project was first created.

- (unsigned int)versionAtCreation;

Return Value

The version number. This is an integer that, typically, increments with each release of a plug-in. (The exact symantics are up to the plug-in developer.)

Discussion

To support versioning, each plug-in in a bundle should define its current version number as a string value with a "version" key in the plug-in's entry in the ProPlugPlugInList array in Info.plist. When a project is first created, the host application remembers the version number of each plug-in used in that project. Later, when the project is re-opened, a plug-in can query the value of -versionAtCreation and then handle any backward compatibility issues.