import org.gradle.api.JavaVersion
import org.gradle.plugins.ide.internal.tooling.idea.IsolatedIdeaModuleInternal
import org.gradle.plugins.ide.internal.tooling.model.IsolatedGradleProjectInternal
import org.gradle.tooling.model.idea.BasicIdeaProject
import org.gradle.tooling.model.idea.IdeaContentRoot
import org.gradle.tooling.model.idea.IdeaDependency
import org.gradle.tooling.model.idea.IdeaJavaLanguageSettings

import org.gradle.internal.Cast;
import org.gradle.plugins.ide.idea.IdeaPlugin;
import org.gradle.plugins.ide.idea.model.Dependency;
import org.gradle.plugins.ide.idea.model.FilePath;
import org.gradle.plugins.ide.idea.model.IdeaModel;
import org.gradle.plugins.ide.idea.model.IdeaModule;
import org.gradle.plugins.ide.idea.model.ModuleLibrary;
import org.gradle.plugins.ide.idea.model.ProjectLibrary;
import org.gradle.util.internal.VersionNumber;

[[sec:troubleshooting_ide_integration]]
== Debugging IDE integration

Many infrequent errors within IDEs can be solved by "refreshing" Gradle.
See also more documentation on working with Gradle link:https://www.jetbrains.com/help/idea/gradle.html[in IntelliJ IDEA] and link:http://www.vogella.com/tutorials/EclipseGradle/article.html[in Eclipse].

=== Refreshing IntelliJ IDEA

Class <org.gradle.plugins.ide.idea.IdeaPlugin> extends/implements org.gradle.plugins.ide.internal.IdePlugin that is Gradle Internal API in (IdeaPlugin.java:0)
Class <org.gradle.plugins.ide.idea.model.Module> extends/implements org.gradle.plugins.ide.internal.generator.XmlPersistableConfigurationObject that is Gradle Internal API in (Module.java:0)

    }

    /**
     * This is a workaround to preserve backward compatibility with IntelliJ IDEA.
     * The problem only occurs in IntelliJ IDEA because it parses {@link OperationDescriptor#getDisplayName()} to get the test display name.

```

## 1.5 A note on IDEs

### 1.5.1 IntelliJ IDEA

IntelliJ IDEA will display `<p>` or an empty `*` as a new line:

```java
/**
 * A
 *
 * B
 ```

```java
/**
 * A
 * <p>
 * B
 ```

Render as:

```text
A
B
```

If you want to stop IntelliJ IDEA from auto closing HTML tags:

/libraries/tools/kotlin-gradle-plugin-dsl-codegen/ "Kotlin Build Tools" "Kotlin Apple Ecosystem"
/libraries/tools/kotlin-gradle-plugin-idea/ "Kotlin Build Tools"
/libraries/tools/kotlin-gradle-plugin-idea-for-compatibility-tests/ "Kotlin Build Tools"
/libraries/tools/kotlin-gradle-plugin-idea-proto/ "Kotlin Build Tools"
/libraries/tools/kotlin-gradle-plugin-integration-tests/ "Kotlin Build Tools" "Kotlin Apple Ecosystem"

* A [Java Development Kit](http://jdk.java.net/) (JDK) **version 11**. Fixed version is required to use [remote cache](#remote-build-cache). 
* A text editor or IDE. We use and recommend [IntelliJ IDEA CE](http://www.jetbrains.com/idea/).  IntelliJ Ultimate will also work. You'll need IntelliJ 2021.2.2 or newer.
* [git](https://git-scm.com/) and a [GitHub account](https://github.com/join).

    //  We cannot use this syntax until adopting JSpecify with e.g. Jetbrains Annotations, because IDEA wrongly treats all Try usages as having a nullable type, even when
    //  it is explicitly spelled, e.g.
    //  Try<String> t = Try.successful("some")
    //  t.get().length()  // IDEA produces false positive "potential NPE" warning when JB annotations are used.

        static nebulaPluginPlugin = "20.11.0"

        // https://plugins.gradle.org/plugin/com.netflix.nebula.lint
        static nebulaLint = "19.0.1"

        // https://plugins.gradle.org/plugin/org.jetbrains.gradle.plugin.idea-ext
        static ideaExt = "1.1.8"

        // https://plugins.gradle.org/plugin/com.netflix.nebula.dependency-lock
        static nebulaDependencyLock = Versions.of("15.1.0")