C++ 툴체인 사용하기

Thu, 13 Aug 2026 00:00:00 +0000

C++ 사용을 위한 기본 관리 도구

기본적으로 모든 작업은 MacOS 기준으로 작성했다.
추후 필요하다면 Windows 환경에서도 사용할수 있도록 내용을 추가할 예정

대표적인 관리도구

CMake 빌드 및 설정
- CMake 홈페이지
vcpkg 패키지 관리
- microsoft 에서 관리하는 c++ 패키지 매니저
- vcpkg 홈페이지
- vcpkg 레포지토리

cmake 설치하기

MacOS 기준 Brew로 설치하는 것이 제일 관리하기 편하다.

# brew 최신버전으로 업데이트
brew update
# cmake 실행
brew install cmake

버전을 꼭 알아두는 것이 좋다.
- CMakeLists.txt (설정파일)에서 최소 CMake 버전을 꼭 입력해야 한다.
```
cmake --version
# cmake version 3.31.4
```

vcpkg 설치하기

레포지토리에서 직접 다운로드 받아 빌드한다.

바이너리를 다운받아도 되고 레포지토리를 다운받아서 직접 빌드하해도 된다.
레포지토리를 클론하고 bootstrap-vcpkg.sh 을 실행한다.
vcpkg 프로그램이 레포지토리 root에 자동으로 빌드되어 생성된다.
```
  sh bootstrap-vcpkg.sh
```

.zshrc 등에 /bin/ 폴더 추가하여 프로그램을 바로 실행할수 있도록 준비한다.

raylib 시작하기

Thu, 13 Aug 2026 00:00:00 +0000

Raylib 시작하기

목표

CMake를 사용하여 프로젝트 생성하기
hello_world 만들기

시작하기전에

VCS 는 기본적으로 git을 사용한다.
다양한 에셋파일들은 git-lfs 를 사용하여 관리한다.

01. 프로젝트 생성하기

깃에 레포지토리를 생선한다.

.gitignore 파일 생성

# tool
.idea
.fleet
.obsidian
.vscode
.vs

# mac
DS_Store
.DS_Store

git-lfs로 바이너리 파일 등록하기
- 소스코드가 아닌 바이너리 파일들은 항상 추가하도록 한다.
- root에 .gitattributes 파일 생성된다.
```
git lfs track "*.png"
```

02. CMakeLists.txt 작성하기

root 폴더에 CMakeLists.txt 파일 생성

cmake_minimum_required(VERSION 3.14)
project([[게임이름]] C CXX)

# raylib 불러오는 코드
include(FetchContent)
FetchContent_Declare(
    raylib
    GIT_REPOSITORY https://github.com/raysan5/raylib.git
    GIT_TAG        6.0 # 원하는 버전 tag 지정 (예: 5.0, master 등)
)
FetchContent_MakeAvailable(raylib)

# 빌드 옵션
set(BUILD_EXAMPLES OFF CACHE BOOL "" FORCE) # 예제 빌드 비활성화

# 실행파일 생성
add_executable(${PROJECT_NAME} [[메인파일 ex) src/main.cpp]])

# raylib 타켓 링크
target_link_libraries(${PROJECT_NAME} PRIVATE raylib)

03. hello world 추가하기

root/src/main.cpp 작성하기

#include "raylib.h"

int main() {
    // 1. 창 크기와 제목 설정 후 초기화
    const int screenWidth = 800;
    const int screenHeight = 450;
    InitWindow(screenWidth, screenHeight, "raylib - Hello World");

    // 2. 초당 프레임 수(FPS)를 60으로 설정
    SetTargetFPS(60);

    // 3. 메인 게임 루프 (ESC 키나 닫기 버튼을 누르면 종료)
    while (!WindowShouldClose()) {
        // --- 렌더링 시작 ---
        BeginDrawing();

        // 배경색을 흰색으로 칠하기
        ClearBackground(RAYWHITE);

        // 텍스트 그리기: (내용, X좌표, Y좌표, 폰트크기, 색상)
        // MeasureText()를 활용해 텍스트를 정중앙에 배치합니다.
        int textWidth = MeasureText("Hello World!", 40);
        DrawText("Hello World!", (screenWidth - textWidth) / 2, (screenHeight - 40) / 2, 40, DARKGRAY);

        // --- 렌더링 종료 ---
        EndDrawing();
    }

    // 4. 창을 닫고 리소스 해제
    CloseWindow();

    return 0;
}

04. 실행하기

맥에서 Metal 사용권장을 하기위해 OpenGL 사용시 에러메세제지를 발생시킨다.
- CLion 설정에서 다음을 추가한다.
- CMake options에 “-Wno-dev” 추가

Mon, 01 Jan 0001 00:00:00 +0000

C++ 툴체인 사용하기

C++ 사용을 위한 기본 관리 도구

대표적인 관리도구

cmake 설치하기

vcpkg 설치하기

raylib 시작하기

Raylib 시작하기

목표

시작하기전에

01. 프로젝트 생성하기

02. CMakeLists.txt 작성하기

03. hello world 추가하기

04. 실행하기

index