-
Notifications
You must be signed in to change notification settings - Fork 2
Getting Started
Before you do anything else, you should make sure openjdk-11
is installed and configured:
sudo pacman -Sy jdk11-openjdk
sudo archlinux-java set java-11-openjdk
As usual, the windows setup is a little more up to your own discretion, but the easiest way is downloading the following installer and running it:
Unless you are using Intellij as your IDE (see below), you will need Gradle to build and run the project.
TIP: It's not a bad idea to install gradle even if you are using Intellij, as you might want to run the project from the commandline without opening up your IDE.
Simply using the latest version should be fine.
sudo pacman -Sy gradle
We can't really do better than the official installation instructions, so just follow this guide
Install the postgresql
package
sudo systemctl start postgresql.service
createdb telraam_dev
sudo -iu postgres
psql
>>> CREATE USER telraam_user WITH PASSWORD 'iAMs00perSecrEET';
>>> GRANT ALL PRIVILEGES ON DATABASE telraam_dev to telraam_user;
There is a prepackaged postgres installation by EDB which you can find [here][postres_win]
Below you can find setup instructions for the most common editors. Following these is not required to build or work on the project, but are rather highly recommended steps to make the development experience as smooth as possible. Feel free to add any instructions for more obscure editors.
If you don't know which editor/ide you would like to use, Intellij comes with the highest recommendation. It has extensive gradle integration (and it even manages your gradle install for you), a simply awesome debugger, and a very smooth linter plugin which syncs with the linter settings on the build server.
It is highly recommended to install the SonarLint
plugin. This will make sure your commits will pass the linter checks on the build server.
Just search for it in the Plugin interface.
-
Open the project folder (if you cloned the repo without providing a name, this folder will be called "Telraam")
-
Intellij should prompt you with the message that is has found a gradle script, and ask you to import it. Click
Import gradle project
.- if you missed the prompt, right-click on the
build.gradle
file and selectimport gradle project
.
- if you missed the prompt, right-click on the
-
You should now see a
Gradle
toolbar on the right side of the screen, below theAnt
andDatabase
buttons. From here you can run any gradle task that is configured.- We have provided preset Intellij run configurations in this project, which you should be able to select in the dropdown on the top left, next to the green play button.
-
Try to run the project by either selecting the
Telraam [run]
configuration and clicking the play button, or by running theTelraam->Tasks->application->run
task from the Gradle toolbar. (They do exactly the same thing.)