IntelliJ Platform Gradle Plugin: Tasks graph

topics/appendix/tools/intellij_platform_gradle_plugin/tools_intellij_platform_gradle_plugin.md

@@ -300,7 +300,7 @@ See also:
 - [Extension: `intellijPlatform.instrumentCode`](tools_intellij_platform_gradle_plugin_extension.md#intellijPlatform-instrumentCode)
 - [Task Awares: `JavaCompilerAware`](tools_intellij_platform_gradle_plugin_task_awares.md#JavaCompilerAware)
 - [Dependencies: `javaCompiler()`](tools_intellij_platform_gradle_plugin_dependencies_extension.md#code-instrumentation)
-- [Build Features: `useClosestJavaCompilerVersion`](tools_intellij_platform_gradle_plugin_gradle_properties.md#useClosestJavaCompilerVersion)
+- [Build Features: `useClosestVersionResolving`](tools_intellij_platform_gradle_plugin_gradle_properties.md#useClosestVersionResolving)
 
 <include from="tools_intellij_platform_gradle_plugin_repositories_extension.md" element-id="localPlatformArtifacts_required"/>
 

topics/appendix/tools/intellij_platform_gradle_plugin/tools_intellij_platform_gradle_plugin_gradle_properties.md

@@ -64,7 +64,7 @@ org.jetbrains.intellij.platform.buildFeature.selfUpdateCheck=false
 ### `downloadSources`
 {#downloadSources}
 
-Instruct IDE that sources are needed to be downloaded when working with IntelliJ Platform Gradle Plugin.
+Instruct the IDE that sources are needed to be downloaded when working with IntelliJ Platform Gradle Plugin.
 
 Value is passed directly to the [Idea Gradle Plugin](https://docs.gradle.org/current/userguide/idea_plugin.html) to the `idea.module.downloadSources` property.
 
@@ -155,10 +155,10 @@ Example
 org.jetbrains.intellij.platform.buildFeature.useCacheRedirector=false
 ```
 
-### `useClosestJavaCompilerVersion`
-{#useClosestJavaCompilerVersion}
+### `useClosestVersionResolving`
+{#useClosestVersionResolving}
 
-Java Compiler dependency required for the [](tools_intellij_platform_gradle_plugin.md#code-instrumentation) is tied to IntelliJ Platform build numbers and hosted in the IntelliJ Dependencies Repository.
+Some dependencies are tied to IntelliJ Platform build numbers and hosted in the IntelliJ Dependencies Repository.
 Despite this, certain versions (like EAP or nightly builds) might be absent.
 
 To solve this, we fetch a list of all versions from the Maven repository and locate the closest match.
@@ -172,5 +172,5 @@ Default value
 Example
 :
 ```
-org.jetbrains.intellij.platform.buildFeature.useClosestJavaCompilerVersion=false
+org.jetbrains.intellij.platform.buildFeature.useClosestVersionResolving=false
 ```

topics/appendix/tools/intellij_platform_gradle_plugin/tools_intellij_platform_gradle_plugin_tasks.md

@@ -14,101 +14,131 @@ Each of the tasks has relations described between each other, inherit from [](to
 
 ```mermaid
 flowchart LR
-
     subgraph TASKS ["`**IntelliJ Platform Gradle Plugin Tasks**`"]
         direction TB
 
         initializeIntelliJPlatformPlugin
 
         subgraph ALL ["` `"]
-            buildPlugin
-            buildSearchableOptions
-            instrumentCode>instrumentCode]
-            instrumentedJar>instrumentedJar]
-            jarSearchableOptions
-            patchPluginXml
-            prepareSandbox
-            setupDependencies>setupDependencies]
+            subgraph BUILD ["Build"]
+                buildPlugin
+                buildSearchableOptions
+                jarSearchableOptions
+
+                subgraph prepareSandbox_patchPluginXml ["` `"]
+                    prepareSandbox
+                    patchPluginXml
+                end
+
+                subgraph instrumentation
+                    direction BT
+
+                    instrumentedJar
+                    instrumentCode
+                end
+            end
+
+            subgraph RUN ["Run"]
+                runIde
+            end
+
 
             subgraph PUBLISH ["Publish"]
                 publishPlugin
                 signPlugin
             end
 
-            subgraph RUN ["Run/Test"]
-                runIde
+            subgraph TEST ["Test"]
+                prepareTest
                 testIde
                 testIdePerformance>testIdePerformance]
                 testIdeUi>testIdeUi]
+
             end
 
             subgraph VERIFY ["Verify"]
                 direction TB
 
-                verifyPluginSignature
-                verifyPluginProjectConfiguration
-                verifyPluginStructure
                 verifyPlugin
+                verifyPluginSignature
+                verifyPluginStructure
+                verifyPluginProjectConfiguration
             end
 
-            subgraph PLATFORM ["Target Platform"]
-                printBundledPlugins
-                printProductsReleases
-            end
+            TEST ~~~ VERIFY
+
+            printBundledPlugins
+            printProductsReleases
         end
     end
 
     subgraph GRADLE ["Gradle Tasks"]
-        test
         jar
-        compileKotlin
+        test
+
+        subgraph compile ["` `"]
+            compileJava
+            compileKotlin
+        end
     end
 
 
     initializeIntelliJPlatformPlugin --> | runs before | ALL
-    buildPlugin --> jarSearchableOptions & prepareSandbox & patchPluginXml
-    jarSearchableOptions --> buildSearchableOptions & prepareSandbox & patchPluginXml
-    buildSearchableOptions --> patchPluginXml & prepareSandbox
-    prepareSandbox --> jar & instrumentedJar
-    publishPlugin --> buildPlugin & signPlugin
-    runIde --> prepareSandbox
-    signPlugin --> buildPlugin
-    testIde --> prepareSandbox
-    test --> testIde
-    verifyPluginProjectConfiguration --> patchPluginXml
-    verifyPluginSignature --> signPlugin & prepareSandbox
-    verifyPluginStructure --> prepareSandbox
-    verifyPlugin --> buildPlugin
 
+    buildPlugin --> jarSearchableOptions & prepareSandbox_patchPluginXml
+    buildSearchableOptions --> prepareSandbox_patchPluginXml
+    instrumentCode --> compile
+    instrumentedJar --> jar & instrumentCode
+    jarSearchableOptions --> buildSearchableOptions & prepareSandbox_patchPluginXml
+    patchPluginXml
+    prepareSandbox --> jar & instrumentedJar
+
+    publishPlugin --> buildPlugin & signPlugin
+    signPlugin --> buildPlugin
+
+    runIde --> prepareSandbox_patchPluginXml
+
+    prepareTest --> prepareSandbox_patchPluginXml
+    test --> prepareTest
+    testIde --> prepareSandbox_patchPluginXml
+    testIdePerformance
+    testIdeUi
+
+    verifyPlugin --> buildPlugin
+    verifyPluginProjectConfiguration --> patchPluginXml
+    verifyPluginSignature
+    verifyPluginStructure --> prepareSandbox
+
+    click initializeIntelliJPlatformPlugin "#initializeIntelliJPlatformPlugin"
 
     click buildPlugin "#buildPlugin"
     click buildSearchableOptions "#buildSearchableOptions"
-    click initializeIntelliJPlatformPlugin "#initializeIntelliJPlatformPlugin"
     click instrumentCode "#instrumentCode"
     click instrumentedJar "#instrumentedJar"
     click jarSearchableOptions "#jarSearchableOptions"
     click patchPluginXml "#patchPluginXml"
     click prepareSandbox "#prepareSandbox"
-    click printBundledPlugins "#printBundledPlugins"
-    click printProductsReleases "#printProductsReleases"
+
     click publishPlugin "#publishPlugin"
-    click runIde "#runIde"
-    click setupDependencies "#setupDependencies"
     click signPlugin "#signPlugin"
+
+    click runIde "#runIde"
+
+    click prepareTest "#prepareTest"
     click testIde "#testIde"
     click testIdePerformance "#testIdePerformance"
     click testIdeUi "#testIdeUi"
+
+    click verifyPlugin "#verifyPlugin"
     click verifyPluginProjectConfiguration "#verifyPluginProjectConfiguration"
     click verifyPluginSignature "#verifyPluginSignature"
     click verifyPluginStructure "#verifyPluginStructure"
-    click verifyPlugin "#verifyPlugin"
+
+    click printBundledPlugins "#printBundledPlugins"
+    click printProductsReleases "#printProductsReleases"
 
     style TASKS fill:transparent
     style ALL fill:transparent
-
-    style instrumentCode stroke-dasharray: 5 5
-    style instrumentedJar stroke-dasharray: 5 5
-    style setupDependencies stroke-dasharray: 5 5
 ```
 
 ## `buildPlugin`
@@ -393,7 +423,7 @@ Creates a duplicate of the current module's `jar` file with instrumented classes
 
 <tldr>
 
-**Depends on**: [`buildSearchableOptions`](#buildSearchableOptions), [`patchPluginXml`](#patchPluginXml)
+**Depends on**: [`buildSearchableOptions`](#buildSearchableOptions), [`patchPluginXml`](#patchPluginXml), [`prepareSandbox`](#prepareSandbox)
 
 **Extends**: [`Jar`][gradle-jar-task], [`PluginAware`](tools_intellij_platform_gradle_plugin_task_awares.md#PluginAware), [`SandboxAware`](tools_intellij_platform_gradle_plugin_task_awares.md#SandboxAware)
 
@@ -1012,6 +1042,8 @@ Default value
 
 <tldr>
 
+**Depends on**: [`patchPluginXml`](#patchPluginXml), [`prepareSandbox`](#prepareSandbox)
+
 **Extends**: [`JavaExec`][gradle-javaexec-task], [`RunnableIdeAware`](tools_intellij_platform_gradle_plugin_task_awares.md#RunnableIdeAware), [`CustomIntelliJPlatformVersionAware`](tools_intellij_platform_gradle_plugin_task_awares.md#CustomIntelliJPlatformVersionAware)
 
 **Sources**: [`RunIdeTask`](%gh-ijpgp%/src/main/kotlin/org/jetbrains/intellij/platform/gradle/tasks/RunIdeTask.kt)