====== Premiers pas avec Intellij ======


===== Premier projet =====

On utilise Intellij IDEA CE. On supposera que c'est votre première utilisation du Logiciel. Vous êtes donc devant une fenêtre intitulée **"Welcome to Intellij IDEA**". Cliquez sur **"Create new project**".

==== Installer un JDK  ====

Commencez par installer Java et son JDK sur votre ordinateur. Nous utiliserons ici le JDK 1.8 d'Oracle :
  - vous pouvez le télécharcher ici : [[http://www.oracle.com/technetwork/java/javase/downloads/index.html]]. Cliquez sur le bouton JDK/ Download. Puis choisissez le JDK adapté à votre système. 
  - Une fois téléchargé, installez le.

==== Choix du JDK  ====

  - Langage et SDK : choisir **"Java"**
  - Si pas de JDK cliquer sur **"new..."**. Intellij doit vous amener à un endroit où est installé la JDK par défaut "/usr/jvm"). Cliquez sur la JDK 1.8
  - cliquer sur **"Next"**

==== Choix du type de projet  ====

On configure sommairement le projet :
  - On coche **"Create project from template"** et sélectionnez  **"Command Line App"** si nécessaire
  - cliquez sur **"Next"**
  - Choix du repertoire et du nom de projet
  - Base Package : **"com.mco"**
  - cliquez sur **"finish"**

==== L'interface  ====

Vous devez vous retrouvez avec un fichier **"Main.java"** et des choses d'écrites.

En cliquant sur **"view >> Tool windows >> Project"** vous verrez l'architecture de votre projet. 

L'explorateur de fichier vous montre que votre fichier ''Main.java'' se trouve dans le répertoire **"src >> com >> mco"** qui est le nom de votre package. Cela permet de ranger vos sources selon l'usage et avoir ainsi plusieurs fois le même nom de classe selon l'usage (i.e. le nom du package). 

Intellij factorise tout seul le nom. Votre application commence après src. Le nom du package fait partie de l'application (cf. le répertoire out de Intellij)

Les bibliothèques externes vous montrent pour l'instant les bibliothèques du JDK

===== On remplit le fichier =====

Comme on a choisi **"Command Line App"** lors de la création du projet, Intellij a créé un fichier ''Main.java'' et y a écrit le code suivant :

<code java>
package com.mco;

public class Main {

    public static void main(String[] args) {
	// write your code here
    }
}
</code>

Ecrivez la ligne suivante là où on vous dit de le faire : 

<code java>
System.out.println("Hello World!");
</code>

Vous pouvez exécuter le code grâce au menu **"Run"**. Cela vous affiche <code terminal>Hello World!</code> dans la fenêtre console située au bas de l'éditeur.

===== Les Menus =====
  * **Navigate** permet de rechercher des fichiers, classes etc
  * **Refactor** permet de modifier des noms de modules dans tout un projet, des noms de variables dans une fonction ou un fichier, à l'aide d'une seule manipulation.
  * **Run** permet d'executer un fichier ou tout le projet.

==== Le menu File ====
Le menu File permet bien évidemment d'ouvrir/fermer un fichier, un projet...
Cependant c'est aussi là que se trouve les options de configuration de IntelliJ dans le sous-menu "**Settings**" ou bien à l'aide de la combinaison "**Ctrl + Alt + S**".

Voici une manipulation qui nous simplifiera la vie plus tard :
  - Allez dans **"Settings >> Editor >> General >> Appearance"** puis cochez "**Show line numbers**"


===== Des raccourcis qui simplifient la vie =====

Intellij est préconfiguré avec de nombreux raccourcis. Vous pouvez y accéder dans **"Settings >> Appearance and Behavior >> Keymap"**. Vous pouvez alors modifier les combinaisons ou bien consulter celles qui existent.

Quelques raccourcis par défaut utiles:
  * Commenter une ligne ou un bloc: ''Ctrl + /'' (Utiliser le "/" du pavé numérique)
  * Rechercher ''Ctrl + F''
  * Exécuter le fichier actuel: ''Maj + F10''
  * Exécuter tout le projet: ''Alt + Maj + F10''

Dans **"Settings >> Editor >> Live Templates"** se trouvent également des raccourcis de commandes. Par exemple en tapant "sout" puis la touche tabulation l'éditeur écrit : <code Java>System.out.println();</code> et se place au bon endroit pour écrire une chaine de caractères.

===== Rédacteurs ===== 

  * François Brucker