chore: migrate from agent args to system environment variables

Author: CarefulDeveloper

README.md

@@ -6,20 +6,27 @@ This is a java agent for Gradle `distributionUrl` property global mirror setting
 
 1. Download the agent jar [here](https://github.com/CarefulDeveloper/GradleAgent/releases/latest/download/GradleAgent.jar)
 
-2. edit the system environment variable like this:
-
+2. make this agent jar work
+   
+   if you want to it worked in command line at terminal, you need to add this system environment variable:
+   
    ```
-   GRADLE_OPTS = -javaagent:C:\path\to\GradleAgent.jar=https://www.mirrror.host.com/gradle/gradle-%1$s-%2$s.zip
+   GRADLE_OPTS = -javaagent:C:\path\to\GradleAgent.jar
+   ```
+   
+   if you want to it worked in JetBrains IDE, you need follow [the documentation](https://www.jetbrains.com/help/idea/tuning-the-ide.html#procedure-jvm-options) and append new line in `*.vmoptions` with:
+   
+   ```
+   -javaagent:C:\path\to\GradleAgent.jar
    ```
-   `%1$s` will be fill with the gradle version info, like `8.8`; `%2$s` will be filled with distribution type, like `all` `bin`.
-
-3. edit JetBrains IDE VM Options(optional, support for JetBrains IDE)
 
-   follow [the documentation](https://www.jetbrains.com/help/idea/tuning-the-ide.html#procedure-jvm-options), then append new line with:
+3. config gradle distribution mirror url template:
 
+   add system environment variable:
    ```
-   -javaagent:C:\path\to\GradleAgent.jar=https://www.mirrror.host.com/gradle/gradle-%1$s-%2$s.zip
+   GRADLE_DISTRIBUTION_URL_TEMPLATE = https://www.mirrror.host.com/gradle/gradle-%1$s-%2$s.zip
    ```
+   `%1$s` will be fill with the gradle version info, like `8.8`; `%2$s` will be filled with distribution type, like `all` `bin`.
 
 4. restart terminal or JetBrains IDE
 

build.gradle.kts

@@ -8,7 +8,7 @@ plugins {
 }
 
 group = "org.tingy"
-version = "1.1"
+version = "1.2"
 
 dependencies {
     implementation("net.bytebuddy:byte-buddy:1.15.1")

settings.gradle.kts

@@ -1,6 +1,11 @@
+import org.gradle.api.internal.FeaturePreviews
+
 dependencyResolutionManagement {
     repositories {
+        gradlePluginPortal()
         mavenCentral()
+        // not used. gradle project maven repository
+        maven("https://repo.gradle.org/artifactory/libs-releases/")
     }
 }
 
@@ -20,4 +25,4 @@ pluginManagement {
 }
 
 rootProject.name = "GradleAgent"
-
+enableFeaturePreview(FeaturePreviews.Feature.TYPESAFE_PROJECT_ACCESSORS.name)

src/main/kotlin/Main.kt

@@ -10,13 +10,18 @@ fun main() {
 }
 
 fun premain(args: String?, instrumentation: Instrumentation) {
-    if (args == null) {
-        println("> Gradle Agent:\nMirror url template is null\n")
+    val mirrorUrlTemplate = System.getenv("GRADLE_DISTRIBUTION_URL_TEMPLATE")
+    if (mirrorUrlTemplate == null) {
+        println(
+            "> Gradle Agent:\nThe environment variable GRADLE_DISTRIBUTION_URL_TEMPLATE is not specified. " +
+                    "Please set it to a valid URL template. " +
+                    "For example: https://mirror.host.com/gradle/gradle-%1\$s-%2\$s.zip. \n"
+        )
         return
     }
 
     AgentBuilder.Default().type(ElementMatchers.named(TARGET_CLASS_NAME)).transform { builder, _, _, _, _ ->
         builder.method(ElementMatchers.named("readDistroUrl"))
-            .intercept(MethodDelegation.to(WrapperExecutorInterceptor(args)))
+            .intercept(MethodDelegation.to(WrapperExecutorInterceptor(mirrorUrlTemplate)))
     }.installOn(instrumentation)
 }