intellij community

Edición comunitaria IntelliJ IDEA

Estas instrucciones le ayudarán a crear IntelliJ IDEA Community Edition a partir del código fuente, que es la base para el desarrollo de la plataforma IntelliJ. Se utilizarán las siguientes convenciones para hacer referencia a directorios en su máquina:

• <USER_HOME> es su directorio de inicio.
• <IDEA_HOME> es el directorio raíz del código fuente de IntelliJ.

Obtención del código fuente de IntelliJ IDEA Community Edition

El código fuente de IntelliJ IDEA Community Edition está disponible en github.com/JetBrains/intellij-community clonando o descargando un archivo zip (basado en una rama) en <IDEA_HOME> . La predeterminada es la rama maestra .

La rama maestra contiene el código fuente que se utilizará para crear la próxima versión principal de IntelliJ IDEA. Los nombres de las sucursales y los números de compilación para versiones anteriores de IntelliJ IDEA se pueden encontrar en la página de Rangos de números de compilación.

Estas operaciones de Git también se pueden realizar a través de la interfaz de usuario de IntelliJ IDEA.

Consejo rápido: si no se necesita el historial completo del repositorio, utilizar un clon superficial ( git clone --depth 1 ) ahorrará mucho tiempo.

En Windows: se requieren dos opciones de git para verificar las fuentes en Windows. Dado que de todos modos es una fuente común de problemas de Git en Windows, esas opciones se pueden configurar globalmente (ejecute esos comandos antes de clonar cualquiera de los repositorios de intellij-community/android):

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

IntelliJ IDEA Community Edition requiere módulos de Android adicionales de repositorios Git separados. Para clonar estos repositorios, ejecute uno de los scripts getPlugins ubicados en el directorio <IDEA_HOME> . Utilice el argumento --shallow si no es necesario el historial completo del repositorio. Estos scripts clonan sus respectivas ramas maestras . Asegúrese de estar dentro del directorio <IDEA_HOME> cuando ejecute esos scripts, para que los módulos se clonen dentro del directorio <IDEA_HOME> .

• getPlugins.sh para Linux o macOS.
• getPlugins.bat para Windows.

Nota: Siempre git checkout de los repositorios Git intellij-community y android en las mismas ramas/etiquetas.

Creación de la edición comunitaria IntelliJ

Se requiere la versión 2023.2 o posterior de IntelliJ IDEA Community Edition o IntelliJ IDEA Ultimate Edition para crear y desarrollar la plataforma IntelliJ.

Abrir el código fuente de IntelliJ para la compilación

Usando el archivo IntelliJ IDEA | Abra , seleccione el directorio <IDEA_HOME> .

• Si IntelliJ IDEA muestra un error sobre un complemento requerido faltante o desactualizado (por ejemplo, Kotlin), habilite, actualice o instale ese complemento y reinicie IntelliJ IDEA.

Configuración de compilación de IntelliJ

1. Se recomienda utilizar JetBrains Runtime 17 para compilar el proyecto. Cuando invoca Build Project por primera vez, IntelliJ IDEA debería sugerir descargarlo automáticamente.
2. Si el complemento Maven está deshabilitado, agregue la variable de ruta " MAVEN_REPOSITORY " que apunta al directorio <USER_HOME>/.m2/repository .
3. Asegúrate de tener al menos 8 GB de RAM en tu computadora. Con el mínimo de RAM, deshabilite la opción "Compilar módulos independientes en paralelo" en la configuración del compilador. Con notablemente más memoria disponible, aumente el "Tamaño del montón del proceso de compilación local del usuario" a 3000, lo que reducirá en gran medida el tiempo de compilación.

Tenga en cuenta que es importante utilizar la variante de JetBrains Runtime sin JCEF . Entonces, si por alguna razón jbr-17 SDK apunta a una instalación de JetBrains Runtime con JCEF, debe cambiarlo: asegúrese de que IntelliJ IDEA se esté ejecutando en modo interno (agregando idea.is.internal=true al archivo idea.properties ), navegue hasta el elemento jbr-17 en Estructura del proyecto | SDK, haga clic en el botón 'Examinar', elija el elemento 'Descargar...' y seleccione la versión 17 y el proveedor 'JetBrains Runtime'.

Creación del código fuente de la aplicación IntelliJ

Para compilar IntelliJ IDEA Community Edition desde el código fuente, elija Construir | Construir proyecto desde el menú principal.

Para crear paquetes de instalación, ejecute el comando installers.cmd en el directorio <IDEA_HOME> . installers.cmd funcionará tanto en sistemas Windows como Unix.

Las opciones para crear instaladores se pasan como propiedades del sistema al comando installers.cmd . Puede encontrar la lista de propiedades disponibles en BuildOptions.kt

Ejemplos ( ./ debe agregarse solo para Linux/macOS):

• Cree instaladores solo para el sistema operativo actual: ./installers.cmd -Dintellij.build.target.os=current
• Compile el código fuente de forma incremental (no cree lo que ya se creó antes): ./installers.cmd -Dintellij.build.incremental.compilation=true

installers.cmd se usa solo para ejecutar OpenSourceCommunityInstallersBuildTarget desde la línea de comando. Puede llamarlo directamente desde IDEA; consulte la configuración de ejecución Build IDEA Community Installers (current OS) para ver un ejemplo.

Entorno de construcción acoplado

Para crear paquetes de instalación dentro de un contenedor Docker con dependencias y herramientas preinstaladas, ejecute el siguiente comando en el directorio <IDEA_HOME> (en Windows, use PowerShell):
docker run --rm -it -v ${PWD}:/community $(docker build -q . --target build_env)

Ejecución de IntelliJ IDEA

Para ejecutar IntelliJ IDEA creado desde el código fuente, elija Ejecutar | Ejecutar desde el menú principal. Esto utilizará la configuración de ejecución preconfigurada " IDEA ".

Para ejecutar pruebas en la compilación, aplique esta configuración a Ejecutar | Editar configuraciones... | Plantillas | Pestaña de configuración de JUnit :

• Directorio de trabajo: <IDEA_HOME>/bin
• Opciones de máquina virtual:
  • -ea

Puede encontrar otra información útil en https://www.jetbrains.com/opensource/idea. La sección "Código de contribución" de ese sitio describe cómo puede contribuir a IntelliJ IDEA.

Ejecución de IntelliJ IDEA en un entorno CI/CD

Para ejecutar pruebas fuera de IntelliJ IDEA, ejecute el comando tests.cmd en el directorio <IDEA_HOME> . tests.cmd funcionará tanto en sistemas Windows como Unix.

Las opciones para ejecutar pruebas se pasan como propiedades del sistema al comando tests.cmd . Puede encontrar la lista de propiedades disponibles en TestingOptions.kt

Ejemplos ( ./ debe agregarse solo para Linux/macOS):

• Compile el código fuente de forma incremental (no cree lo que ya se creó antes): ./tests.cmd -Dintellij.build.incremental.compilation=true
• Ejecute una prueba específica: ./tests.cmd -Dintellij.build.test.patterns=com.intellij.util.ArrayUtilTest

tests.cmd se usa solo para ejecutar CommunityRunTestsBuildTarget desde la línea de comando. Puede llamarlo directamente desde IDEA; consulte ejecutar tests in community para ver un ejemplo.