[Gradle] 하위 프로젝트 간 빌드 로직 공유 (Sharing Build Logic between Subprojects)

Convention Plugins

일반적으로 다중 프로젝트 빌드의 하위 프로젝트는 몇 가지 공통된 특성을 공유합니다. 예를 들어, 여러 하위 프로젝트에는 특정 프로그래밍 언어로 된 코드가 포함될 수 있지만 다른 하위 프로젝트는 문서화 전용일 수 있습니다. 코드 품질 규칙은 모든 코드 하위 프로젝트에 적용되지만 설명서 하위 프로젝트에는 적용되지 않습니다. 동시에, 하나의 공통된 특성을 공유하는 하위 프로젝트는 다른 목적을 수행 할 수 있습니다 - 그들은 그들을 더욱 차별화하는 다른 아티팩트 유형을 생성 할 수 있습니다

, for example:

• public libraries - libraries that are published to some repository
• internal libraries - libraries on which other subprojects depend on internally within the project
• command line applications - applications with specific packaging requirements
• web services - applications with specific packaging requirements that are different from above
• etc

일부 다른 코드 하위 프로젝트는 테스트 목적 등으로 전용될 수 있습니다.

위의 트레이트는 하위 프로젝트의 유형을 식별합니다. 즉, 하위 프로젝트의 유형은 프로젝트에 어떤 특성이 있는지 알려줍니다.

 

빌드 로직을 구성하는 Gradle의 권장 방법은 플러그인 시스템을 사용하는 것입니다. 플러그인은 하위 프로젝트의 유형을 정의해야 합니다. 실제로 Gradle 핵심 플러그인은 동일한 방식으로 모델링 됩니다 (예 : Java 플러그인은 일반 Java 프로젝트를 구성하는 반면 Java 라이브러리 플러그인은 내부적으로 Java 플러그인을 적용 하고 Java 라이브러리와 관련된 측면을 추가로 구성합니다). 마찬가지로 응용 프로그램 플러그인은 Java 플러그인과 배포 플러그인을 적용하고 구성합니다.

 

코어 및 외부 플러그인을 모두 적용 및 구성하여 사용자 지정 빌드 로직을 작성하고 새 프로젝트 유형을 정의하고 프로젝트 또는 조직과 관련된 규칙을 구성하는 사용자 지정 플러그인을 만들 수 있습니다. 이 섹션의 시작 부분에 있는 각 예제 특성에 대해 주어진 유형의 하위 프로젝트에 공통적인 논리를 캡슐화하는 플러그인을 작성할 수 있습니다.

 

컨벤션 플러그인에 대한 소스 코드와 테스트를 프로젝트의 루트 디렉토리에 있는 특수 buildSrc 디렉토리에 넣는 것이 좋습니다. buildSrc에 대한 자세한 내용은 buildSrc를 사용하여 빌드 논리 구성을 참조하세요.

 

규칙 플러그인을 사용하여 빌드 논리를 모델링하는 다중 프로젝트 빌드를 보여 주는 샘플을 살펴보세요.

 

컨벤션 플러그인을 사용하여 빌드 로직을 구성하는 다중 프로젝트 빌드의 또 다른 복잡하고 실제적인 예는 Gradle Build Tool 자체의 빌드 입니다.

 

Cross project configuration

하위 프로젝트간에 빌드 논리를 공유하는 또 다른 방법은 하위 프로젝트 {} 및 모든 프로젝트 {} DSL 구문을 통한 프로젝트 간 구성입니다. 교차 구성을 사용하면 빌드 논리를 하위 프로젝트에 주입 할 수 있으며 하위 프로젝트의 빌드 스크립트를 볼 때 명확하지 않으므로 특정 하위 프로젝트의 논리를 이해하기가 더 어려워집니다. 장기적으로 교차 구성은 일반적으로 점점 더 많은 조건부 논리와 더 높은 유지 관리 부담으로 복잡해집니다. 또한 교차 구성은 프로젝트 간에 구성 시간 결합을 도입 하여 주문형 구성과 같은 최적화가 제대로 작동하지 못하게 할 수 있습니다.

규칙 플러그인을 사용하여 더 잘 모델링할 수 있는 교차 구성의 가장 일반적인 두 가지 용도가 있습니다.

• 플러그인 또는 다른 구성을 특정 유형의 하위 프로젝트에 적용합니다. 종종 교차 구성 섹션은 하위 프로젝트가 X 유형 인 경우 수행 한 다음 Y를 구성합니다. 이것은 X-conventions 플러그인을 하위 프로젝트에 직접 적용하는 것과 같습니다.
• 특정 유형의 하위 프로젝트에서 정보를 추출합니다. 이 사용 사례는 발신 구성 변형을 사용하여 모델링할 수 있습니다.