In this tutorial you will set up the development environment that you will use to complete the remaining 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
- Eclipse 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.
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 to follow this course. If you are using MacOS or Linux, then skip this section.
The Caplin Deployment Framework command-line tools require a Bash shell, which is not available by default in Microsoft Windows.
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 packages below in addition to the packages selected by default:
Choose a text editor
You can use either a Cygwin text 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
When using a Windows text editor to edit files used by Cygwin, follow the advice below:
- Set your editor to use Unix-style line endings
- Access the files under your Cygwin home directory by browsing the directory C:\cygwin64\home\windows_username
Customise the Cygwin Bash shell
If you are familiar with Bash and would like to customise the 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 include:
- 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'
On Microsoft Windows, Liberator and Transformer require the Microsoft Visual C++ Redistributable for Visual Studio 2015.
For download and installation details, see Microsoft Visual C++ Redistributable for Visual Studio 2015 on the Microsoft website.
Install the Google Chrome web browser.