Servoy Developer is a plugin for the Eclipse platform, so to develop the Servoy codebase an Eclipse SDK environment with Eclipse Plugin development facilities is required.
In order to get started with development on one of the open source Servoy projects, the following is required:
Warning | ||
---|---|---|
| ||
These instructions are for trunk and any future branches, but are not relevant for the Servoy 5.2 branch. For instructions how to setup for Servoy 5.2 development, see Setting Up (Servoy 5.2 branch only) |
Stoc |
---|
An installation of Servoy Developer is required in order to be able to launch Servoy Developer from source code, because the source depends on the directory structure that is present in a Servoy Developer installation.
The installer for Servoy Developer can be downloaded after login in at http://www.servoy.com/download. Running Running the installer will install Servoy Developer. For a more indepth description of installing Servoy Developer, see Installing Servoy Developer|.....|||||\ After installation, start Servoy Developer and install the SQL Explorer plugin. See \[\] for more information Download & Install Servoy Developer. Wiki Markup
...
The open source Servoy projects are all plugins for the Eclipse environment, so in order to develop on one of the projects a Eclipse version with Eclipse plugin development tools (PDE) installed is required.
The Eclipse.org download page (http://www.eclipse.org/downloads/) lists a wide range of prepackaged Eclipse distributions, one being the 'Eclipse for RPC/Plug-in Developers'. Although . See http://www.eclipse.org/downloads/packages/compare-packages for the overview of what each Eclipse distribution contains.
One of the offered distributions that includes PDE is the Eclipse Classic distribution. Although the plugin development tools can be installed in any Eclipse environment, the easiest is to download the 'Eclipse for RPC/Plug-in Developers' distribution Classic' distribution and install it.
NOTE: if you want to run the Servoy mobile client, then you also need to install the Google plugin for Eclipse from https://developers.google.com/eclipse/docs/download
Start the downloaded and installed Eclipse installation and choose or create a workspace into in which the development on the open source projects of Servoy will take place.
The After startup, the following configuration needs to be done:
Setup a variable: Go to Window > Preferences > Run/Debug > String Substitution and create a new variable named 'servoy_install' with the value of the directory where Servoy Developer is installed.
Create a classpath variable: Go to Window > Preferences > Java > Build Path > Classpath Variables and create a new variable named 'WEBSTART' with the value of of javaws.jar in the Java installation.
Setup a connection to the Servoy
...
source:
Install the "egit" eclipse plugin
Open the
...
GIT Perspective: Window > Open Perspective > Other >
...
GIT
Use the GIT Repositories view to clone the open source Servoy projects (latest 7xx branch) from the repositories at https://
...
...
The checked out projects already contain the target setup files for different platform/JVM combinations:
...
Info |
---|
Make sure to enable the checkbox "check out projects when clone is complete" in the GIT clone wizard |
Download Servoy Server libraries
In order to also be able to start debug clients from Servoy Developer launched from the source code, it is required to use the correct version of several libraries of the Servoy Application Server. The latest version of these libraries can be downloaded from the Servoy build server, located at http://build.servoy.com:8080/latest. Download all the libraries from the subdirectory for a specific branch or for trunk who's name postfix matched the value of the releaseNumber variable in the ClientVersion class of the checked-out source code and place them in the 'libs_extra' directory of the 'eclipse_target' project
Download Servoy Server plugin for running mobile
Please download the latest version of the mobile and mobileservice plugins; these can also be downloaded from the Servoy build server, located at http://build.servoy.com:8080/latest. Download the plugins from the subdirectory for trunk (currently) who's name postfix matches the value of the releaseNumber variable in the ClientVersion class. Copy these over to the the {servoyInstall}/application_server/plugins
directory without the postfix (overwrite existing mobile and mobileservice plugins if needed).
Setup the Target Platform:
...
...
...
To check if Servoy Developer runs on a 32 or 64 bit JVM follow the following steps:
verschillende target files staan voor de verschillende platformen.
Dit is de meest tricky onderdeel, want als jij bv met eclipse gewoon de 32 bits variant heb geinstalleerd
maar servoy zag dat je een 64bits jvm hebt (dat is in mijn geval zo) dan moet je dus hier de juiste target selecteren
Ben er nog niet over uit hoe we dat nu mooi kunnen doen.
Want bv als je mixed moet je ook nog de juiste jvm (32 bit of 64 bit) geconfigureerd hebben (anders kun je niet debuggen)
...
Creating a Launch Configuration: Last step in the setup of the environment is the creation of a Launch Configuration.
Note | ||
---|---|---|
| ||
When starting Servoy Developer from source code, it is most likely that a notification is shown indicating that the Servoy Application Server version should be upgraded. This message can be canceled and ignored. |
When starting a debug session, Servoy Developer will launch with settings of the Launch Configuration. By default the workspace for example that is opened is set to '/workspace', relative to the Servoy Developer installation.
To edit the launch settings, open Run > Debug Configurations > Eclipse Application > Servoy Launch and edit the settings.
Ready: After completing the steps described above, the Eclipse installation is setup correctly to launch Servoy Developer in a debug session:
*Adding other features to the target: *If additional features are required in the Servoy Developer that is launched from source code, for example an SVN Team Provider plugin, an easy way to achieve this is by adding the feature(s) to the target Definition.
{servoyInstall}/developer
is the directory to point to.{myEclipseWorkspace}/servoy_mobile/war