It is not necessary to build ClearTK with the following tools as you can do everything from the command line with git and maven clients. However, several core developers use Eclipse along with two plugins, subclipse and m2eclipse. Specifically:
To check out ClearTK:
email@example.com:ClearTK/cleartk.gitas the URI and then click Next.
You should now see the root
cleartk project in your Eclipse workspace and all of its sub-projects.
All of the sub-projects should successfully compile.
Please close the
cleartk project by right-clicking on it and selecting “Close Project”.
All ClearTK module have tests defined in their
src/main/test directory. To run them:
It is common for some tests to fail if you have limited memory or have not installed all the classifiers in your environment. To ignore known sets of problematic tests do the following:
-Dcleartk.skipTests=long,bigMem. See the contributor FAQ for more details on flags for skipping tests.
Sometimes you may find that the projects fail to build for no apparent reason. Here are some troubleshooting tips that you can try:
Sometimes Eclipse will complain that the persisted container within a project references a missing libraries. This is an issue with workspace resolution caused by mismatches between m2(eclipse) and Eclipse. To fix it try:
(This is assuming that you use the workspace resolution feature of the m2e plugin, which automatically handles inter-project dependencies between the ClearTK sub-projects. If you are not using this feature, or if you don’t have all of the ClearTK sub-projects in your Eclipse workspace, you’ll have to build manually with maven.)
consistent-versions-plugin project is not necessary for developing ClearTK.
If you already have imported it and it is causing compile errors, then you can simply close the project as a way to ignore these errors.
To build ClearTK on the command line, you’ll need to have Git and Maven installed. For those old schoolers out there, roughly speaking, Git is a replacement for the CVS version control system, and Maven is a replacement for the Ant build system. There is a wide variety of documentation for Git and Maven online, so here we just summarize the steps you need to get going with ClearTK.
The ClearTK code is kept in a Git repository. To check out the code run:
git clone firstname.lastname@example.org:ClearTK/cleartk.git
This will create a
cleartk directory in your current directory, and fill it with the contents of the ClearTK code base.
When you check out ClearTK from the Git repository you will almost always end up with a snapshot version (e.g.
You can tell if you have a snapshot version by looking for
<version>...-SNAPSHOT</version> in the
pom.xml in the
cleartk root directory.
Snapshot versions are not deployed to the ClearTK repository, so if you try to compile from a single sub-module (e.g.
cleartk-ml), maven will not be able to find the dependencies (e.g.
However, the top level
cleartk module knows about all the snapshot versions of the sub-modules
Therefore, you can (should) always compile snapshot versions from the top level
cleartk module using:
From the top level
cleartk module, run the standard: