intellij community

Edição da comunidade IntelliJ IDEA

Estas instruções ajudarão você a criar o IntelliJ IDEA Community Edition a partir do código-fonte, que é a base para o desenvolvimento da plataforma IntelliJ. As seguintes convenções serão usadas para se referir aos diretórios em sua máquina:

• <USER_HOME> é o seu diretório inicial.
• <IDEA_HOME> é o diretório raiz do código-fonte do IntelliJ.

Obtendo o código-fonte do IntelliJ IDEA Community Edition

O código-fonte do IntelliJ IDEA Community Edition está disponível em github.com/JetBrains/intellij-community clonando ou baixando um arquivo zip (com base em uma ramificação) em <IDEA_HOME> . O padrão é o branch master .

A ramificação master contém o código-fonte que será usado para criar a próxima versão principal do IntelliJ IDEA. Os nomes das filiais e os números de compilação para versões mais antigas do IntelliJ IDEA podem ser encontrados na página Build Number Ranges.

Essas operações do Git também podem ser feitas por meio da interface de usuário do IntelliJ IDEA.

Dica rápida: se o histórico completo do repositório não for necessário, usar um clone superficial ( git clone --depth 1 ) economizará um tempo significativo.

No Windows: Duas opções git são necessárias para verificar as fontes no Windows. De qualquer forma, como é uma fonte comum de problemas do Git no Windows, essas opções podem ser definidas globalmente (execute esses comandos antes de clonar qualquer repositório intellij-community/Android):

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

O IntelliJ IDEA Community Edition requer módulos Android adicionais de repositórios Git separados. Para clonar esses repositórios, execute um dos scripts getPlugins localizados no diretório <IDEA_HOME> . Use o argumento --shallow se o histórico completo do repositório não for necessário. Esses scripts clonam suas respectivas ramificações master . Certifique-se de estar dentro do diretório <IDEA_HOME> ao executar esses scripts, para que os módulos sejam clonados dentro do diretório <IDEA_HOME> .

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

Nota: Sempre git checkout dos repositórios intellij-community e android Git para as mesmas ramificações/tags.

Construindo a edição comunitária do IntelliJ

A versão 2023.2 ou mais recente do IntelliJ IDEA Community Edition ou IntelliJ IDEA Ultimate Edition é necessária para construir e desenvolver para a plataforma IntelliJ.

Abrindo o código-fonte do IntelliJ para Build

Usando o arquivo IntelliJ IDEA | Abra , selecione o diretório <IDEA_HOME> .

• Se o IntelliJ IDEA exibir um erro sobre um plug-in necessário ausente ou desatualizado (por exemplo, Kotlin), habilite, atualize ou instale esse plug-in e reinicie o IntelliJ IDEA.

Configuração de compilação do IntelliJ

1. É recomendado usar JetBrains Runtime 17 para compilar o projeto. Ao invocar o Build Project pela primeira vez, o IntelliJ IDEA deverá sugerir baixá-lo automaticamente.
2. Se o plugin Maven estiver desabilitado, adicione a variável de caminho " MAVEN_REPOSITORY " apontando para o diretório <USER_HOME>/.m2/repository .
3. Certifique-se de ter pelo menos 8 GB de RAM em seu computador. Com o mínimo de RAM, desative a opção "Compile módulos independentes em paralelo" nas configurações do compilador. Com notavelmente mais memória disponível, aumente o "tamanho de heap do processo de construção local do usuário" para 3.000 - isso reduzirá bastante o tempo de compilação.

Observe que é importante usar a variante JetBrains Runtime sem JCEF . Portanto, se por algum motivo o SDK jbr-17 apontar para uma instalação do JetBrains Runtime com JCEF, você precisará alterá-lo: certifique-se de que o IntelliJ IDEA esteja sendo executado em modo interno (adicionando idea.is.internal=true ao arquivo idea.properties ), navegue até o item jbr-17 em Estrutura do Projeto | SDKs, clique no botão 'Procurar', escolha o item 'Baixar...' e selecione a versão 17 e o fornecedor 'JetBrains Runtime'.

Construindo o código-fonte do aplicativo IntelliJ

Para construir o IntelliJ IDEA Community Edition a partir da fonte, escolha Construir | Construir projeto no menu principal.

Para construir pacotes de instalação, execute o comando installers.cmd no diretório <IDEA_HOME> . installers.cmd funcionará em sistemas Windows e Unix.

As opções para construir instaladores são passadas como propriedades do sistema para o comando installers.cmd . Você pode encontrar a lista de propriedades disponíveis em BuildOptions.kt

Exemplos ( ./ deve ser adicionado apenas para Linux/macOS):

• Crie instaladores apenas para o sistema operacional atual: ./installers.cmd -Dintellij.build.target.os=current
• Construa o código-fonte de forma incremental (não construa o que já foi construído antes): ./installers.cmd -Dintellij.build.incremental.compilation=true

installers.cmd é usado apenas para executar OpenSourceCommunityInstallersBuildTarget na linha de comando. Você pode chamá-lo diretamente do IDEA, consulte a configuração de execução Build IDEA Community Installers (current OS) para obter um exemplo.

Ambiente de construção Dockerizado

Para criar pacotes de instalação dentro de um contêiner Docker com dependências e ferramentas pré-instaladas, execute o seguinte comando no diretório <IDEA_HOME> (no Windows, use o PowerShell):
docker run --rm -it -v ${PWD}:/community $(docker build -q . --target build_env)

Executando o IntelliJ IDEA

Para executar o IntelliJ IDEA criado a partir do código-fonte, escolha Executar | Execute no menu principal. Isso usará a configuração de execução pré-configurada " IDEA ".

Para executar testes na compilação, aplique essas configurações em Executar | Editar configurações... | Modelos | Guia de configuração JUnit :

• Diretório de trabalho: <IDEA_HOME>/bin
• Opções de VM:
  • -ea

Você pode encontrar outras informações úteis em https://www.jetbrains.com/opensource/idea. A seção “Código de contribuição” desse site descreve como você pode contribuir para o IntelliJ IDEA.

Executando o IntelliJ IDEA no ambiente CI/CD

Para executar testes fora do IntelliJ IDEA, execute o comando tests.cmd no diretório <IDEA_HOME> . tests.cmd funcionará em sistemas Windows e Unix.

As opções para executar testes são passadas como propriedades do sistema para o comando tests.cmd . Você pode encontrar a lista de propriedades disponíveis em TestingOptions.kt

Exemplos ( ./ deve ser adicionado apenas para Linux/macOS):

• Construa o código-fonte de forma incremental (não construa o que já foi construído antes): ./tests.cmd -Dintellij.build.incremental.compilation=true
• Execute um teste específico: ./tests.cmd -Dintellij.build.test.patterns=com.intellij.util.ArrayUtilTest

tests.cmd é usado apenas para executar CommunityRunTestsBuildTarget na linha de comando. Você pode chamá-lo diretamente do IDEA, veja como executar tests in community para ver um exemplo.