CMake의 Variables와 관련된 CMAKE_INCLUDE_DIRECTORIES_PROJECT_BEFORE 프로그래밍

2024-04-02

CMake의 CMAKE_INCLUDE_DIRECTORIES_PROJECT_BEFORE 변수

CMAKE_INCLUDE_DIRECTORIES_PROJECT_BEFORE는 프로젝트 빌드 시 컴파일러 명령줄에 포함되는 디렉토리 순서를 제어하는 CMake 변수입니다. 이 변수를 사용하면 프로젝트 소스 디렉토리와 바이너리 디렉토리를 다른 포함 디렉토리보다 우선시하여 컴파일러가 프로젝트 헤더 파일을 먼저 찾도록 지정할 수 있습니다.

사용법:

  • 기본값: OFF
  • 옵션:
    • ON: 프로젝트 소스 및 바이너리 디렉토리를 포함 디렉토리 목록의 앞쪽에 추가합니다.

예시:

set(CMAKE_INCLUDE_DIRECTORIES_PROJECT_BEFORE ON)

include_directories(
    "external/library"
    "src"
)

위 코드는 다음과 같은 효과를 갖습니다.

  • 컴파일러는 먼저 src 디렉토리와 CMAKE_BINARY_DIR (바이너리 디렉토리)를 검색합니다.
  • 그 후 external/library 디렉토리를 검색합니다.

주의 사항:

  • CMAKE_INCLUDE_DIRECTORIES_PROJECT_BEFORE를 사용하면 프로젝트 빌드 시스템에 대한 의존성을 추가할 수 있습니다. 다른 프로젝트와 함께 사용하거나 배포하려는 경우 이 변수를 주의해서 사용해야 합니다.
  • CMAKE_INCLUDE_DIRECTORIES_BEFORE는 프로젝트 내 포함 디렉토리 순서에만 영향을 미칩니다. 시스템 헤더 파일 검색 순서는 여전히 운영 체제 및 컴파일러 설정에 따라 결정됩니다.


예제 코드

# 프로젝트 소스 및 바이너리 디렉토리를 포함 디렉토리 목록 앞에 추가합니다.
set(CMAKE_INCLUDE_DIRECTORIES_PROJECT_BEFORE ON)

# 프로젝트 헤더 파일
include_directories("src")

# 외부 라이브러리 헤더 파일
include_directories("external/library")

# 컴파일러는 먼저 `src` 디렉토리와 `CMAKE_BINARY_DIR` (바이너리 디렉토리)를 검색합니다.
# 그 후 `external/library` 디렉토리를 검색합니다.

add_executable(my_program main.cpp)

이 예시에서 컴파일러는 먼저 src 디렉토리와 CMAKE_BINARY_DIR (바이너리 디렉토리)를 검색합니다. 그 후 external/library 디렉토리를 검색합니다.

다른 예시:

  • 여러 개의 프로젝트 소스 디렉토리가 있는 경우:
set(CMAKE_INCLUDE_DIRECTORIES_PROJECT_BEFORE ON)

include_directories("src1")
include_directories("src2")

# ...
  • 프로젝트 소스 디렉토리를 제외하고 싶은 경우:
set(CMAKE_INCLUDE_DIRECTORIES_PROJECT_BEFORE OFF)

include_directories("external/library")
include_directories("src")

# ...


CMAKE_INCLUDE_DIRECTORIES_PROJECT_BEFORE 대체 방법

include_directories 명령어 순서 조정:

# 프로젝트 헤더 파일
include_directories("src")

# 외부 라이브러리 헤더 파일
include_directories("external/library")

# ...

위 코드는 CMAKE_INCLUDE_DIRECTORIES_PROJECT_BEFORE를 사용하지 않고 동일한 결과를 얻습니다. src 디렉토리는 external/library 디렉토리보다 먼저 포함되므로 컴파일러는 먼저 src 디렉토리를 검색합니다.

TARGET_INCLUDE_DIRECTORIES 속성 사용:

# 프로젝트 헤더 파일
target_include_directories(my_program PUBLIC "src")

# 외부 라이브러리 헤더 파일
target_include_directories(my_program PRIVATE "external/library")

# ...

add_executable(my_program main.cpp)

위 코드는 TARGET_INCLUDE_DIRECTORIES 속성을 사용하여 my_program 타겟에 대한 포함 디렉토리를 지정합니다. PUBLIC 키워드는 my_program 타겟과 그 종속성이 src 디렉토리를 포함하도록 설정합니다. PRIVATE 키워드는 my_program 타겟만 external/library 디렉토리를 포함하도록 설정합니다.

CMakeLists.txt 파일 구조 조정:

# 프로젝트 헤더 파일
include_directories("src")

# ...

