In this tutorial you will set up the development environment required to complete the tutorials in this course.
The instructions on this page assume you will be installing the Caplin Platform 7 on a 64-bit version of Windows 7 or Windows 10.
In this tutorial, you will install the following components:
- Oracle Java
- Gradle-compatible IDE
- Cygwin (Microsoft Windows users only)
- Microsoft Visual C++ Redistributable for Visual Studio 2015 (Microsoft Windows users only)
- Google Chrome
Follow the steps below:
- Download and install the Oracle Java 8 64-bit JDK
- Set the JAVA_HOME environment to the root of the JDK's installation directory
For detailed instructions on installing Java on Microsoft Windows, Red Hat Linux, and Mac OS, see Installing Java.
The tutorials in this course are compatible with the following IDEs:
To install Eclipse, follow the steps below:
- Download and install the Eclipse IDE for Java EE from the Eclipse IDE website.
- Launch Eclipse
- Click Help > Eclipse Marketplace
- Search for and install the Buildship Gradle Integration plugin
This section only applies if you are using Microsoft Windows. If you are using MacOS or Linux, then skip this section.
The Caplin Deployment Framework command-line tools require a Bash environment.
To install the Cygwin Bash environment for Microsoft Windows, follow the steps below:
- Download the Cygwin installer from the Cygwin website.
Run the Cygwin installer and follow the installation instructions on the Cygwin website.
When prompted by the Cygwin installer to select packages to install, select the following additional packages: zip, unzip, vim, vim-common, dos2unix, and wget.
Editing text files in Cygwin
As part of this course, you will edit several configuration files belonging to the Caplin Deployment Framework. To do this, you can use either a Cygwin editor or a Windows text editor.
Cygwin text editor
Your installation of Cygwin includes the Vim text editor, a revision of the original Vi editor. Installing the Vim package on Cygwin replaces the Vi executable with a symlink to the Vim executable, and Vim can be launched by either typing vi or vim on the command line.
If you are new to Vim, you may find the resources below useful:
Windows text editor
Set your chosen text editor to use Unix-style line endings and UTF-8 character encoding.
Your Cygwin home directory is at the following location in the Windows filesystem: C:\cygwin64\home\windows_username
Customise the Cygwin Bash shell
If you are familiar with Bash and would like to customise Cygwin's shell, edit the file .bashrc in your Cygwin home directory.
The .bashrc file already contains a comprehensive selection of customisations that are commented-out by default. Customisations you may wish to uncomment are listed below:
- alias grep='grep --color'
- alias egrep='egrep --color=auto'
- alias fgrep='fgrep --color=auto'
- alias ls='ls -hF --color=tty'
- alias dir='ls --color=auto --format=vertical'
The Windows versions of Liberator and Transformer require the Microsoft Visual C++ Redistributable for Visual Studio 2015.
To download the redistributable, see The latest supported Visual C++ downloads on the Microsoft website.
Install the Google Chrome web browser.