Snap for 8709740 from 94136e97c59789b2242f8eee1cd8abde4fe323d4 to studio-dolphin-release

Change-Id: I60acba3629ba543acf77426e415cd999c5252307
tree: b372367a38b2d7997de0aba533d8765b5a6998ef
  1. .idea/
  2. aether-dependency-resolver/
  3. bin/
  4. build/
  5. colorSchemes/
  6. community-resources/
  7. docs/
  8. images/
  9. java/
  10. jps/
  11. json/
  12. jupyter/
  13. jvm/
  14. lib/
  15. license/
  16. native/
  17. notebooks/
  18. platform/
  19. plugins/
  20. python/
  21. RegExpSupport/
  22. resources/
  23. resources-en/
  24. spellchecker/
  25. tools/
  26. uast/
  27. updater/
  28. xml/
  29. .editorconfig
  30. .gitattributes
  31. .gitignore
  32. build.txt
  33. build.xml
  34. CODE_OF_CONDUCT.md
  35. CONTRIBUTING.md
  36. getPlugins.bat
  37. getPlugins.sh
  38. intellij.idea.community.main.android.iml
  39. intellij.idea.community.main.iml
  40. intellij.yaml
  41. LICENSE.txt
  42. NOTICE.txt
  43. OWNERS
  44. qodana.yaml
  45. README.md
  46. test-log.xml
README.md

IntelliJ IDEA Community Edition official JetBrains project

These instructions will help you build IntelliJ IDEA Community Edition from source code, which is the basis for IntelliJ Platform development. The following conventions will be used to refer to directories on your machine:

  • <USER_HOME> is your home directory.
  • <IDEA_HOME> is the root directory for the IntelliJ source code.

Getting IntelliJ IDEA Community Edition Source Code

IntelliJ IDEA Community Edition source code is available from github.com/JetBrains/intellij-community by either cloning or downloading a zip file (based on a branch) into <IDEA_HOME>. The default is the master branch.

The master branch contains the source code which will be used to create the next major version of IntelliJ IDEA. The branch names and build numbers for older releases of IntelliJ IDEA can be found on the page of Build Number Ranges.

Speed Tip: If the complete repository history isn't needed then using a shallow clone (git clone --depth 1) will save significant time.

These Git operations can also be done through the IntelliJ IDEA user interface.

IntelliJ IDEA Community Edition requires additional Android modules from separate Git repositories. To clone these repositories, run one of the getPlugins scripts located in the <IDEA_HOME> directory. These scripts clone their respective master branches.

  • getPlugins.sh for Linux or macOS.
  • getPlugins.bat for Windows.

Note: Always git checkout the intellij-community and android Git repositories to the same branches/tags.

Building IntelliJ Community Edition

Version 2020.1 or newer of IntelliJ IDEA Community Edition or IntelliJ IDEA Ultimate Edition is required to build and develop for the IntelliJ Platform.

Opening the IntelliJ Source Code for Build

Using IntelliJ IDEA File | Open, select the <IDEA_HOME> directory.

IntelliJ Build Configuration

  1. Configure a JDK named “corretto-11”, pointing to installation of JDK 11. It's recommended to use Amazon Corretto JDK, but other distributions based on OpenJDK should work as well. You may download it directly from Project Structure dialog.

  2. If the Maven Integration plugin is disabled, add the path variableMAVEN_REPOSITORY” pointing to <USER_HOME>/.m2/repository directory.

  3. Speed Tip: If you have enough RAM on your computer, configure the compiler settings to enable the “Compile independent modules in parallel” option. Also, increase build process heap size:

    • if you use IntelliJ IDEA 2020.3 or newer, set “User-local build process heap size” to 2048.
    • if you use IntelliJ IDEA 2020.2 or older, copy value from “Shared build process VM options” to “User-local build process VM options” and add -Xmx2G to it.

    These changes will greatly reduce compilation time.

Building the IntelliJ Application Source Code

To build IntelliJ IDEA Community Edition from source, choose Build | Build Project from the main menu.

To build installation packages, run the ant command in <IDEA_HOME> directory. See the build.xml file for details.

Running IntelliJ IDEA

To run the IntelliJ IDEA built from source, choose Run | Run from the main menu. This will use the preconfigured run configuration “IDEA”.

To run tests on the build, apply these setting to the Run | Edit Configurations... | Templates | JUnit configuration tab:

  • Working dir: <IDEA_HOME>/bin
  • VM options:
    • -ea
    • -Didea.config.path=../test-config
    • -Didea.system.path=../test-system

You can find other helpful information at https://www.jetbrains.com/opensource/idea. The “Contribute Code” section of that site describes how you can contribute to IntelliJ IDEA.