# 외부 라이브러리 헤더 파일
include_directories("external/library")

# ...

위 코드는 external/library 디렉토리를 포함하는 CMakeLists.txt 파일을 별도로 만들고 add_subdirectory 명령을 사용하여 프로젝트에 포함시킬 수 있습니다.

주의:

  • 위에 나열된 대체 방법은 특정 상황에 따라 더 적합할 수 있습니다.
  • CMAKE_INCLUDE_DIRECTORIES_PROJECT_BEFORE를 사용하는 것이 더 간단하고 명확한 경우도 있습니다.
  • 프로젝트에 가장 적합한 방법을 선택하는 것이 중요합니다.



CMake에서 target_link_libraries() 함수 활용: 완벽한 가이드

함수 기본 구조:주요 파라미터:<타겟 이름>: 링크를 설정할 타겟의 이름입니다.PUBLIC | PRIVATE | INTERFACE: 링크 유형을 지정합니다. PUBLIC: 타겟을 사용하는 다른 타겟에서도 해당 라이브러리에 대한 의존성이 명시됩니다



CMake의 "Commands"와 관련된 "ctest_upload()" 프로그래밍

ctest_upload() 함수 사용 방법:CMakeLists. txt 파일에 ctest_upload() 함수를 추가합니다.함수의 첫 번째 인수는 업로드할 결과 파일의 경로를 지정합니다.두 번째 인수는 서버의 URL을 지정합니다


CMake의 "Commands"와 관련된 "source_group()" 사용법: 코드 작성 및 그룹화

source_group() 명령에는 두 가지 서로 다른 형식이 있습니다.1. 개별 파일 그룹화이 형식은 지정된 이름으로 그룹을 만들고 그룹에 포함될 소스 파일을 개별적으로 나열하거나 정규 표현식을 사용하여 일치하는 파일을 자동으로 추가합니다


CMake에서 CUDA 아키텍처 설정하기

CUDAARCHS 설정 방법CUDAARCHS는 다음과 같은 방법으로 설정할 수 있습니다.CMakeLists. txt 파일:명령행:CUDAARCHS의 작동 방식CMake는 CUDAARCHS 변수에 지정된 아키텍처마다 별도의 컴파일 작업을 수행합니다


CMake 매뉴얼 언어 프로그래밍

CMake 매뉴얼 언어는 다음과 같은 프로그래밍 요소를 사용하여 프로젝트 빌드를 구성합니다.변수는 CMakeLists. txt 파일에서 값을 저장하고 사용하는 데 사용됩니다. 변수는 프로젝트 경로, 소스 파일 목록



CMake "Variables"에서 CMAKE_AUTOGEN_ORIGIN_DEPENDS 프로그래밍: 심층 분석

CMAKE_AUTOGEN_ORIGIN_DEPENDS는 CMake 3.14 버전에서 도입된 변수입니다._autogen 타겟에 원본 타겟의 종속성을 전달하는 것을 제어합니다.기본값은 ON이며, 이는 _autogen 타겟이 빌드될 때 원본 타겟의 모든 종속성도 빌드된다는 것을 의미합니다


CMake에서 CUDA 아키텍처 설정하기

CUDAARCHS 설정 방법CUDAARCHS는 다음과 같은 방법으로 설정할 수 있습니다.CMakeLists. txt 파일:명령행:CUDAARCHS의 작동 방식CMake는 CUDAARCHS 변수에 지정된 아키텍처마다 별도의 컴파일 작업을 수행합니다


CMake Variables: CMAKE_WARN_DEPRECATED 프로그래밍

기본값:ON: 기본적으로 CMAKE_WARN_DEPRECATED는 ON으로 설정되어 있어 더 이상 사용되지 않는 기능 사용 시 경고 메시지를 표시합니다.OFF: CMAKE_WARN_DEPRECATED를 OFF로 설정하면 경고 메시지가 표시되지 않습니다


CMake의 "Commands"와 관련된 "source_group()" 사용법: 코드 작성 및 그룹화

source_group() 명령에는 두 가지 서로 다른 형식이 있습니다.1. 개별 파일 그룹화이 형식은 지정된 이름으로 그룹을 만들고 그룹에 포함될 소스 파일을 개별적으로 나열하거나 정규 표현식을 사용하여 일치하는 파일을 자동으로 추가합니다


CMake에서 테스트 결과 평가: "PASS_REGULAR_EXPRESSION" 심층 분석

기본 구문:my_test: 테스트 이름정규 표현식: 테스트 결과 문자열에서 일치해야 하는 패턴사용 예시:테스트 출력에 특정 문구가 포함된 경우 성공:테스트 종료 코드가 0인 경우 성공:여러 조건을 OR 연산자로 연결: