Import and Compile Docear

Version

This tutorial was written by @GeorgLink on January 1, 2016 on Windows 10 Version 1115 using Eclipse Luna SR2 (4.4.2), GitHub Desktop (3.0.11), and Java version 1.8.0_66. The Docear version is 1.2.0. The Eclipse Workspace is configured to use the default Text file encoding UTF-8.

Clone Docear project from GitHub

Note: Create your own fork of Docear on GitHub https://github.com/Docear/Desktop for development. Please use Pull Requests to let us know when you have a code change for consideration.

• Fork the Docear project on GitHub

• Clone the repository locally. You can use GitHub Desktop, as shown below, or the command line.

Import Docear project to Eclipse

• In a new Eclipse workspace, right click in the Project Explorer and select Import to start the Import Project wizard.

• Select General -> Existing Projects into Workspace.

• Select the directory that Docear was cloned to. Select All projects for import.

Prepare Docear project after Import

The Docear project consists of several Java projects that were originally created with an older version of Eclipse. First, some projects need to be compiled individually. The following steps work

• Begin by running the build.xml in Jabref_Beta_2_7_Docear project as Ant Build.

• Refresh the docear_plugin_bibtex project to remove the red exclamation mark.

• Run the ant/build.xml in the freeplane project as Ant Build, because it is the most central project.

• Run the ant/build.xml in the docear_framework project as Ant Build.

Build and Run Docear

• To build and run Docear, run docear-osgi.

• If the option does not show, Run Configurations…

• Select docear-osgi and Run.

Should Docear not compile and load correctly, continue refreshing and running the build.xml as Ant Builds for individual projects and debug them, like described in the previous section.