This page (revision-80) was last changed on 25-Mar-2013 19:30 by StefanPlehn

This page was created on 17-Dec-2012 09:23 by Johanna Latt

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Page revision history

Version Date Modified Size Author Changes ... Change note
80 25-Mar-2013 19:30 6 KB StefanPlehn to previous
79 25-Mar-2013 19:29 6 KB StefanPlehn to previous | to last
78 25-Mar-2013 19:28 6 KB StefanPlehn to previous | to last
77 25-Mar-2013 19:28 6 KB StefanPlehn to previous | to last
76 25-Mar-2013 19:27 6 KB StefanPlehn to previous | to last
75 25-Mar-2013 19:27 6 KB StefanPlehn to previous | to last
74 25-Mar-2013 19:26 6 KB StefanPlehn to previous | to last
73 18-Dec-2012 15:44 6 KB Albrecht Striffler to previous | to last
72 18-Dec-2012 15:44 6 KB Albrecht Striffler to previous | to last
71 18-Dec-2012 15:43 6 KB Albrecht Striffler to previous | to last
70 18-Dec-2012 01:32 6 KB Albrecht Striffler to previous | to last
69 18-Dec-2012 01:31 6 KB Albrecht Striffler to previous | to last
68 18-Dec-2012 01:29 6 KB Albrecht Striffler to previous | to last
67 18-Dec-2012 01:29 6 KB Albrecht Striffler to previous | to last
66 18-Dec-2012 01:28 6 KB Albrecht Striffler to previous | to last
65 18-Dec-2012 00:41 6 KB Albrecht Striffler to previous | to last
64 18-Dec-2012 00:40 6 KB Albrecht Striffler to previous | to last
63 18-Dec-2012 00:39 6 KB Albrecht Striffler to previous | to last
62 17-Dec-2012 21:32 5 KB CarstenWasner to previous | to last
61 17-Dec-2012 21:31 6 KB CarstenWasner to previous | to last

Page References

Incoming links Outgoing links
How-To CreatePlugin
How-To CreatePlugin

Version management

Difference between version and

At line 4 changed 2 lines
* __d3web-KnowWe__
* __Reasearch__
* __d3web-KnowWE__
* __Research__
At line 8 changed 3 lines
* Do a right click on the main project (one of the three projects mentioned above) → New → Other… (or press Ctrl + N). In the window, select Maven → Maven Module
* Check the checkbox called "Create a simple project (skip Archetype selection)", give the project a "Module Name" and hit Next
* Enter a human-readable name into the field "Name", fill in "Description" as needed
[{Image src='New Maven Module.jpg' width='295' height='..' align='right' link='/attach/How-To%20CreatePlugin/New%20Maven%20Module.jpg' caption='Creating a new Maven Module'}]
* Do a right click on the main project (one of the three projects mentioned above) → New → Other… (or press Ctrl + N). In the window, select Maven → Maven Module and hit Next
* Check the checkbox called "Create a simple project (skip Archetype selection)", give the project a "Module Name" and hit Next (see the example on the screenshot on the right). For Plugins the module name must start with d3web-Plugin or KnowWE-Plugin.
* Enter a human-readable name into the field "Name", fill in "Description" as needed.
At line 13 removed one line
At line 20 changed one line
* Copyright (C) 2012 denkbares GmbH
* Copyright (C) 2012 Chair of Artificial Intelligence and Applied Informatics
* Computer Science VI, University of Wuerzburg
At line 40 changed 2 lines
You have to perform the first check-in using the chosen main repository (c.f. above).
* Right click the main project → Team → Commit
You have to perform the first check-in using the chosen main repository (d3web-core/d3web-KnowWE/Research).
* Right click the main project (= the one you chose from the three above) → Team → Commit
At line 43 changed one line
* Enter your commit message → Commit
* Enter your commit message (comment) → Commit
At line 50 changed one line
To complete the process, you have to ignore {{target/}} and {{.settings}} permanently.
To complete the process, you have to ignore {{target/}} and {{.settings}} permanently. There are two ways to do this:
At line 53 changed one line
Or:
[{Image src='Ignores.jpg' width='300' link='/attach/How-To%20CreatePlugin/Ignores.jpg' align='right' caption='Manually adding .settings and target to svn:ignore'}]
Or (compare with the screenshot on the right):
At line 57 changed one line
* In the new window, enter ".settings" and "target" __separated by a newline__ in the "Enter a property value:" field
* In the new window, enter {{.settings}} and {{target}} __separated by a newline__ in the "Enter a property value:" field
At line 62 added one line
Finally, commit the ignore settings: right click → Team → Commit. Enter a commit message like "ignores" and press Ok.
At line 60 changed one line
Finally, commit the ignore settings: right click → Team → Commit. Done.
!!5. Creating plugin.xml
All plugins need a plugin.xml in src/main/ressources
For creating such a file, see [Meaning of plugin.xml]
!!6. Write some code
Develop your code in src/main/java. You have to add dependencies to plugin.xml to get access to classes contained in other projects.
!!7. Testing (optional)
* Add JUnit as test dependency to your project
* Add plugin to create file for plugin manager: [How-To Initialize Plugin Manager for JUnit Tests]
* Write JUnit tests (using InitPluginManager.init())
* Run project as "maven test"
!!8. Add your project to the Application
Include the plugin as a new dependency in the pom file of KnowWE (in an existing or newly created profile). If you are another application than KnowWE, add your Plugin to the pom of your project (directly or as profile).
!!9. Selecting plugins to build
[{Image src='Run Configuration.jpg' width='300' align='right' link='/attach/How-To%20CreatePlugin/Run%20Configuration.jpg' caption='Enabling the plugins that are to be built in the Run Configuration'}]
You need to enable the plugins you want to build into KnowWE when using Eclipse. Here's how:
Open your Run Configuration for the KnowWE build by Hitting "Run As..." → "Run Configurations..." and add parameters for the plug-ins you want to have.
For instance: You want to enable the Comment plug-in. Here, you have to add a comment-plugin parameter. You can set it to an arbitrary value ('true' for instance).
See the screenshot on the right for another example.
!!Troubleshooting
!Eclipse does not catch breakpoints
Update your JDK to at least Version 6, Update 17.
!java.util.MissingResourceException: Can't find bundle for base name...
Happens after cleaning the workspace.
Solution: For each of the two maven super projects (d3web, d3web-KnowWE), select the project, right click on it, "Run as..." → "Maven package".
!Offline Build (if Artifactory is not available or you have no Internet connection)
Create a second runtime configuration for building KnowWE, just like shown here: [http://d3webwiki.informatik.uni-wuerzburg.de/Wiki.jsp?page=Workspace#section-Workspace-CreateARunConfigurationForBuildingTheWiki], just check the "Offline" checkbox.
__Note:__ Do not enable this option for your regular build, only use it if Artifactory is down or you are not connected to the internet!
!Problems with Umlauts
Tomcat can be configured in UTF-8 to handle Umlauts correctlty. Look at [http://www.jspwiki.org/wiki/BugProblemsWithGermanUmlaute]
%%tags
howto create Plugin
%
This page (revision-80) was last changed on 25-Mar-2013 19:30 by StefanPlehn Top