Gradle에서 사용자 정의 속성을 추가하는 방법은 무엇인가요?

Q1: Gradle에서 사용자 정의 속성(Custom Property)이란 무엇인가요?
A1: 사용자 정의 속성은 프로젝트 빌드 스크립트 내에서 직접 정의하여, 빌드 설정에서 재사용할 수 있는 변수나 값입니다. 이를 통해 반복되는 값을 중앙에서 관리하고, 빌드 스크립트를 더 깔끔하고 유연하게 작성할 수 있습니다.

Q2: Gradle에서 사용자 정의 속성을 추가하는 기본적인 방법은 무엇인가요?
A2: 가장 일반적인 방법은 `ext`(extra properties) 블록을 사용하는 것입니다. 예를 들어 `build.gradle`에 다음과 같이 정의합니다:
```groovy
ext {
myCustomProperty = "Hello, Gradle!"
}
```
이후 빌드 스크립트 어디서든 `myCustomProperty`를 참조할 수 있습니다.

Q3: `ext` 외에 다른 방법으로 사용자 정의 속성을 추가할 수 있나요?
A3: 네. 다음과 같은 방법이 있습니다.
- 직접 프로퍼티 추가:
```groovy
project.myCustomProperty = "Value"
```
- `extra` 프로퍼티를 사용:
```groovy
project.extensions.extraProperties.set("myCustomProperty", "Value")
```

Q4: 사용자 정의 속성을 하위 프로젝트에서 접근하려면 어떻게 해야 하나요?
A4: 루트 프로젝트에 속성을 추가하고 하위 프로젝트에서 참조할 수 있습니다. 예를 들면:
루트 `build.gradle`:
```groovy
ext {
sharedProperty = "SharedValue"
}
```
하위 프로젝트 `build.gradle`:
```groovy
println rootProject.ext.sharedProperty
```

Q5: 속성 값을 커맨드라인에서 받아와서 사용자 정의 속성으로 사용할 수 있나요?
A5: 네, 가능합니다. 다음처럼 명령어로 값을 전달하고 `project.hasProperty`로 확인할 수 있습니다:
```bash
gradle build -PmyProp=MyValue ```
`build.gradle`에서는:
```groovy
ext {
myProp = project.hasProperty('myProp') ? project.property('myProp') : 'defaultValue'
}
```

Q6: 사용자 정의 속성에 객체나 함수도 저장할 수 있나요?
A6: 네. Groovy/Gradle 스크립트에서는 문자열뿐 아니라 숫자, 리스트, 맵, 클로저(함수) 등 다양한 객체를 저장할 수 있습니다. 예:
```groovy
ext {
versions = [spring: '5.3.10', gradle: '7.0']
greet = { name -> println "Hello, $name!" }
}
```

Q7: Kotlin DSL(`build.gradle.kts`)에서는 어떻게 사용자 정의 속성을 추가하나요?
A7: Kotlin DSL에서는 `extra`에 속성을 추가합니다. 예를 들어:
```kotlin
extra["myCustomProperty"] = "Hello, Kotlin DSL!"
```
참조는:
```kotlin
val myCustomProperty: String by extra
println(myCustomProperty)
```

Q8: 사용자 정의 속성의 범위(scope)는 어떻게 되나요?
A8: `ext`로 추가된 속성은 해당 프로젝트 내에서 유효하며, 루트 프로젝트나 하위 프로젝트에서 선언 위치에 따라 접근 범위가 달라집니다. 전역 공유가 필요하면 루트 프로젝트에 정의하고 하위 프로젝트에서 참조하는 방식을 권장합니다.

Q9: 사용자 정의 속성 추가 시 주의할 점은 무엇인가요?
A9:
- 속성명이 기존 내장 속성과 충돌하지 않도록 주의해야 합니다.
- 속성 값이 변경될 경우 캐시 문제나 빌드 동작에 영향이 있을 수 있으니 일관성 있게 관리하세요.
- Kotlin DSL을 사용할 경우 타입 안전성을 위해 명확한 타입 선언을 권장합니다.

---

