LMMS Windows 개발 환경 설정 가이드

이 가이드는 Windows 환경에서 LMMS 소스 코드를 빌드하고 개발 환경을 설정하는 과정을 설명합니다.

LMMS는 C++와 Qt를 기반으로 하며, 여러 외부 라이브러리와 도구를 필요로 합니다. 

1. 필수 도구 설치

LMMS를 빌드하려면 다음 도구와 라이브러리를 설치해야 합니다.

1.1. Git

• 설명: Git은 소스 코드 관리 도구로, 이미 클론하셨으므로 설치가 완료된 것으로 가정합니다.
• 확인:

  git --version

  • 설치되지 않았다면, Git for Windows에서 다운로드하여 설치하세요.

1.2. CMake

• 설명: CMake는 LMMS 빌드 시스템으로 사용됩니다.
• 설치:
  • CMake 공식 웹사이트에서 최신 Windows 바이너리를 다운로드 (예: cmake-x.y.z-windows-x86_64.msi).
  • 설치 후 PATH에 추가 (설치 시 "Add CMake to the system PATH for all users" 선택).
• 확인:

  cmake --version

1.3. C++ 컴파일러 (MSYS2 또는 Visual Studio)

LMMS는 Windows에서 MSYS2 (MinGW) 또는 Visual Studio를 사용하여 빌드할 수 있습니다. MSYS2를 권장합니다 (공식 문서에서 선호).

MSYS2 설치

• 설명: MSYS2는 MinGW-w64 컴파일러와 개발 도구를 제공하는 Windows용 환경입니다.
• 설치:
  1. MSYS2 공식 웹사이트에서 설치 프로그램 (msys2-x86_64-latest.exe) 다운로드.
  2. 설치 후 MSYS2 MinGW 64-bit 터미널 실행 (C:\msys64\mingw64.exe).
  3. MSYS2 패키지 업데이트:

     pacman -Syu

     터미널을 닫고 다시 열어 업데이트 완료:

     pacman -Su

  4. 필수 개발 도구 설치:

     pacman -S mingw-w64-x86_64-toolchain mingw-w64-x86_64-cmake mingw-w64-x86_64-make

• 확인:

  gcc --version
  g++ --version

Visual Studio (선택적)

• MSYS2 대신 Visual Studio를 사용할 경우:
  1. Visual Studio Community 2022 다운로드 및 설치.
  2. "Desktop development with C++" 워크로드 선택.
  3. CMake와 통합 가능하도록 설정.

1.4. Qt

• 설명: LMMS는 Qt 프레임워크로 GUI를 구현합니다. Qt 5.15.x 이상 권장.
• 설치:
  1. Qt 공식 웹사이트에서 Qt Online Installer 다운로드.
  2. 설치 시 MinGW-w64 컴파일러와 호환되는 Qt 버전 선택 (예: Qt 5.15.2, MinGW 8.1.0 64-bit).
  3. 설치 경로 기록 (예: C:\Qt\5.15.2\mingw81_64).
• 환경 변수 설정:
  • Qt bin 디렉토리를 PATH에 추가: 
  • set PATH=%PATH%;C:\Qt\5.15.2\mingw81_64\bin
  • MSYS2 터미널에서:

    export PATH=$PATH:/c/Qt/5.15.2/mingw81_64/bin
    

1.5. 종속성 설치 (MSYS2)

MSYS2를 사용하여 LMMS 빌드에 필요한 라이브러리를 설치합니다:

pacman -S mingw-w64-x86_64-fftw mingw-w64-x86_64-libsndfile mingw-w64-x86_64-libsamplerate mingw-w64-x86_64-libvorbis mingw-w64-x86_64-flac mingw-w64-x86_64-portaudio mingw-w64-x86_64-libogg mingw-w64-x86_64-lame mingw-w64-x86_64-fluidsynth mingw-w64-x86_64-libgig

• 참고: 일부 패키지는 선택적이지만, 전체 기능을 위해 모두 설치 권장.

1.6. VST 지원 (선택적)

• VST 플러그인 개발/테스트를 위해 VST2 SDK가 필요할 수 있습니다.
  • VST2 SDK는 더 이상 공식 배포되지 않으므로, 기존 프로젝트에서 다운로드하거나 대체로 VST3 SDK 사용.
  • VST3 SDK를 다운로드하여 VST3_SDK 환경 변수에 경로 설정:

    export VST3_SDK=/path/to/vst3sdk

2. 소스 코드 클론 확인

이미 클론하셨으므로, LMMS 소스 디렉토리로 이동:

cd /path/to/lmms

• 확인: 최신 브랜치로 업데이트:

  git checkout master
  git pull origin master
  

3. 빌드 환경 설정

1. 빌드 디렉토리 생성:
2. mkdir build cd build
3. CMake 실행:
   MSYS2 MinGW 64-bit 터미널에서:
   • CMAKE_PREFIX_PATH는 Qt 설치 경로에 맞게 조정.
   • Visual Studio를 사용하는 경우:

     cmake .. -G "Visual Studio 17 2022"
     

4. cmake .. -G "MinGW Makefiles" -DCMAKE_PREFIX_PATH=/c/Qt/5.15.2/mingw81_64
5. 빌드:
   • Visual Studio의 경우, .sln 파일을 열어 빌드하거나:

     cmake --build . --config Release
     

6. mingw32-make -j$(nproc)

4. 실행 및 디버깅

• 빌드 성공 시, 실행 파일은 build/src/lmms.exe에 생성됩니다.
• 실행:

  ./src/lmms
  

• 디버깅:
  • Qt Creator를 사용해 디버깅:
    1. Qt Creator 설치.
    2. lmms.pro 파일을 Qt Creator로 열기.
    3. MinGW 또는 MSVC 키트 설정 후 디버깅 모드로 실행.

5. 개발 환경 설정 (IDE)

Qt Creator (권장)

• Qt 설치 시 함께 제공되는 Qt Creator를 사용.
• 설정:
  1. Qt Creator 실행.
  2. File > Open File or Project에서 lmms.pro 선택.
  3. MinGW 컴파일러와 Qt 5.15.x 키트 설정.
  4. 빌드 및 디버깅 환경 구성.

Visual Studio Code (선택적)

• 확장 프로그램 설치:
  • C/C++ Extension
  • CMake Tools
• 설정:
  • tasks.json과 launch.json을 구성하여 CMake와 MinGW를 사용.
  • 예시 tasks.json:

    {
      "version": "2.0.0",
      "tasks": [
        {
          "label": "Build LMMS",
          "type": "shell",
          "command": "mingw32-make",
          "group": {
            "kind": "build",
            "isDefault": true
          },
          "options": {
            "cwd": "${workspaceFolder}/build"
          }
        }
      ]
    }
    

6. 문제 해결

• CMake 오류:
  • Qt 경로가 잘못된 경우: CMAKE_PREFIX_PATH 확인.
  • 종속성 누락: pacman -S <패키지명>으로 설치.
• 빌드 오류:
  • MinGW 버전 확인: 최신 MS