Difference between revisions of "IDE setup"

From Freeplane - free mind mapping and knowledge management software
(Launching the Project)
m (IDE: Eclipse)
 
(33 intermediate revisions by 7 users not shown)
Line 1: Line 1:
==Pre-requisites==
+
==Prerequisites==
  
You need to install a JDK (Java Development Kit). The usual JRE needed to run and use Freeplane is not sufficent to make developments on Freeplane.
+
Freeplane's build system is based on GRADLE. So gradle can support concerning development processing and generation of configuration files.
  
 +
Freeplane can be developed in basically any IDE (integrated development environment) like '''Eclipse''', '''IntelliJ''' and '''Netbeans'''. These IDEs provide the UI (user interface) for the whole development process, including the support for code edit, search, debugging, testing,... At the same time, no developer is forced to use any of these IDEs, but can also use e.g. '''vim''', as gradle is able to provides fitting configurations for any environment. If you use a proper IDE, configuration and manifest files are needed e.g. for debugging. They are created when executing <code>gradle</code> with the <code>build</code> parameter set.
  
 +
If you executed gradle builds for previous Freeplane versions, you should manually delete all <code>MANIFEST.MF</code> files which were generated by build scripts, they are not needed any more.
  
==Eclipse package==
 
  
Like Freeplane, Eclipse is based on an OSGI kernel. For this reason Eclipse provides very good support for developing OSGI applications:
+
==IDE: Eclipse==
  
