Link

Introduction


The objective of this documentation is to help you get started with using IntelliJ IDEA, an integrated development environment (IDE) provided by JetBrains.

IntelliJ IDEA is an IDE for users to write code and develop software in the Java programming language. IntelliJ IDEA has features that can assist users in their development experience.

In this guide, there will be walkthroughs for setting up three useful features in IntelliJ IDEA: version control, the CheckStyle plugin, and unit tests.


Table of Contents

  1. Is This Guide for You?
  2. Software Versions
  3. Prerequisites
  4. Mouse Conventions
  5. Typographic Conventions
  6. Conclusion

Is This Guide for You?

This guide is intended for users with basic computer skills and users that are interested in or starting to learn Java. This guide is also intended for users that are interested in or just starting out with using IntelliJ IDEA.

This guide will provide you with step-by-step instructions to set up three key tools in IntelliJ IDEA. These tools can improve your coding experience with using the IDE.

By the end of this guide, you will learn how to use IntelliJ IDEA to

  • set up version control using Git to track changes you make to a newly created Java project
  • set up a plugin called CheckStyle to help ensure that your code adheres to common rules
  • set up unit tests with JUnit to help you examine the function of particular parts of your code.

Software Versions

This guide uses IntelliJ IDEA version 2019.3 and Java 13, specifically for desktop computers or laptops with a Mac operating system.

If your computer does not have IntelliJ IDEA, you can download the latest version here.

You can also install Java 13 here.


Prerequisites

Before proceeding to the instructions in this guide, there are requirements that need to be met. Other than IntelliJ IDEA and Java 13, you will need

  • a computer with the Mac operating system
  • a mouse or trackpad and a keyboard connected to your computer
  • a connection to the Internet
  • a web browser installed on your computer (e.g. Google Chrome, Firefox)
  • an email account
  • a JetBrains account.

If you are interested in setting up version control through IntelliJ IDEA, you will also need

  • a Github account
  • an installation and set-up of Git.

Mouse Conventions

The use of click throughout this documentation will refer to the action that you will perform to execute a computer event such as selecting a button.

Any uses of click in the instructions will refer to a left click of a computer mouse or a tap of a trackpad with a single finger. Right-clicks, done through clicking the right button of the mouse or a tap of the trackpad with two fingers, will be explicitly indicated.


Typographic Conventions

The instructions in this document use the following typographic conventions:

Convention DescriptionExample
Commands:

Bolded words found in the body of the documentation represent an action that you will need to carry out.
Save, Return, Click, Press, Type, Exit
Description:

Descriptions that appear within a window will be surrounded in single quotes.
‘Enter your name’, ‘Commit message’, ‘CheckStyle version:’
Input/Output:

User input and program output will be presented in monospace font.
MyClass, Hello World!
Key terms:

Important terms will be italicized. These terms are also defined in the Glossary.
Integrated development environment, Dialog window
Button sequence:

Buttons that you will need to click will have its name enclosed with opening and closing square brackets. For a sequence of button clicks, there will be a > symbol found between the two buttons. This symbol represents the successive order of the flow of buttons.

The flow of buttons will be starting from the left and will move sequentially to the right.
[Start] > [File] > [Settings]
Main and dialog windows:

Window names will be enclosed in opening and closing quotation marks. The final word before the closing quotation marks is “Window”.

Note that the word “Window” may not actually appear in the window’s title bar but is just a marker in the documentation for windows.
“New Dialog Window”

Note icon Note: This is a note icon. When this icon appears in the documentation, it indicates that you should pay close attention to the information that follows.

Caution Icon Caution: This is a caution icon. When this icon appears in the documentation, it indicates that you should meet certain conditions before proceeding.


Conclusion

With IntelliJ IDEA’s tools for code analysis and various plugins, users can customize their IDE to fit their distinct programming needs.

This documentation will go through steps to set-up your IDE with features that can help you begin your experience working with IntelliJ IDEA.

We recommend that you start with Setting Up Version Control.