Skip to content

Latest commit

 

History

History
61 lines (39 loc) · 2.26 KB

intellij-setup-and-troubleshooting.md

File metadata and controls

61 lines (39 loc) · 2.26 KB

IntelliJ setup and troubleshooting

NB! Please ensure that Intellij uses the same java installation as you do for building this project from command line. This ensures that Gradle task avoidance and build cache work properly and can greatly reduce build time.

Suggested plugins and settings:

Installation:

google format

Configuration:

enable google format

Note: If google-java-format generates errors in Intellij, see google/google-java-format#787 (comment).

Load/Unload Modules

This project has many modules, which have many dependencies. Therefore, IntelliJ indexes a lot and consumes a lot of CPU/memory resources.

To minimize IntelliJ's indexing and resource utilization, unload any modules on which you are not actively working.

Specifically, unload all modules, and then selectively load the modules on which you need to work. IntelliJ will prompt you to load additional modules on which the selected modules depend.

If you are working on a specific instrumentation, you can load only the modules for that instrumentation. For example, to load the modules for the Spring Boot autoconfigure instrumentation, run:

./docs/contributing/selectModules.kts instrumentation/spring/spring-boot-autoconfigure/

Install the Kotlin executable if you don't have it already.

Troubleshooting

Occasionally, Intellij gets confused, maybe due to the number of modules in this project, maybe due to other reasons. In any case, here's some things that might help:

Invalidate Caches > "Just restart"

  • Go to File > Invalidate Caches...
  • Unselect all the options
  • Click the "Just restart" link

This seems to fix more issues than just closing and re-opening Intellij 🤷.

Delete your .idea directory

  • Close Intellij
  • Delete the .idea directory in the root directory of your local repository
  • Open Intellij