* All Bundle properties can be managed via the project properties.
+
Eclipse can directly import Gradle files using the <code>buildship</code> plugin. Please see [[Scripting environment setup#How to set up your environment with the Eclipse Plug-ins for Gradle|the setup for scripting]], with the difference that you can use your ''freeplane'' local repository directory in stead of the ''freeplane_root'' source directory. There is no need to use the Gradle <code>cleanEclipse eclipse</code> tasks that are explained in the next paragraph. If you do, it will remove the Gradle nature from the imported Freeplane projects.
* One launch configuration for eclipse in the Freeplane sources, <tt>freeplane_devresources/eclipse/freeplane-osgi.launch</tt>, uses Eclipse' standard OSGI implementation.
 
  
''Note:'' Unlike in the "real application" it's necessary to list all plugins to load in the launch configuration. In the regularly deployed application all plugins in the <tt>plugin</tt> subdirectory are loaded. (By the way also the user's Freeplane directory is scanned for plugins in a <tt>plugin</tt> directory if this exists.)
+
Alternatively, if you want to configure Eclipse manually, all necessary eclipse project files can be generated by gradle using the <code>eclipse</code> parameter together with the <code>gradle</code> command. In effect, you should start a full and clean build using the following command:
  
Therefore you need an eclipse version with Plug-in Development Environment (PDE), for example [http://www.eclipse.org/downloads/ Eclipse for RCP and RAP Developers]
+
<pre>gradle clean build cleanEclipse eclipse</pre>
  
==Getting Started Working with Freeplane Within the Eclipse IDE==
+
This also creates an executable Freeplane application within the <code>BIN</code> folder below the current folder.
  
===Setup===
+
Now, you should start your Eclipse IDE and let it point to the base project folder (the folder where you just executed <code>gradle</code>). Up and running, you would now import the Freeplane project from the Eclipse top menu and choose ALL Freeplane project options from the import list. Now, please drop the '''freeplane_mac''' project when you don't work on a Mac. Otherwise it would cause you problems.
Specify a path to your JDK in eclipse.ini setting -vm option as described at http://wiki.eclipse.org/Eclipse.ini#Specifying_the_JVM
 
  
Make sure you have a copy of the Freeplane code - see the [[Git howto|Git How To]] for more information.
+
If you want to build and launch Freeplane for the first time in your newly configured IDE, you should look for the location of the launch configurations within Freeplane's source tree on the left side of the Eclipse window:
  
Firstly grab a copy of the newest version of Eclipse from the Eclipse homepage [http://www.eclipse.org Eclipse Home].
+
<pre>freeplane_debughelper / eclipse / freeplane.launch</pre>
  
Start up Eclipse - It should prompt you for a workspace (This is an area where your projects will be stored) have this where you set up your git home directory.
+
would be the most useful one. But there are others like <code>freeplane_debughelper/eclipse/freeplane dist.launch</code> and <code>freeplane_debughelper/eclipse/freeplane dist mac.launch</code>, which are used to launch binary distributions created by gradle build.  
  
===Importing The Projects===
+
As soon as you have once launched Freeplane as described, you will find appropriate menu items within the icons menu (RUN as well as DEBUG), from where you now can launch Freeplane for RUN or DEBUGGING purposes.
Before we can start working with Freeplane we have to "import" it as a new project:
 
* Goto : File -> Import...
 
* Under "General" -> Existing Projects into Workspace
 
* Select root directory should point to the git working directory. At this point a project list should appear ("note" if you are not developing for Apple Mac you can deselect the freeplane_mac project).
 
* Choose Finish. The projects should be added and the workspace will automatically "build".
 
  
''Note'': If at this point it complains about <tt>freeplane_ant</tt> this can also be removed as Eclipse does not ship with the correct ant version.
+
==IDE: IntelliJ==
  
===Compiling required jar files===
+
The short story:<br/>
Before the first run some auxiliary jar files should be compiled
+
IntelliJ can directly import gradle files. After the import the directory
* Run ant build in directory freeplane_framework/ant with target "build"
+
<code>freeplane_debughelper/idea/runConfigurations</code> containing run
* Refresh all projects
+
configuration files should be copied into directory <code>.idea</code>
 +
created by IntelliJ in project root. Restart IntelliJ afterwards.
  
===Launching the Project===
+
Detailed instructions:
Now that The project has been imported we need to set up the launcher:
+
=== Download and install IntelliJ [Community Edition] ===
* Goto : Run -> Run Configurations
+
* https://www.jetbrains.com/idea/download
* Locate the OSGi Framework entry.
+
* Extract in some directory
:If this entry is not there, the required Plug-in Development Environment (PDE) is missing, see above.
+
* Run .../idea-IC-VERSION/bin/idea.sh (or similar on non-GNU platforms)
* Make a local copy of the freeplane-osgi file. Call this freeplane-osgi local
 
* Upon clicking "Run" Freeplane should appear.
 
  
You are now ready for development/debugging within Eclipse.
+
** Do not import settings
 +
** Choose (any) UI theme
 +
** (optionally) Create desktop entry
 +
** (optionally) Create launcher script
 +
** Choose default plugins (you can disable some, like Android)
 +
** Do not download featured plugins
 +
** Click ''Start using IntelliJ IDEA''
  
==Settings==
+
=== Open the freeplane checkout (IntelliJ 2021) ===
In project <tt>freeplane_devresources</tt> you find
+
* Click ''Open'' (when starting IntelliJ)
* some launch configurations for starting the application
+
* Point to the ''build.gradle'' in the checkout and click ''OK'', then ''Open as Project''
* eclipse code-templates, formatter and clean-up configuration files which must be used if you contribute your code to the project.
+
* Trust project
 +
* change the project:
 +
** Enable ''Build with IntelliJ''
 +
** You will get an error due to a proected package sun.awtshell -> <br>File->Settings->Build->Compiler->Java Compiler->[ ] use Release
 +
* execute a toplevel gradle build for the command line (this is necessary for generating lexers etc.)
 +
* copy <code>freeplane_debughelper/idea/runConfigurations</code> (the whole <code>runConfigurations</code> directory!) containing run configuration files into <code>.idea</code> created by IntelliJ in project root
 +
* Restart IntelliJ afterwards.
  
==Version control integration==
+
=== Import the Freeplane build system (IntelliJ <= 2020) ===
You can use eclipse git plugin EGit. Look at [[Git howto]] for more information.
+
* Click ''Import Project'' (when starting IntelliJ)
 +
* Point to the ''settings.gradle'' in your checkout and click ''OK''
 +
** Choose settings like these:<br/>[[File:IntelliJ_import_gradle.png]]
 +
** Make sure to use an unzipped gradle binary distribution (~/Downloads/gradle-5.1.1 in this case); a gradle linux distribution package did not work for me, not even with [https://stackoverflow.com/questions/18495474/how-to-define-gradles-home-in-idea this information]
 +
* Click ''OK'' and wait
 +
* copy <code>freeplane_debughelper/idea/runConfigurations</code> (the whole <code>runConfigurations</code> directory!) containing run configuration files into <code>.idea</code> created by IntelliJ in project root
 +
* Restart IntelliJ afterwards.
  
==Useful Eclipse plugins==
+
=== Start developing Freeplane ===
* For properties files, especially for language resources, the [http://propedit.sourceforge.jp/index_en.html Properties Editor plugin] is useful. You can install the Properties Editor plugin directly within Eclipse by [http://propedit.sourceforge.jp/howto_eclipseplugin_install_en.html following these short steps].
+
* In order to run, choose ''Run->Run...->freeplane''
 +
** If the field "Use classpath for module" is empty, put '''freeplane_root.freeplane_debughelper.main''' in there
 +
* In order to debug, choose ''Run->Debug...->freeplane''
  
==Git Eclipse: troubleshooting==
+
==IDE: Netbeans==
There are 2 commons problems you can be faced to when using Git in Eclipse. Here are the solutions.
+
 
* '''At Eclipse startup''' if Eclipse displays a warning message "'''EGIT could not defined where git is installed'''", open Eclipse then go to Windows > Preferences > Team > Git > Configuration > Tab 'System Settings' and here in 'Location' you can indicate your Git installation folder. See the following page to [http://freeplane.sourceforge.net/wiki/index.php/Git_howto#Installation_.2F_Configuration install and use Git in Freeplane project].
+
Netbeans can directly import gradle files using its Gradle support plug-in.
* '''When, in Eclipse, you are running the build.xml''' stored in Freeplane_framework, you receive the following error message "'''[exec] Execute failed: java.io.IOException: Cannot run program "git" (in directory "[Directory]"): CreateProcess error=2, The system cannot find the file specified'''" resulting in a build failed. Then follow these steps in Eclipse: go to Run > External Tools > External Tools Configurations.... Then select the ant file you want to run. Then select the tab 'Environment' and click the 'New...' button to add a new variable. This new variable name should be set to PATH and the value should be the folder where Git is installed, for instance D:\AppsJavaDev\Git\bin.
+
Gradle tasks needed for running and debugging from the IDE are defined in <code>freeplane_debughelper/build.gradle</code>
  
 
[[Category:Coding]]
 
[[Category:Coding]]

Latest revision as of 20:31, 4 September 2021

Prerequisites

Freeplane's build system is based on GRADLE. So gradle can support concerning development processing and generation of configuration files.

Freeplane can be developed in basically any IDE (integrated development environment) like Eclipse, IntelliJ and Netbeans. These IDEs provide the UI (user interface) for the whole development process, including the support for code edit, search, debugging, testing,... At the same time, no developer is forced to use any of these IDEs, but can also use e.g. vim, as gradle is able to provides fitting configurations for any environment. If you use a proper IDE, configuration and manifest files are needed e.g. for debugging. They are created when executing gradle with the build parameter set.

If you executed gradle builds for previous Freeplane versions, you should manually delete all MANIFEST.MF files which were generated by build scripts, they are not needed any more.


IDE: Eclipse

Eclipse can directly import Gradle files using the buildship plugin. Please see the setup for scripting, with the difference that you can use your freeplane local repository directory in stead of the freeplane_root source directory. There is no need to use the Gradle cleanEclipse eclipse tasks that are explained in the next paragraph. If you do, it will remove the Gradle nature from the imported Freeplane projects.

Alternatively, if you want to configure Eclipse manually, all necessary eclipse project files can be generated by gradle using the eclipse parameter together with the gradle command. In effect, you should start a full and clean build using the following command:

gradle clean build cleanEclipse eclipse

This also creates an executable Freeplane application within the BIN folder below the current folder.

Now, you should start your Eclipse IDE and let it point to the base project folder (the folder where you just executed gradle). Up and running, you would now import the Freeplane project from the Eclipse top menu and choose ALL Freeplane project options from the import list. Now, please drop the freeplane_mac project when you don't work on a Mac. Otherwise it would cause you problems.

If you want to build and launch Freeplane for the first time in your newly configured IDE, you should look for the location of the launch configurations within Freeplane's source tree on the left side of the Eclipse window:

freeplane_debughelper / eclipse / freeplane.launch

would be the most useful one. But there are others like freeplane_debughelper/eclipse/freeplane dist.launch and freeplane_debughelper/eclipse/freeplane dist mac.launch, which are used to launch binary distributions created by gradle build.

As soon as you have once launched Freeplane as described, you will find appropriate menu items within the icons menu (RUN as well as DEBUG), from where you now can launch Freeplane for RUN or DEBUGGING purposes.

IDE: IntelliJ

The short story:
IntelliJ can directly import gradle files. After the import the directory freeplane_debughelper/idea/runConfigurations containing run configuration files should be copied into directory .idea created by IntelliJ in project root. Restart IntelliJ afterwards.

Detailed instructions:

Download and install IntelliJ [Community Edition]

    • Do not import settings
    • Choose (any) UI theme
    • (optionally) Create desktop entry
    • (optionally) Create launcher script
    • Choose default plugins (you can disable some, like Android)
    • Do not download featured plugins
    • Click Start using IntelliJ IDEA

Open the freeplane checkout (IntelliJ 2021)

  • Click Open (when starting IntelliJ)
  • Point to the build.gradle in the checkout and click OK, then Open as Project
  • Trust project
  • change the project:
    • Enable Build with IntelliJ
    • You will get an error due to a proected package sun.awtshell ->
      File->Settings->Build->Compiler->Java Compiler->[ ] use Release
  • execute a toplevel gradle build for the command line (this is necessary for generating lexers etc.)
  • copy freeplane_debughelper/idea/runConfigurations (the whole runConfigurations directory!) containing run configuration files into .idea created by IntelliJ in project root
  • Restart IntelliJ afterwards.

Import the Freeplane build system (IntelliJ <= 2020)

  • Click Import Project (when starting IntelliJ)
  • Point to the settings.gradle in your checkout and click OK
    • Choose settings like these:
      IntelliJ import gradle.png
    • Make sure to use an unzipped gradle binary distribution (~/Downloads/gradle-5.1.1 in this case); a gradle linux distribution package did not work for me, not even with this information
  • Click OK and wait
  • copy freeplane_debughelper/idea/runConfigurations (the whole runConfigurations directory!) containing run configuration files into .idea created by IntelliJ in project root
  • Restart IntelliJ afterwards.

Start developing Freeplane

  • In order to run, choose Run->Run...->freeplane
    • If the field "Use classpath for module" is empty, put freeplane_root.freeplane_debughelper.main in there
  • In order to debug, choose Run->Debug...->freeplane

IDE: Netbeans

Netbeans can directly import gradle files using its Gradle support plug-in. Gradle tasks needed for running and debugging from the IDE are defined in freeplane_debughelper/build.gradle