Migrating to Atlassian Plugin Framework 3
This page gives guidelines for migrating your plugin to version 3.x of the Atlassian Plugin Framework.
The version number of Atlassian Plugin Framework
The new major version number of the Atlassian Plugin Framework means some plugins that import
com.atlassian.plugin* packages will break.
Most plugins will import with a version set like this:
These will be fine. Some, however, will have their import set like this:
These will break.
To avoid this, change the import version for the second pattern –
[2.8,4.0) – since we don't plan to break any APIs in the
3.x cycle of the plugin framework.
The default constructor of
This constructor was removed. A number of our own module descriptors were using the default constructor. That means their modules were using the
LegacyModuleFactory, which is not the module factory configured for their products. In most cases, to fix this you just need to change the constructor. Sometimes you need to make small changes in the module descriptor when loading module classes, and add an actual
component-import for the module factory exposed by the host product.
com.atlassian.plugin.util.collect.CollectionUtil (previously deprecated)
This class doesn't bring anything that G
uava doesn't. We have now removed it, in favor of using
Web Resource and Web Fragment split
The following two modules have been split into their own repositories, with their own version control:
This means that those libraries don't necessarily have the same version as the Atlassian Plugin Framework any more. They are usually already declared in the product POMs. If not you will need to declare them.