[Xcode] build configuration file(xcconfig) 알아보기

안녕하세요?

너구리입니다.

 

저번 포스팅의 연장선으로 

build configuration file에 대해 알아보도록 하겠습니다.

 

 

# Build Settings

Build Settings는 저번 시간에

빌드 설정은 특정 제품의 빌드 프로세스의 특정 측면이 어떻게 수행되어야 하는지를 지정하는 변수를 의미로 설명드렸습니다.

 

지금까지 저희는 자연스럽게 설정 변수를 바꾸기 위해서

Xcode를 열고 Build Settings 섹션으로 간 뒤 설정을 바꾸곤 했었죠!

 

그런데 값을 수정한 뒤 git 수정 내역을 보면 프로젝트 파일이 변경되어 있습니다.

setting 값들을 프로젝트 파일에서 관리하는데

코드 리뷰할 때나 수정 내역을 살펴볼 때 찾기 힘들다는 문제가 있습니다.

setting값들은 매우 중요한데 말이죠!!

 

그래서 이것들을 따로 file로 관리를 할 수 있는데 그게 바로 

build configuration file 입니다.

 

 

# Build Configuration File 란

공식 문서를 살펴보도록 하겠습니다.

build configuration file은 특정 target이나 전체 프로젝트의 build setting을 text로 명시한 파일 이라고 설명합니다.

빌드 설정을 보다 효율적으로 관리하고, 다양한 아키텍처 및 플랫폼에 따라 설정을 자동으로 변경할 수 있습니다. 빌드 구성 파일을 사용하면 수정하려는 설정만 텍스트 파일에 기록하면 됩니다.

이 파일이 바로 저희가 익숙한 xcconfig 파일 입니다.

 

다음과 같은 상황에 사용하면 유용합니다.

- 플랫폼, 아키텍처, 빌드 유형에 따른 설정 분리

- 설정의 가시성 향상
- Xcode 외부에서 설정 수정

 

 

# Build Configuration File 사용하기

 

파일 만들기에서 다음과 같은 파일을 만듭니다.

 

 

프로젝트 세팅에서 target의 debug / release 마다

생성된 config파일을 맵핑할 수 있습니다.

 

# Build Settings 값이 겹치면 어떻게 될까?

xcconfig 파일을 통해 build setting 값을 추가할 수 있었다.

그런데 이 setting값은 editor에서도 수정 가능하다. 

그렇다면 이 설정을 컨트롤 하는곳은 여러곳이라 제어권 문제가 생길 수 있다.

 

해당 문제를 살펴보기 전 위 그림을 살펴보자

target에서 build settings를 열고 levels 로 보면

각 설정값에 대한 resolved value와 어디서 값을 채택(초록 박스)하고, 기본값이 아닌 수정값인지(볼드체) 볼 수 있다.

 

그렇다면 설정 값에 대한 우선순위는 어떻게 될까?

공식문서에 따르면

 

• Target-level values: 타겟 수준 값
• Configuration settings file values mapped to a target: 타겟에 매핑된 설정 파일 값
• Project-level values: 프로젝트 수준 값
• Configuration settings file mapped to the project: 프로젝트에 매핑된 설정 파일 값
• System default values: 시스템 기본값

의 순서로 우선순위를 가진다.

 

 

 

오늘 build configuration에 대해 알아봤다.

협업시 configuration 값을 바꿀 때 우선순위를 잘 확인하여 바꿔야하며

editor에서 바뀐 값이 잘 적용되었는지 확인이 필요하다는 점을 배웠다.