intellij community

Édition communautaire IntelliJ IDEA

Ces instructions vous aideront à créer IntelliJ IDEA Community Edition à partir du code source, qui constitue la base du développement de la plateforme IntelliJ. Les conventions suivantes seront utilisées pour faire référence aux répertoires de votre machine :

• <USER_HOME> est votre répertoire personnel.
• <IDEA_HOME> est le répertoire racine du code source IntelliJ.

Obtention du code source d'IntelliJ IDEA Community Edition

Le code source d'IntelliJ IDEA Community Edition est disponible sur github.com/JetBrains/intellij-community en clonant ou en téléchargeant un fichier zip (basé sur une branche) dans <IDEA_HOME> . La valeur par défaut est la branche principale .

La branche master contient le code source qui servira à créer la prochaine version majeure d'IntelliJ IDEA. Les noms de branche et les numéros de build des anciennes versions d'IntelliJ IDEA peuvent être trouvés sur la page des plages de numéros de build.

Ces opérations Git peuvent également être effectuées via l'interface utilisateur IntelliJ IDEA.

Astuce rapide : si l'historique complet du référentiel n'est pas nécessaire, l'utilisation d'un clone superficiel ( git clone --depth 1 ) permettra de gagner beaucoup de temps.

Sous Windows : deux options git sont requises pour extraire les sources sous Windows. Puisqu'il s'agit de toute façon d'une source courante de problèmes Git sous Windows, ces options peuvent être définies globalement (exécutez ces commandes avant de cloner l'un des référentiels intellij-community/android) :

• git config --global core.longpaths true
• git config --global core.autocrlf input

IntelliJ IDEA Community Edition nécessite des modules Android supplémentaires provenant de référentiels Git distincts. Pour cloner ces référentiels, exécutez l'un des scripts getPlugins situés dans le répertoire <IDEA_HOME> . Utilisez l'argument --shallow si l'historique complet du référentiel n'est pas nécessaire. Ces scripts clonent leurs branches principales respectives. Assurez-vous que vous êtes dans le répertoire <IDEA_HOME> lors de l'exécution de ces scripts, afin que les modules soient clonés dans le répertoire <IDEA_HOME> .

• getPlugins.sh pour Linux ou macOS.
• getPlugins.bat pour Windows.

Remarque : git checkout les référentiels intellij-community et android Git vers les mêmes branches/balises.

Création de l'édition communautaire IntelliJ

La version 2023.2 ou plus récente d'IntelliJ IDEA Community Edition ou d'IntelliJ IDEA Ultimate Edition est requise pour créer et développer la plate-forme IntelliJ.

Ouverture du code source IntelliJ pour la construction

Utilisation du fichier IntelliJ IDEA | Ouvrez , sélectionnez le répertoire <IDEA_HOME> .

• Si IntelliJ IDEA affiche une erreur concernant un plugin requis manquant ou obsolète (par exemple Kotlin), activez, mettez à niveau ou installez ce plugin et redémarrez IntelliJ IDEA.

Configuration de construction IntelliJ

1. Il est recommandé d'utiliser JetBrains Runtime 17 pour compiler le projet. Lorsque vous appelez Build Project pour la première fois, IntelliJ IDEA devrait vous suggérer de le télécharger automatiquement.
2. Si le plugin Maven est désactivé, ajoutez la variable de chemin " MAVEN_REPOSITORY " pointant vers le répertoire <USER_HOME>/.m2/repository .
3. Assurez-vous d'avoir au moins 8 Go de RAM sur votre ordinateur. Avec le strict minimum de RAM, désactivez l'option "Compiler les modules indépendants en parallèle" dans les paramètres du compilateur. Avec beaucoup plus de mémoire disponible, augmentez la « taille du tas du processus de construction local de l'utilisateur » à 3 000 - ce qui réduira considérablement le temps de compilation.

