Skip to content

Import and Compile Docear

Georg Link edited this page Jan 17, 2016 · 1 revision

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

Fork Project on GitHub

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

Clone Local GitHub

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.

Project Import

  • Select General -> Existing Projects into Workspace.

Import Existing

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

Import Projects

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.

Run Ant JabRef

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

Refresh BibTex

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

Run Ant Freeplane

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

Run Ant Docear Framework

Build and Run Docear

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

Run docear-osgi

  • If the option does not show, Run Configurations…

Run Configurations

  • Select docear-osgi and Run.

Select docear-osgi

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.