This document discusses bundling dependent plugins within a plugin's bundle that all get installed separately using an OSGi bundle repository (OBR). It explains that an OBR repository file provides a generic model for describing dependencies among resources. It provides instructions for adding plugin dependencies and package imports to a plugin's POM file to generate an OBR when building with the Atlassian Plugin SDK version 3.9 or higher. The OBR file can then be uploaded to the Atlassian Marketplace instead of just the plugin JAR file.

2. You’ve got Plugins in your Plugins
just like chocolate and peanut butter
Jonathan Doklovic
Developer Relations, Atlassian

3. But I already know how to use maven
dependencies to add other jars to my
plugin’s jar!
Your Mind Right Now

4. Using maven dependencies
to add other plugins to your
plugin’s bundle
WTF?

5. Bundling Dependent Plugins
with your Plugin that all get
Installed Separately

6. Why Is This Useful?
•• Using Common Plugin Code
Using Common Plugin Code

7. Why Is This Useful?
•• Using Common Plugin Code
Using Common Plugin Code

8. Why Is This Useful?
•• Using Common Plugin Code
Using Common Plugin Code

9. Why Is This Useful?
•• Using Common Plugin Code
Using Common Plugin Code

10. Why Is This Useful?
•• Using Common Plugin Code
Using 3rd Party Plugin Points

11. Why Is This Useful?
•• Using Common Plugin Code
Using 3rd Party Plugin Points

12. Why Is This Useful?
•• Using Common Plugin Code
Using 3rd Party Plugin Points

13. Why Is This Useful?
•• Using Common Plugin Code
Using 3rd Party Plugin Points

14. Why Is This Useful?
•• Using Common PluginPlugins
Marketplace Enabled Code

15. Why Is This Useful?
•• Using Common PluginPlugins
Marketplace Enabled Code

16. Why Is This Useful?
•• Using Common PluginPlugins
Marketplace Enabled Code

17. Why Is This Useful?
•• Using Common PluginPlugins
Marketplace Enabled Code

18. OBR
How Do We Do This?
OSGi Bundle Repository

19. OBR
How Do We Do This?
OSGi Bundle Repository

20. The OBR repository file is an XML-based
representation of bundle meta-data.
The goal is to provide a generic model for
describing dependencies among resources.
felix.apache.org

21. Atlassian dOBR
• A zip file containing OBR xml and Plugin Artifacts
• Generated by AMPS/Plugin SDK
• Used by UPM to install dependencies

22. Atlassian dOBR
• A zip file containing OBR xml and Plugin Artifacts
• Generated by AMPS/Plugin SDK
• Used by UPM to install dependencies

23. Atlassian dOBR
• A zip file containing OBR xml and Plugin Artifacts
• Generated by AMPS/Plugin SDK
• Used by UPM to install dependencies

24. Atlassian dOBR
• A zip file containing OBR xml and Plugin Artifacts
• Generated by AMPS/Plugin SDK
• Used by UPM to install dependencies

25. Creating An OBR

26. Add Stuff to your POM.xml
<plugin>
<groupId>com.atlassian.maven.plugins</groupId>
<artifactId>maven-confluence-plugin</artifactId>
...
<configuration>
...
<instructions>
<!-- just having this makes an OBR -->
</instructions>
</configuration>
</plugin>

27. Add Stuff to your POM.xml
<properties>
<my.library.version>1.0</my.library.version>
....
</properties>

28. Add Stuff to your POM.xml
<dependencies>
<dependency>
<groupId>my.company.whatever</groupId>
<artifactId>my-library</artifactId>
<version>${my.library.version}</version>
<scope>provided</scope>
</dependency>
....
</dependencies>

29. Add Stuff to your POM.xml
<configuration>
...
<!-- Specify what to bundle in the OBR -->
<pluginDependencies>
<pluginDependency>
<groupId>my.company.library</groupId>
<artifactId>my-library</artifactId>
</pluginDependency>
</pluginDependencies>
<instructions>
<!-- Specify what package to include. -->
<Import-Package>
my.company.library;version="${my.library.version}"
</Import-Package>
</instructions>
</configuration>

30. Build with SDK
• MUST use SDK 3.9+
• in ./target/ you get
• my-plugin.jar
• my-plugin.obr

31. Upload OBR to Marketplace
instead of jar

32. Resources
http://atlss.in/create-obr
http://atlss.in/marketplace-obr

33. Thank you!