Notez qu'il est important d'utiliser la variante de JetBrains Runtime sans JCEF . Ainsi, si pour une raison quelconque le SDK jbr-17 pointe vers une installation de JetBrains Runtime avec JCEF, vous devez le modifier : assurez-vous qu'IntelliJ IDEA s'exécute en mode interne (en ajoutant idea.is.internal=true au fichier idea.properties ), accédez à l'élément jbr-17 dans Structure du projet | SDK, cliquez sur le bouton « Parcourir », choisissez l'élément « Télécharger... » et sélectionnez la version 17 et le fournisseur « JetBrains Runtime ».

Création du code source de l'application IntelliJ

Pour créer IntelliJ IDEA Community Edition à partir des sources, choisissez Build | Construisez un projet à partir du menu principal.

Pour créer des packages d'installation, exécutez la commande installers.cmd dans le répertoire <IDEA_HOME> . installers.cmd fonctionnera sur les systèmes Windows et Unix.

Les options permettant de créer des programmes d'installation sont transmises en tant que propriétés système à la commande installers.cmd . Vous pouvez trouver la liste des propriétés disponibles dans BuildOptions.kt

Exemples ( ./ doit être ajouté uniquement pour Linux/macOS) :

• Créez des programmes d'installation uniquement pour le système d'exploitation actuel : ./installers.cmd -Dintellij.build.target.os=current
• Construisez le code source de manière incrémentielle (ne construisez pas ce qui a déjà été construit auparavant) : ./installers.cmd -Dintellij.build.incremental.compilation=true

installers.cmd est utilisé uniquement pour exécuter OpenSourceCommunityInstallersBuildTarget à partir de la ligne de commande. Vous pouvez l'appeler directement depuis IDEA, voir la configuration d'exécution Build IDEA Community Installers (current OS) pour un exemple.

Environnement de construction Dockerisé

Pour créer des packages d'installation dans un conteneur Docker avec des dépendances et des outils préinstallés, exécutez la commande suivante dans le répertoire <IDEA_HOME> (sous Windows, utilisez PowerShell) :
docker run --rm -it -v ${PWD}:/community $(docker build -q . --target build_env)

Exécution d'IntelliJ IDEA

Pour exécuter IntelliJ IDEA construit à partir des sources, choisissez Exécuter | Exécutez à partir du menu principal. Cela utilisera la configuration d'exécution préconfigurée " IDEA ".

Pour exécuter des tests sur la build, appliquez ces paramètres à Run | Modifier les configurations... | Modèles | Onglet de configuration JUnit :

• Répertoire de travail : <IDEA_HOME>/bin
• Options de machine virtuelle :
  • -ea

Vous pouvez trouver d'autres informations utiles sur https://www.jetbrains.com/opensource/idea. La section « Code de contribution » de ce site décrit comment vous pouvez contribuer à IntelliJ IDEA.

Exécution d'IntelliJ IDEA sur un environnement CI/CD

Pour exécuter des tests en dehors d'IntelliJ IDEA, exécutez la commande tests.cmd dans le répertoire <IDEA_HOME> . tests.cmd fonctionnera sur les systèmes Windows et Unix.

Les options pour exécuter des tests sont transmises en tant que propriétés système à la commande tests.cmd . Vous pouvez trouver la liste des propriétés disponibles dans TestingOptions.kt

Exemples ( ./ doit être ajouté uniquement pour Linux/macOS) :

• Construisez le code source de manière incrémentielle (ne construisez pas ce qui a déjà été construit auparavant) : ./tests.cmd -Dintellij.build.incremental.compilation=true
• Exécutez un test spécifique : ./tests.cmd -Dintellij.build.test.patterns=com.intellij.util.ArrayUtilTest

tests.cmd est utilisé uniquement pour exécuter CommunityRunTestsBuildTarget à partir de la ligne de commande. Vous pouvez l'appeler directement depuis IDEA, voir exécuter tests in community pour un exemple.