intellij community

IntelliJ IDEA Community Edition

Эти инструкции помогут вам собрать IntelliJ IDEA Community Edition из исходного кода, который является основой для разработки платформы IntelliJ. Для обозначения каталогов на вашем компьютере будут использоваться следующие соглашения:

• <USER_HOME> — ваш домашний каталог.
• <IDEA_HOME> — это корневой каталог исходного кода IntelliJ.

Получение исходного кода IntelliJ IDEA Community Edition

Исходный код IntelliJ IDEA Community Edition доступен на github.com/JetBrains/intellij-community путем клонирования или загрузки zip-файла (на основе ветки) в <IDEA_HOME> . По умолчанию используется главная ветка.

Основная ветка содержит исходный код, который будет использоваться для создания следующей основной версии IntelliJ IDEA. Названия ветвей и номера сборок для более старых версий IntelliJ IDEA можно найти на странице Диапазоны номеров сборок.

Эти операции Git также можно выполнять через пользовательский интерфейс IntelliJ IDEA.

Совет по скорости: если полная история репозитория не нужна, то использование поверхностного клона ( git clone --depth 1 ) сэкономит значительное время.

В Windows: для извлечения исходных кодов в Windows необходимы две опции git. Поскольку в любом случае это распространенный источник проблем с Git в Windows, эти параметры можно установить глобально (выполните эти команды перед клонированием любого из репозиториев intellij-community/android):

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

IntelliJ IDEA Community Edition требует дополнительных модулей Android из отдельных репозиториев Git. Чтобы клонировать эти репозитории, запустите один из скриптов getPlugins , расположенных в каталоге <IDEA_HOME> . Используйте аргумент --shallow , если полная история репозитория не требуется. Эти сценарии клонируют соответствующие главные ветки. При запуске этих сценариев убедитесь, что вы находитесь внутри каталога <IDEA_HOME> , чтобы модули клонировались внутри каталога <IDEA_HOME> .

• getPlugins.sh для Linux или macOS.
• getPlugins.bat для Windows.

Примечание. Всегда git checkout репозитории intellij-community и android Git по одним и тем же веткам/тегам.

Создание IntelliJ Community Edition

Для сборки и разработки платформы IntelliJ требуется версия IntelliJ IDEA Community Edition или IntelliJ IDEA Ultimate Edition 2023.2 или новее.

Открытие исходного кода IntelliJ для сборки

Использование файла IntelliJ IDEA | Откройте , выберите каталог <IDEA_HOME> .

• Если IntelliJ IDEA отображает ошибку об отсутствующем или устаревшем необходимом плагине (например, Kotlin), включите, обновите или установите этот плагин и перезапустите IntelliJ IDEA.

Конфигурация сборки IntelliJ

1. Для компиляции проекта рекомендуется использовать JetBrains Runtime 17. Когда вы вызываете Build Project в первый раз, IntelliJ IDEA предложит загрузить его автоматически.
2. Если плагин Maven отключен, добавьте переменную пути « MAVEN_REPOSITORY », указывающую на каталог <USER_HOME>/.m2/repository .
3. Убедитесь, что на вашем компьютере установлено не менее 8 ГБ оперативной памяти. При минимальном объеме ОЗУ отключите опцию «Компилировать независимые модули параллельно» в настройках компилятора. Имея значительно больше доступной памяти, увеличьте «Размер кучи процесса локальной сборки» до 3000 — это значительно сократит время компиляции.

Обратите внимание, что важно использовать вариант JetBrains Runtime без JCEF . Итак, если по какой-то причине jbr-17 SDK указывает на установку JetBrains Runtime с JCEF, вам необходимо изменить ее: убедиться, что IntelliJ IDEA работает во внутреннем режиме (добавив idea.is.internal=true в файл idea.properties ). ), перейдите к элементу jbr-17 в структуре проекта | SDK, нажмите кнопку «Обзор», выберите пункт «Загрузить...» и выберите версию 17 и поставщика «JetBrains Runtime».

Создание исходного кода приложения IntelliJ

Чтобы собрать IntelliJ IDEA Community Edition из исходного кода, выберите «Сборка | Создать проект из главного меню.

Чтобы собрать установочные пакеты, запустите команду installers.cmd в каталоге <IDEA_HOME> . installers.cmd будет работать как в системах Windows, так и в Unix.

Параметры сборки установщиков передаются в качестве системных свойств команде installers.cmd . Список доступных свойств вы можете найти в BuildOptions.kt.

Примеры ( ./ следует добавлять только для Linux/macOS):

• Сборка установщиков только для текущей операционной системы: ./installers.cmd -Dintellij.build.target.os=current
• Постройте исходный код постепенно (не собирайте то, что уже было создано ранее): ./installers.cmd -Dintellij.build.incremental.compilation=true

installers.cmd используется только для запуска OpenSourceCommunityInstallersBuildTarget из командной строки. Вы можете вызвать его непосредственно из IDEA, см. пример запуска конфигурации Build IDEA Community Installers (current OS) .

Докеризованная среда сборки

Чтобы собрать установочные пакеты внутри контейнера Docker с предустановленными зависимостями и инструментами, выполните следующую команду в каталоге <IDEA_HOME> (в Windows используйте PowerShell):
docker run --rm -it -v ${PWD}:/community $(docker build -q . --target build_env)

Запуск IntelliJ IDEA

Чтобы запустить IntelliJ IDEA, созданную из исходного кода, выберите «Выполнить» | Запуск из главного меню. При этом будет использоваться предварительно настроенная конфигурация запуска « IDEA ».

Чтобы запустить тесты в сборке, примените эти настройки к элементу «Выполнить | Редактировать конфигурации... | Шаблоны | Вкладка конфигурации JUnit :

• Рабочий каталог: <IDEA_HOME>/bin
• Опции ВМ:
  • -ea

Другую полезную информацию вы можете найти по адресу https://www.jetbrains.com/opensource/idea. В разделе «Внести код» на этом сайте описывается, как вы можете внести свой вклад в IntelliJ IDEA.

Запуск IntelliJ IDEA в среде CI/CD

Чтобы запустить тесты вне IntelliJ IDEA, запустите tests.cmd в каталоге <IDEA_HOME> . tests.cmd будет работать как в системах Windows, так и в Unix.

Параметры запуска тестов передаются в качестве системных свойств tests.cmd . Список доступных свойств вы можете найти в TestingOptions.kt.

Примеры ( ./ следует добавлять только для Linux/macOS):

• Постройте исходный код постепенно (не собирайте то, что уже было создано ранее): ./tests.cmd -Dintellij.build.incremental.compilation=true
• Запустите специальный тест: ./tests.cmd -Dintellij.build.test.patterns=com.intellij.util.ArrayUtilTest

tests.cmd используется только для запуска CommunityRunTestsBuildTarget из командной строки. Вы можете вызвать его непосредственно из IDEA, см. пример запуска tests in community .