How to use PluginUpgradeTask or what should I use instead?

[Herpen Derpen]

I'm trying to perform certain actions after plugin is installed. I'm familiar with ActiveObjectsUpgradeTask, but since this action has nothing to do with database I'm looking for a more elegant solution. I found an article regarding PluginUpgradeTask, but it's heavily outdated - when I try to use component element in atlassian-plugin.xml, I'm getting following error:

atlassian-plugin.xml contains a definition of component. This is not allowed when Atlassian-Plugin-Key is set.

Linked help document describes that I shouldn't be using component element and use @Component annotation instead. This of course doesn't work.

How do I make PluginUpgradeTask work OR what should I use instead to perform actions right after my plugin is installed?

[Herpen Derpen · Accepted solution]

Turns out I didn't implement all methods from PluginUpgradeTask interface and when my IDE suggested I make my class abstract I accidentally clicked this option. I figured it out when I defined my upgrade task explicitly in spring context file and spring thrown an error. Removing abstract keyword from class declaration solved it.

So to sum up, all you really need to run upgrade task is to implement PluginUpgradeTask interface and annotate your class declaration with

@ExportAsService(PluginUpgradeTask.class)
@Component

 You don't need ExportPackage entry in pom.xml

[Italo Qualisoni [e-Core]]

@Herpen Derpen ,

Great you found what you needed!

Usually when people are looking for learning how to develop an app I recommend this open source : https://github.com/atlascommunity/jira-plugins-groovy of MyGroovy app

This repository has a lot of useful tips, 

an example of upgrade task implementation:

https://github.com/atlascommunity/jira-plugins-groovy/blob/jira8/src/main/java/ru/mail/jira/plugins/groovy/impl/upgrade/Upgrade001CreateAuditLogIssueRelation.java

How you can handle your plugin lifecycle (Start/Stop...):

https://github.com/atlascommunity/jira-plugins-groovy/blob/jira8/src/main/java/ru/mail/jira/plugins/groovy/impl/PluginLauncherImpl.java

Probably there are others source codes you can look and learn from, but this is a complete and well written example.

[Italo Qualisoni [e-Core]]

@Herpen Derpen ,

I would say you need to look in the Lifecycle https://developer.atlassian.com/server/jira/platform/plugins2-add-ons/#jira-add-on-lifecycle

I recommend you to continue this question using the Development community. there they will be able to better assist you with your query

https://community.developer.atlassian.com/

[Herpen Derpen]

Thanks for the tip regarding dev community, I didn't even know it exists.