• Gradle Custom Plugins
• Gradle Custom Plugin 만들기 참조

Gradle 플러그인은 재사용 가능한 빌드 로직을 패키지화하여 여러 서로다른 프로젝트와 빌드에서 사용할 수 있도록 한 것이다.

플러그인은 아무 언어로 작성해도 되며 Java 바이트코드로 컴파일해서 제공하기만 하면 된다.

빌드 스크립트에 직접 플러그인 소스를 작성해도 된다. 자동으로 컴파일되어 빌드 스크립트의 클래스패스에 추가된다. 플러그인을 선언한 빌드 스크립트 외부에서는 접근할 수 없다.

추천하는 방식.

Gradle Organizing Build Logic에 나온 buildSrc 프로젝트에 넣는다. rootProjectDir/buildSrc/src/main/groovy 디렉토리 아래에 넣는 것이다. Gradle이 자동으로 컴파일, 테스트, 클래스패스 추가를 해준다.

이렇게 할 경우 모든 프로젝트의 빌드 스크립트에서 이 플러그인에 접근 가능하다.

플러그인용 독립 프로젝트를 만들고 Jar로 묶어서 배포한다.

Plugin을 구현하여 사용자 정의 플러그인을 만든다. Gradle은 플러그인 객체를 생성하고 프로젝트 객체를 인자로 하여 Plugin.apply() 메소드를 호출한다.

• 사용자 정의 플러그인 build.gradle

  apply plugin: GreetingPlugin
   
  class GreetingPlugin implements Plugin<Project> {
      void apply(Project project) {
          project.task('hello') << {
              println "Hello from the GreetingPlugin"
          }
      }
  }

• 실행하면

  > gradle -q hello
  Hello from the GreetingPlugin

플러그인이 적용되는 모든 프로젝트에 대해서 플러그인 인스턴스가 각각 하나씩 생성된다.

플러그인들은 대부분 빌드 스크립트에서 설정을 해야할 필요가 있다. 이때 확장 객체(extension object)를 사용한다. Gradle의 Project는 ExtensionContainer 객체를 통해 플러그인에 전달되는 설정과 프라퍼티들을 추적할 수 있도록 해준다. 확장 컨테이너를 통해 사용자 입력을 받을 수 있다. 입력을 받으려면 확장 컨테이너의 확장 목록에 자바 빈에 호환되는 클래스를 추가하면 된다.

• greeting 확장 객체를 프로젝트에 추가하기 build.gradle

  apply plugin: GreetingPlugin
   
  // 확장 객체 값 사용
  greeting.message = 'Hi from Gradle'
   
  class GreetingPlugin implements Plugin<Project> {
      void apply(Project project) {
          // 'greeting' 확장 객체 추가
          project.extensions.create("greeting", GreetingPluginExtension)
   
          // 관련 설정을 사용하는 태스크 추가
          project.task('hello') << {
              println project.greeting.message
          }
      }
  }
   
  class GreetingPluginExtension {
      def String message = 'Hello form GreetingPlugin'
  }

• 실행하면

  > gradle -q hello
  Hi from Gradle

이 예제에서 GreetingPluginExtension은 message 필드를 가지고 있는 POGO이다. greeting 이라늠 이름으로 확장 객체가 플러그인에 추가 되었다. 이 객체는 동일한 이름으로 프로젝트의 프라퍼티로서 접근할 수 있다.

종종 지정할 프라퍼티가 많은 경우 확장 객체에 구성 클로저 블록을 추가하여 한번에 설정할 수 있도록 해준다.

• 구성 클로서를 사용하는 플러그인 build.gradle

  apply plugin: GreetingPlugin
   
  // 확장 객체의 프라퍼티들을  한 번에 설정한다.
  greeting {
      message = 'Hi'
      greeter = 'Gradle'
  }
   
  class GreetingPlugin implements Plugin<Project> {
      void apply(Project project) {
          project.extensions.create("greeting", GreetingPluginExtension)
          project.task('hello') << {
              println "${project.greeting.message} from ${project.greeting.greeter}"
          }
      }
  }
   
  class GreetingPluginExtension {
      String message
      String greeter
  }

• 실행하면

  > gradle -q hello
  Hi from Gradle

클로저 블럭의 이름(greeting)은 확장 객체의 이름과 같다. Groovy 클로저 위임 기능에 따라 클로저가 실행될 때 확장 객체의 필드는 클로저에 있는 변수와 매핑된다.