Установка

Системные требования

Убедитесь, что ваш компьютер отвечает следующим требованиям:

  • 64-разрядная операционная система: Windows, Linux или macOS.

  • Оперативная память – не менее 16 ГБ.

  • Свободное место на жестком диске – не менее 20 GB.

Установка Jmix Studio

Jmix Studio реализована как плагин для Java IDE: IntelliJ IDEA или OpenIDE. Минимальная поддерживаемая версия IDE – 2025.3.

После установки IDE, выполните следующие действия:

  1. Запустите IDE.

  2. На стартовом экране IDE перейдите в секцию Plugins.

  3. Если вы используете IntelliJ IDEA и загрузка плагинов из стандартного репозитория недоступна:

    • Выберите настройки (шестеренка в правом верхнем углу), далее Manage Plugin Repositories.

    • Добавьте адрес https://storage.jmix.ru/jmix-studio/release/updatePlugins-release.xml в список репозиториев.

    • Нажмите OK и перезапустите IntelliJ IDEA.

    • Снова перейдите в секцию Plugins и переключитесь на вкладку Marketplace.

  4. Введите "Jmix" в поисковое поле. Вы увидите плагин Jmix в результатах поиска.

  5. Нажмите Install и следуйте дальнейшим инструкциям в IDE.

    install plugin

В случае, если вам необходимо настроить доступ в Интернет через прокси-сервер или установить нестандартную сборку Studio, посетите раздел Установка Studio.

Чтобы получить доступ к премиум-функциям Studio, настройте подписку в диалоговом окне Подписка.

Установка Java Development Kit (JDK)

Скачайте JDK версии 21 или 25 (например, Eclipse Temurin или Axiom JDK) и установите в каталог, предложенный установщиком. Этого достаточно для создания и запуска приложений в IDE.

Jmix 3.0 поддерживает Java 21 или 25 от любого поставщика. Однако мы не рекомендуем использовать JDK, основанный на OpenJ9, так как в прошлом это вызывало проблемы.

Чтобы запускать приложения Jmix из терминала, задайте переменную окружения JAVA_HOME как описано ниже.

  • На Windows, создайте переменную JAVA_HOME в Computer → Properties → Advanced System Settings → Advanced → Environment variables → System variables и укажите в ней путь к корневому каталогу установки JDK.

  • На macOS и Linux задайте переменную JAVA_HOME в файле ~/.bash_profile или в другом файле, соответствующем вашей командной оболочке, например:

    export JAVA_HOME="/Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home"

  • Перезагрузите компьютер, чтобы заданные переменные окружения вступили в силу.

  • Проверьте правильность установки переменной окружения, выполнив следующую команду в терминале:

    На Windows
    "%JAVA_HOME%\bin\java" -version
    На Linux и macOS
    "$JAVA_HOME/bin/java" -version

    Команда должна вернуть версию Java, например 21.0.2.

Если вы подключены к Интернету через прокси-сервер, некоторые системные свойства Java должны быть переданы в JVM, на которой запущены средства разработки и Gradle. Настройте эти свойства в Jmix Studio.

Разработка с ИИ-агентами

Вы можете ускорить разработку Jmix-приложений с помощью ИИ-агентов для написания кода.

Чтобы ИИ-агент эффективно работал с паттернами, архитектурой и лучшими практиками Jmix, мы рекомендуем использовать Jmix Agent Toolkit. Этот набор инструментов предоставляет агентам:

  • Обзор архитектуры: глубокое понимание паттернов, специфичных для Jmix.

  • Agent Skills: специализированные знания для разработки сущностей, экранов UI, доступа к данным и многого другого.

  • Процесс разработки: оптимизированные инструкции, помогающие AI-агентам соблюдать обязательные правила, специфичные для Jmix.

  • Конфигурацию рекомендуемых MCP-серверов и CLI-инструментов.

Чтобы установить данный набор инструментов, используйте действие AI Agents Toolkit в Studio или CLI-скрипт.

Использование Jmix CLI

Вы можете создавать Jmix-проекты без IDE с помощью Jmix CLI. Это инструмент командной строки, который использует те же шаблоны проектов, что и Studio. Его можно запускать в терминале, из скрипта или поручить запуск ИИ-агенту для написания кода.

Установка CLI на macOS или Linux:

curl -fsSL https://github.com/jmix-framework/jmix-cli/releases/latest/download/install.sh | bash

На Windows выполните в PowerShell:

irm https://github.com/jmix-framework/jmix-cli/releases/latest/download/install.ps1 | iex

CLI включает собственную среду выполнения Java, поэтому для его запуска JDK не нужен. Для сборки созданного проекта требуется JDK, и CLI поможет его установить.

Выполните jmix, чтобы запустить интерактивный мастер. Он позволяет выбрать шаблон проекта, локали, дополнения и расположение проекта.

Чтобы создать проект из скрипта или с помощью ИИ-агента, передайте параметры в командной строке вместе с опцией --non-interactive:

jmix new demo --non-interactive \
    --template application \
    --locales en,de \
    --addons quartz,german-translation

В конце каждого запуска CLI выводит команду jmix new, которая создает такой же проект в неинтерактивном режиме. Выполните jmix new --help, чтобы увидеть все опции.

Для коммерческих дополнений требуется подписка. CLI ожидает, что учетные данные для премиум-репозитория уже настроены в вашем окружении.

Созданный проект включает Jmix Agent Toolkit. Используйте опцию --no-agents-toolkit, чтобы создать проект без него.

Устранение неполадок

В зависимости от размера вашего проекта может потребоваться увеличить доступную память для процессов IntelliJ IDEA и Gradle.

  1. В IntelliJ IDEA откройте Help → Edit Custom VM Options…​ и отредактируйте параметр -Xmx (обычно он находится сверху). Рекомендуемое значение – 2048m или более, например:

    -Xmx2048m

  2. Отредактируйте файл ~/.gradle/gradle.properties и задайте параметр -Xmx в свойстве org.gradle.jvmargs. Рекомендуемое значение – 2048m или более, например:

    org.gradle.jvmargs=-Xmx2048m