Getting Started - lasertrachd/LaserTracJetson GitHub Wiki

Welcome to the LaserTracJetson wiki!

This getting started guide is about the set-up of the application in your local system for development.

Installing Ubuntu

You would need a Ubuntu system for the development, so if you don't have it, please install the latest version of Ubuntu in your system either through dual boot or on a virtual machine. We recommend dual booting.

Installing Java

We use Java in our application, specifically Java Oracle JDK 14, so you might need to install it; any Oracle JDK 14+ should be fine. You can download the latest version of Oracle JDK from the official website (link). Keep in mind after you install Java, you might need to modify the path variable and add JAVA_HOME.

Installing IntelliJ IDEA

Now, We use IntelliJ IDEA as an IDE for the development. So if you don't have it in your system, you would need to install it. You can install it from this site (link) or you can install it directly from the terminal with sudo snap install intellij-idea-community --classic --edge refer to this article for more information (link)

Installing Git

As we use Git for the version control, you would need it in your system. You should already have it in Ubuntu by default, but if not, you can install it with sudo apt install git. You would need to configure it with your GitHub account, you can either use HTTPS or SSH. Here is a guide for connecting to GitHub with SSH (link). .`

Cloning the repository

After you successfully install git and everything else mentioned above, you would need to clone this repository in your system. Open the terminal in the directory you want to clone this repository in, for example, ~/integra_design/. And then depending on whether you are using HTTPS or SSH, give the following command to clone the repository: git clone https://github.com/lasertrachd/LaserTracJetson.git or git clone [email protected]:lasertrachd/LaserTracJetson.git. This will create a new directory for the cloned repository, and In our case, it would be ~/integra_design/LaserTracJetson.

Running the application for the first time

Once you have installed IntelliJ and cloned the repository, You can try to run the application with IntelliJ. First, you would need to open the project in IntelliJ, You can do that by opening the pom.xml file and selecting the open as project option. This will open the project in IntelliJ. It might take some time if you are doing it for the first time. Wait and let Maven download all the required dependencies. You can see the download progress on the bottom.

Once everything is downloaded you can go to the Maven tab on the side and run clean to clean the previous build and javafx-run to run the application. The first time when you run you might get a message like config file missing this is because you need a /home/config directory in your system. Ask your supervisor to provide you the config zip file and extract it to the /home/ you might need sudo privileges to extract.