Building¶

Prerequisite¶

To build the Verilog Translator tool from sources, following components must be installed:

1. Git
2. Java Development Kit (JDK) 1.11 or higher (use AdoptOpenJDK for Windows and openjdk-11-jdk for Ubuntu Linux based OS)

For project building we use Gradle system.
You can either install it, or use wrapper scripts (we use Gradle 4.10.3 in scripts).

Getting project source code¶

Clone the project Git repository and it's submodules:

$ git clone --recursive https://forge.ispras.ru/git/veritrans.git

Building and running Verilog Translator from command line¶

Two Gradle wrapper scripts are included in the project repository: one for Linux-based OS (gradlew), another for Windows OS (gradlew.bat). To make the guide uniform, a "gradle" acronym will be used in the following examples.

To compile main classes run:

gradle classes

To compile test classes run:

gradle testClasses

To run all unit tests run:

gradle test

NOTE : to list all Gradle commands run:

gradle tasks

Building and running Verilog Translator from Eclipse IDE¶

1. Install Buildship Gradle integration plugin for Eclipse IDE.
2. Create init.gradle file in the $HOME/.gradle directory and write the following to it:
   

   allprojects
   {
     apply plugin: 'eclipse'
   
     it.eclipse
     {
       classpath.downloadJavadoc = true
     }
   }
   

3. Import Verilog Translator's sources into Eclipse workspace:
• Use the menu item "File/Import...".
• Choose "Gradle/Gradle Project".
• Select the "veritrans" directory as the root directory, press "Next".
• Select the "Gradle wrapper (recommended)" import option.
• Press the "Finish" button: the project will be opened in the Eclipse IDE.