Gradle을 사용하여 소프트웨어 구성요소 구성 요소 구성 및 빌드하기

Gradle을 사용하여 특정 크기의 소프트웨어를 빌드하는 경우 두 가지 기본 구조화 메커니즘이 있습니다. 먼저 이 장에서는 Gradle 다중 프로젝트를 사용하여 소프트웨어 프로젝트를 구성하는 방법을 설명합니다. 이 설명서에서는 이를 내부적으로 구조화된 단일 소프트웨어 구성 요소로 간주합니다. 둘째, 소프트웨어를 여러 소프트웨어 구성요소로 구성된 소프트웨어 제품으로 간주할 수 있으며, 각 구성요소는 별도의 Gradle 빌드로 표시됩니다. 이에 대해서는 Gradle을 사용한 소프트웨어 제품 구조화 장 에 자세히 설명되어 있습니다.

Creating a multi-project build

Gradle의 다중 프로젝트 빌드는 하나의 루트 프로젝트와 하나 이상의 하위 프로젝트로 구성됩니다.

기본 다중 프로젝트 빌드에는 루트 프로젝트와 단일 하위 프로젝트가 포함됩니다. 이것은 app이라는 단일 하위 프로젝트를 포함하는 다중 프로젝트 빌드의 구조입니다.

Example 1. Basic multi-project build

.
├── app
│   ...
│   └── build.gradle.kts
└── settings.gradle.kts

Gradle 프로젝트를 시작하는 데 권장되는 프로젝트 구조입니다. build init 플러그인은 또한 이 구조를 따르는 스켈레톤 프로젝트(단일 하위 프로젝트가 있는 루트 프로젝트)를 생성합니다.

루트 프로젝트에는 Gradle 빌드 파일이 없으며 포함할 하위 프로젝트를 정의하는 설정 파일만 있습니다.

settings.gradle.kts

rootProject.name = "basic-multiproject"
include("app")

이 경우 Gradle은 앱 디렉터리에서 빌드 파일을 찾습니다.

gradle projects 명령을 실행하여 다중 프로젝트 빌드의 구조를 볼 수 있습니다.

> gradle -q projects

------------------------------------------------------------
Root project 'basic-multiproject'
------------------------------------------------------------

Root project 'basic-multiproject'
\--- Project ':app'

To see a list of the tasks of a project, run gradle <project-path>:tasks
For example, try running gradle :app:tasks

app 하위 프로젝트가 응용 프로그램 플러그인을 적용 하고 기본 클래스를 구성하여 Java 응용 프로그램이라고 가정 해 보겠습니다.

app/build.gradle.kts

plugins {
    id("application")
}

application {
    mainClass.set("com.example.Hello")
}

app/src/main/java/com/example/Hello.java

package com.example;

public class Hello {
    public static void main(String[] args) {
        System.out.println("Hello, world!");
    }
}

그런 다음 응용 프로그램 플러그인에서 실행 작업을 실행하여 응용 프로그램을 실행할 수 있습니다.

> gradle -q run
Hello, world!

이것이 기본 다중 프로젝트 빌드를 만드는 것이 얼마나 간단한 지입니다.

Adding subprojects

이전에 만든 프로젝트에 lib라는 다른 하위 프로젝트를 추가한다고 가정 해 보겠습니다. 루트 설정 파일에 다른 include 문을 추가하기 만하면됩니다.

settings.gradle.kts

rootProject.name = "basic-multiproject"
include("app")
include("lib")

그런 다음 Gradle은 프로젝트의 lib/ 하위 디렉토리에서 새 하위 프로젝트의 빌드 파일을 찾습니다.

Example 2. Multi-project build with two subprojects

.
├── app
│   ...
│   └── build.gradle.kts
├── lib
│   ...
│   └── build.gradle.kts
└── settings.gradle.kts

다음으로, 하위 프로젝트 간에 빌드 논리 를 공유하는 방법과 하위 프로젝트가 서로 종속될 수 있는 방법을 살펴봅니다.

Naming recommendations

프로젝트가 성장함에 따라 이름 지정과 일관성이 점점 더 중요해지고 있습니다. 빌드를 유지 관리 가능한 상태로 유지하려면 다음을 수행하는 것이 좋습니다.

1. 하위 프로젝트의 기본 프로젝트 이름 유지: 설정 파일에서 사용자 지정 프로젝트 이름을 구성할 수 있습니다. 그러나 개발자가 어떤 프로젝트가 어떤 폴더에 속하는지 추적하는 것은 불필요한 추가 작업입니다.
2. 모든 프로젝트 이름에 케밥 대소 문자 형식 사용 : 케밥 대소 문자 형식은 모든 문자가 소문자이고 단어가 대시 ( '-') 문자로 구분 된 경우입니다 (예 : kebab-case-formatting). 이것은 이미 많은 대규모 프로젝트의 사실상의 패턴입니다. 게다가 Gradle은 케밥 케이스 이름에 대한 이름 약어를 지원합니다.
3. 설정 파일에서 루트 프로젝트 이름 정의: 'rootProject.name'은 빌드 스캔과 같은 보고서에 사용되는 빌드 전체에 이름을 효과적으로 할당합니다. 루트 프로젝트 이름이 설정되지 않은 경우 이름은 불안정할 수 있는 컨테이너 디렉터리 이름이 됩니다(즉, 프로젝트를 모든 디렉터리로 체크아웃할 수 있음).