How-To CreatePlugin

1. Allocation#

Every project has to be allocated to one of the three main repositories:

2. Creating the project in Eclipse#

Creating a new Maven Module

You will see the new project in the Eclipse Project Explorer. Now you can start creating or copying source files. Using the UTF-8 encoding is mandatory

3. License Header#

Every .java file must contain the license header, starting in the first line. Be sure to have an empty line between the license and the package declaration.

The license has to look like this:

/*
 * Copyright (C) 2012 Chair of Artificial Intelligence and Applied Informatics
 * Computer Science VI, University of Wuerzburg
 * 
 * This is free software; you can redistribute it and/or modify it under the
 * terms of the GNU Lesser General Public License as published by the Free
 * Software Foundation; either version 3 of the License, or (at your option) any
 * later version.
 * 
 * This software is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
 * details.
 * 
 * You should have received a copy of the GNU Lesser General Public License
 * along with this software; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA, or see the FSF
 * site: http://www.fsf.org.
 */

4. First Check-In#

You have to perform the first check-in using the chosen main repository (d3web-core/d3web-KnowWE/Research).

Now you can enable SVN access directly for your newly created project:

To complete the process, you have to ignore target/ and .settings permanently. There are two ways to do this:

Either:

Manually adding .settings and target to svn:ignore
Or (compare with the screenshot on the right): Finally, commit the ignore settings: right click → Team → Commit. Enter a commit message like "ignores" and press Ok.

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)#

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#

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