Changes for page Creating XWiki Components

Last modified by Simon Urli on 2023/10/10

From version 76.7
edited by Sergei Kulagin
on 2022/12/26
Change comment: There is no comment for this version
To version 77.1
edited by Vincent Massol
on 2023/01/14
Change comment: Add option for redeploying

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Kulagin
1 +XWiki.VincentMassol
Content
... ... @@ -425,7 +425,7 @@
425 425  
426 426  = Deploying the Component =
427 427  
428 -Now that we have a functioning Component let's build it and deploy it to an XWiki instance. There are 2 ways.
428 +Now that we have a functioning Component let's build it and deploy it to an XWiki instance. There are 2 ways but the recommended one is using the Extension Manager.
429 429  
430 430  == Manually ==
431 431  
... ... @@ -447,7 +447,9 @@
447 447  * Inside your running XWiki instance, go to the Extension Manager in the Admin UI (e.g. ##{{{http://localhost:8080/xwiki/bin/admin/XWiki/XWikiPreferences?editor=globaladmin&section=XWiki.AddExtensions}}}##) and click on Advanced Search and enter your extension's id and version and follow the instructions. (##<groupId>:<artifactId>## , e.g: ##org.xwiki.contrib:your-extension-id##)
448 448  
449 449  {{warning}}
450 -If you want to redeploy an extension and it's already installed with the same version, the Extension Manager won't let you do so. Thus you'll need to uninstall it first using the Extension Manager. You'll also need to remove the local version (which is kept even if uninstalled) using the [[Extension Tweak>>extensions:Extension.Extension Tweak]].
450 +If you want to redeploy an extension and it's already installed with the same version, the Extension Manager won't let you do so. Thus you'll need to do one of the following:
451 +* Uninstall it using the Extension Manager and then remove the local version (which is kept even if uninstalled) using the [[Extension Tweak>>extensions:Extension.Extension Tweak]].
452 +* If you're just testing, a simple solution is to increase the version number in the POM (e.g. if had deployed version ##1.0-SNAPSHOT##, you could increase the version to ##1.0.1-SNAPSHOT##, rebuild and redeploy). Then once you're happy that it works fine, put back the original version in your source tree.
451 451  {{/warning}}
452 452  
453 453  Your component is now ready for service.

Get Connected