요약하면, Gradle에서 사용자 정의 속성은 `ext` 또는 `extra` 프로퍼티를 활용하여 쉽게 선언 및 관리할 수 있으며, 프로젝트 간 속성 공유, 커맨드라인 인자 수신, 다양한 타입 저장이 가능합니다.

Gradle에서 사용자 정의 속성을 추가하는 방법은 여러 가지가 있으며, 이를 통해 빌드 스크립트를 더욱 유연하고 강력하게 만들 수 있습니다.

사용자 정의 속성은 프로젝트의 특정 요구 사항에 맞게 설정할 수 있는 변수로, 빌드 과정에서 다양한 방식으로 활용될 수 있습니다.

아래에서는 Gradle에서 사용자 정의 속성을 추가하는 방법에 대해 자세히 설명하겠습니다.

1. `gradle.properties` 파일 사용하기 Gradle 프로젝트의 루트 디렉토리에 `gradle.properties` 파일을 생성하거나 기존 파일을 수정하여 사용자 정의 속성을 추가할 수 있습니다.

이 파일은 프로젝트 전반에 걸쳐 사용할 수 있는 속성을 정의하는 데 유용합니다.

```properties gradle.properties myCustomProperty=Hello, Gradle! ``` 이렇게 정의한 속성은 Gradle 빌드 스크립트에서 다음과 같이 접근할 수 있습니다.

```groovy // build.gradle println myCustomProperty // 출력: Hello, Gradle! ```

2. 빌드 스크립트 내에서 속성 정의하기 Gradle 빌드 스크립트 내에서 직접 사용자 정의 속성을 정의할 수도 있습니다.

이 방법은 특정 빌드 스크립트에만 적용되는 속성을 정의할 때 유용합니다.

```groovy // build.gradle ext { myCustomProperty = 'Hello, Gradle!' } println myCustomProperty // 출력: Hello, Gradle! ``` 여기서 `ext` 블록은 확장 속성을 정의하는 데 사용됩니다.

이 속성은 빌드 스크립트의 다른 부분에서 쉽게 참조할 수 있습니다.



3. 커맨드 라인 인수 사용하기 Gradle은 커맨드 라인에서 속성을 전달할 수 있는 기능을 제공합니다.

이를 통해 빌드를 실행할 때 동적으로 속성을 설정할 수 있습니다.

```bash ./gradlew build -PmyCustomProperty="Hello from CLI" ``` 이렇게 설정한 속성은 빌드 스크립트에서 다음과 같이 접근할 수 있습니다.

```groovy // build.gradle println myCustomProperty // 출력: Hello from CLI ```

4. 환경 변수 사용하기 Gradle은 환경 변수를 통해 속성을 설정할 수도 있습니다.

이 방법은 CI/CD 환경에서 유용하게 사용될 수 있습니다.

예를 들어, 환경 변수를 설정한 후 Gradle에서 이를 참조할 수 있습니다.

```bash export MY_CUSTOM_PROPERTY="Hello from Environment" ``` Gradle 빌드 스크립트에서 이 환경 변수를 참조하려면 다음과 같이 작성합니다.

```groovy // build.gradle def myCustomProperty = System.getenv('MY_CUSTOM_PROPERTY') ?: 'Default Value' println myCustomProperty // 출력: Hello from Environment ```

5. 사용자 정의 태스크에서 속성 사용하기 사용자 정의 태스크를 만들 때도 사용자 정의 속성을 활용할 수 있습니다.

예를 들어, 특정 속성을 기반으로 동작하는 태스크를 정의할 수 있습니다.

```groovy // build.gradle task myTask { doLast { println "Custom Property: ${myCustomProperty}" } } ``` 이 태스크를 실행하면 정의한 사용자 정의 속성이 출력됩니다.

결론 Gradle에서 사용자 정의 속성을 추가하는 방법은 다양하며, 각 방법은 특정 상황에 따라 유용하게 사용될 수 있습니다.

`gradle.properties` 파일, 빌드 스크립트 내에서의 정의, 커맨드 라인 인수, 환경 변수 등을 통해 속성을 설정하고 활용함으로써 빌드 프로세스를 더욱 유연하게 구성할 수 있습니다.

이러한 사용자 정의 속성을 적절히 활용하면 프로젝트의 유지보수성과 확장성을 높일 수 있습니다.