Kotlin Onboarding: Introduction

This course is designed for novices in Kotlin and focuses on the basic concepts of the Kotlin language.

Each lesson of the course is built in the form of a project: step by step, by completing different small tasks, you will get a finished small project in the end. At the end of each lesson, an additional similar project will be offered: it includes all the topics of the lesson but does not contain the theory part.

Note, this course does not provide a detailed explanation of the basic concepts, like variables: it just shows how to use them in Kotlin and can briefly remind you the definitions.

All topics will be accompanied by links to the official Kotlin documentation, which you can read later.

Topics covered:

the entry point for a Kotlin program;
variables;
functions;
loops;
ranges;
if expressions;
multi-row strings and string builder;
basic facts about the null safety mechanism;
basic facts about collections and lambda expressions.

After this course, you will be ready to write basic console applications in the Kotlin-like style.

Technical requirements

Before starting this course, check the following requirements.

Your computer needs to have a stable internet connection.
Git version control system needs to be installed on your computer (link to the git site: https://git-scm.com/).
Make sure that the path to the root folder of the course does not contain spaces, special characters, or non-latin characters.
Make sure that you use the EduTools plugin with version at least 2023.3.

The course is integrated into the Intellij Idea IDE, which has a community free license. You may use this license to complete the course. If you have some troubles with the course installation, fell free to contact us by email education@jetbrains.com.

Getting started

This course is available on JetBrains Marketplace and can be installed from the IntelliJ IDEA IDE directly, but you can also use this course in the course creator mode or create a course archive from the source code.

Getting started: create a course preview from the source code

You can create a course preview from the source code:

Clone this repository:

git clone https://github.com/jetbrains-academy/kotlin-onboarding-introduction.git

Build the project:
```
./gradlew build
```
Install the EduTools plugin from JetBrains Marketplace.
Create a new course preview.

Getting started: create a course archive

You can create a course archive from the source code:

Clone this repository:

git clone https://github.com/jetbrains-academy/kotlin-onboarding-introduction.git

Build the project:
```
./gradlew build
```
Install the EduTools plugin from JetBrains Marketplace.
Create a new course archive.

Run tests

To run tests locally, you just need to build the project and run the following command:

./gradlew test

The tests use the Java Reflection API under the hood to check the user tasks.

Generate GIFs

This project uses anderson for automatic GIFs generation.

To do this, you could run one of the following commands:

Run
```
./gradlew gifs:generateGifs
```
to generate all GIFs in the project.
Run
```
./gradlew gifs:generate-<lessonPackageName>
```
to generate all GIFs related to some lesson. You can find all possible values for <lessonPackageName> here.
Run
```
./gradlew gifs:generate-<lessonPackageName>-<gifConfigName>
```
to generate a specific GIF from some lesson. You can find all possible values for <gifConfigName> inside the config subfolder of the <lessonPackageName> folder.

Want to know more?

If you have questions about the course or the tasks or if you find some errors, you can ask questions and participate in discussions in repository issues.

Contribution

Please be sure to review the project's contributing guidelines to learn how to help the project.

jetbrains-academy / kotlin-onboarding-introduction

readme