Document Kotlin JVM plugin (#1339)

* Rename files

* Mention things about Kotlin JVM plugin

* Fix kt writing

* Note stdlib things

* Fix typo

* Remove duplicates

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: Goooler

docs/kmp-plugin/README.md docs/kotlin-plugins/README.md

@@ -1,4 +1,49 @@
-# Integrating with Kotlin Multiplatform Plugin
+# Integrating with Kotlin Plugins
+
+Kotlin standard libraries (stdlib) are added by Kotlin plugins by default, they will be bundled into the shadowed JARs automatically.
+If you don't need a standard library at all, you can add the following Gradle property to your gradle.properties file:
+
+```properties
+kotlin.stdlib.default.dependency=false
+```
+
+See more information about [Dependency on the standard library](https://kotlinlang.org/docs/gradle-configure-project.html#dependency-on-the-standard-library).
+
+## For Kotlin JVM Plugin
+
+Shadow works well for Kotlin JVM projects like Java projects. Here is an example:
+
+=== "Kotlin"
+
+    ```kotlin
+    plugins {
+      kotlin("jvm")
+      id("com.gradleup.shadow")
+    }
+
+    dependencies {
+      implementation("io.ktor:ktor-client-okhttp:3.1.0")
+    }
+    ```
+
+=== "Groovy"
+
+    ```groovy
+    plugins {
+      id 'org.jetbrains.kotlin.jvm'
+      id 'com.gradleup.shadow'
+    }
+
+    dependencies {
+      implementation 'io.ktor:ktor-client-okhttp:3.1.0'
+    }
+    ```
+
+You can mix the Kotlin JVM plugin with `java-gradle-plugin`, `application`, and other Java plugins,
+easily organize your build logic for [Packaging Gradle Plugins](../plugins/README.md), [Publishing Libraries](../publishing/README.md),
+[Running Applications](../application-plugin/README.md), and so on.
+
+## For Kotlin Multiplatform Plugin
 
 Shadow honors Kotlin's
 [`org.jetbrains.kotlin.multiplatform`](https://kotlinlang.org/docs/multiplatform-intro.html) plugin and will automatically
@@ -59,12 +104,12 @@ configure additional tasks for bundling the shadowed JAR for its `jvm` target.
       sourceSets {
         commonMain {
           dependencies {
-            implementation "io.ktor:ktor-client-core:$ktorVersion"
+            implementation 'io.ktor:ktor-client-core:$ktorVersion'
           }
         }
         jvmMain {
           dependencies {
-            implementation "io.ktor:ktor-client-okhttp:$ktorVersion"
+            implementation 'io.ktor:ktor-client-okhttp:$ktorVersion'
           }
         }
       }

gradle.properties

@@ -1,5 +1,5 @@
 # Omit automatic compile dependency on kotlin-stdlib.
-# https://kotlinlang.org/docs/gradle.html#dependency-on-the-standard-library
+# https://kotlinlang.org/docs/gradle-configure-project.html#dependency-on-the-standard-library
 kotlin.stdlib.default.dependency=false
 
 org.gradle.caching=true

mkdocs.yml

@@ -70,7 +70,7 @@ nav:
       - 'Reproducible Builds': configuration/reproducible-builds/README.md
   - 'Custom Tasks': custom-tasks/README.md
   - 'Application Plugin': application-plugin/README.md
-  - 'KMP Plugin': kmp-plugin/README.md
+  - 'Kotlin Plugins': kotlin-plugins/README.md
   - 'Groovy and Scala Plugins': groovy-and-scala-plugins/README.md
   - 'Publishing': publishing/README.md
   - 'Multi-Project': multi-project/README.md

src/functionalTest/kotlin/com/github/jengelman/gradle/plugins/shadow/BasePluginTest.kt

@@ -225,8 +225,8 @@ abstract class BasePluginTest {
           """.trimIndent()
         }
         JvmLang.Kotlin -> {
-          val imports = if (withImports) "import junit.framework.Test;" else ""
-          val classRef = if (withImports) "\"Refs: \" + Test.class.getName()" else "\"Refs: null\""
+          val imports = if (withImports) "import junit.framework.Test" else ""
+          val classRef = if (withImports) "\"Refs: \" + Test::class.java.name" else "\"Refs: null\""
           """
             @file:JvmName("$className")
             package $packageName

src/functionalTest/kotlin/com/github/jengelman/gradle/plugins/shadow/KmpPluginTest.kt src/functionalTest/kotlin/com/github/jengelman/gradle/plugins/shadow/KotlinPluginsTest.kt

@@ -13,7 +13,7 @@ import org.junit.jupiter.api.Test
 import org.junit.jupiter.params.ParameterizedTest
 import org.junit.jupiter.params.provider.ValueSource
 
-class KmpPluginTest : BasePluginTest() {
+class KotlinPluginsTest : BasePluginTest() {
   @BeforeEach
   override fun setup() {
     super.setup()
@@ -25,6 +25,28 @@ class KmpPluginTest : BasePluginTest() {
     projectScriptPath.writeText(projectBuildScript)
   }
 
+  @Test
+  fun compatKotlinJvmPlugin() {
+    projectScriptPath.writeText(
+      """
+        ${getDefaultProjectBuildScript(plugin = "org.jetbrains.kotlin.jvm", withGroup = true, withVersion = true)}
+        dependencies {
+          implementation 'junit:junit:3.8.2'
+        }
+      """.trimIndent(),
+    )
+    val mainClassEntry = writeClass(withImports = true, jvmLang = JvmLang.Kotlin)
+
+    run(shadowJarTask)
+
+    assertThat(outputShadowJar).useAll {
+      containsEntries(
+        mainClassEntry,
+        *junitEntries,
+      )
+    }
+  }
+
   @Test
   fun compatKmpJvmTarget() {
     val mainClassEntry = writeClass(sourceSet = "jvmMain", jvmLang = JvmLang.Kotlin)