CMake GUI로 오픈 소스 프로젝트 빌드하는 방법

😢상황

• GitHub 등에서 오픈 소스 프로젝트를 내려받았는데, 소스코드만 제공되고 실행 파일이 없음
• CMakeLists.txt 파일은 존재함
• CMake GUI를 사용해서 프로젝트를 빌드하고 싶은데, 절차를 잘 모름

---

🛠️해결법

준비물

• CMake (공식 웹사이트에서 다운로드)
• Visual Studio, MinGW 등 CMake가 호출할 수 있는 빌드 툴체인

---

CMake GUI로 빌드하기 단계별 가이드(obs-studio 빌드)

1. CMake GUI 실행

2. Where is the source code:
   • 오픈 소스 프로젝트의 최상위 폴더 선택 (여기에 CMakeLists.txt 파일이 있어야 함)

     
     최상위 폴더 지정

3. Where to build the binaries:
   • 별도 빌드 폴더 선택 (예: build/)
   • 소스 코드 폴더 안에 build 폴더를 따로 만드는 것이 깔끔

     
     빌드 폴더 지정

4. Configure 버튼 클릭
   • 빌드할 플랫폼(예: Visual Studio 2022 x64)을 선택

     
     configure 빌드 플랫폼 설정

   • 초기 설정값을 생성

     
     초기 설정값 생성

   • Configure 버튼을 다시 눌렀을 때 에러 없이 끝나면 설정 항목들이 붉은색 → 흰색으로 바뀜

     
     Configure 다시 눌렀을 때

5. 필요시 옵션 수정
   • ENABLE_TESTS, BUILD_EXAMPLES 등 커스텀 옵션 체크/해제 가능
6. Generate 버튼 클릭
   • Visual Studio 솔루션 파일(.sln) 또는 Makefile 생성

     
     Generate 버튼 눌렀을 때

7. 빌드하기
   • Visual Studio를 열어 .sln 파일로 빌드하거나
   • 명령어로 빌드(cmake --build .)

     
     .sln 빌드

---

주의할 점

• 빌드 폴더를 소스 폴더와 분리하는 습관을 들이세요 (Out-of-Source 빌드)
• 빌드 옵션은 프로젝트에 따라 다를 수 있으니 README.md 참고
• 종종 추가 라이브러리가 필요한 경우가 있으니 CMake 출력 메시지 주의 깊게 읽기

---

✅정리: 왜 이게 효과 있었는가?

• CMake GUI를 사용하면 초기 설정을 시각적으로 쉽게 확인할 수 있어 초심자에게 특히 유리
• 빌드 옵션 수정 → 프로젝트 구조 파악 → 플랫폼별 빌드 환경 세팅까지 가능
• Visual Studio, MinGW, Ninja 등 다양한 빌드 백엔드 지원