ServBay로 소프트웨어 패키지 재컴파일하기
ServBay는 macOS 및 Windows 사용자를 위한 강력한 로컬 웹 개발 환경을 제공하며, 다양한 소프트웨어 패키지와 도구가 내장되어 있습니다. 기본 제공 패키지 외에도, 개발자는 특정 요구에 맞춰 재컴파일을 진행해야 할 때가 있습니다. 예를 들어:
- 특정 패키지에 별도의 컴파일 옵션을 적용해야 할 때
- ServBay에 기본 포함되지 않은 모듈이나 확장(예: 신규 PHP 확장 또는 PostgreSQL 모듈)을 추가하고 싶을 때
- ServBay 기본 버전 대신 특정 라이브러리를 쓰고 싶을 때
- ServBay 제공 패키지를 커스터마이징해서 적용하고 싶을 때
ServBay는 이러한 재컴파일 작업을 쉽게 할 수 있도록 필수 컴파일 환경과 툴체인을 제공합니다.
성공적인 재컴파일을 위해, 사용자는 OS별 기본 소프트웨어 빌드 흐름을 이해하고 있어야 합니다:
- macOS/Linux:
configure,make,make install등 Unix/Linux 빌드 도구 사용 - Windows: Visual Studio 빌드 시스템, MSBuild, cmake 등 컴파일 환경
필수 준비사항
재컴파일을 시작하기 전에, 아래 조건을 반드시 충족해 주세요.
ServBay Development Library 설치:
ServBay 환경에서 컴파일 시 필요한 모든 라이브러리 및 헤더파일 등 개발 리소스를 제공하는 핵심 패키지입니다. ServBay 애플리케이션의 패키지 패널에서 쉽게 설치할 수 있습니다.
개발 도구 설치:
macOS
Xcode Command Line Tools 설치:
macOS 시스템에서 필수적인 개발 도구입니다. 터미널을 열고 다음 명령어로 설치하세요:bashxcode-select --install이미 설치된 경우 알림이 뜹니다.
추가 빌드 도구 설치:
오픈소스 소프트웨어 대부분을 컴파일하려면autoconf·automake·libtool등도 필요합니다. Homebrew 패키지 매니저로 다음 명령으로 설치할 수 있습니다:bashbrew install autoconf automake libtool cmakeHomebrew 미설치 시, 공식 홈페이지 안내를 참조하세요.
Windows
Visual Studio Build Tools 또는 Visual Studio Community 설치:
Windows에서는 MSVC 컴파일러와 빌드 도구가 필요합니다. 아래 방법 중 하나를 선택하세요:방법 1: Visual Studio Build Tools (추천, 용량이 적음)
- Visual Studio Build Tools를 다운로드·설치
- 설치 중 "C++ build tools" 워크로드 선택
- 아래 구성요소를 포함:
- MSVC v143 - VS 2022 C++ x64/x86 빌드 도구
- 최신 Windows 11 SDK
- CMake 툴
방법 2: Visual Studio Community
- Visual Studio Community를 다운로드·설치
- 설치 중 "C++ 데스크톱 개발" 워크로드 선택
- CMake 툴과 Windows SDK 포함 여부 확인
추가 도구 설치:
일부 오픈소스에서는 다음 도구가 필요할 수 있습니다:- Git for Windows: 소스코드 다운로드 용도
- MSYS2 또는 vcpkg: C/C++ 라이브러리 관리
- Python: 일부 빌드 스크립트에 필요
powershell# chocolatey로 추가 도구 설치 (선택) choco install git cmake python msys2
컴파일 환경 변수 설정
ServBay Development Library 및 필수 도구 설치 후에는 컴파일 환경을 초기화해야 합니다. 주요 작업은 환경변수 설정으로, 컴파일러 및 빌드 시스템이 ServBay의 라이브러리·헤더·실행파일 등의 위치를 제대로 인식할 수 있게 해줍니다.
OS 및 CPU 아키텍처에 따라 환경 설정 방법이 다릅니다.
macOS
ServBay는 사용 중인 Mac의 CPU 아키텍처(인텔(x86_64) 또는 Apple Silicon(Arm64))에 따라 런타임을 제공합니다. 현재 ServBay Runtime 구조에 맞는 환경 초기화 명령어를 선택해야 합니다.
Windows
Windows용 ServBay는 x64 아키텍처를 지원하며 C:\ServBay에 설치됩니다.
ServBay Runtime CPU 아키텍처 확인
macOS
ServBay의 bin 폴더에 있는 임의 실행파일로 아키텍처를 간단히 확인할 수 있습니다. 예시로 bison을 체크:
bash
# 터미널에서 명령 실행하여 확인
$ file /Applications/ServBay/bin/bison
/Applications/ServBay/bin/bison: Mach-O 64-bit executable arm64bash
# 터미널에서 명령 실행하여 확인
$ file /Applications/ServBay/bin/bison
/Applications/ServBay/bin/bison: Mach-O 64-bit executable x86_64Windows
Windows 버전 ServBay는 x64만 지원합니다. PowerShell에서 실행파일 정보를 확인할 수 있습니다:
powershell
# PowerShell에서 아래 명령 실행하여 확인
PS> Get-Command "C:\ServBay\bin\bison.exe" | Select-Object -ExpandProperty FileVersionInfo | Select-Object ProductName, FileDescription또는 파일 속성에서 직접 아키텍처를 확인할 수 있습니다.
아키텍처를 확인한 후, 결과에 맞는 환경 초기화 스크립트를 선택하세요.
컴파일 환경 변수 초기화
OS 및 아키텍처에 따라 맞는 환경 초기화 스크립트를 선택해야 합니다.
macOS
새 터미널 창을 열고, CPU 아키텍처에 맞는 아래 스크립트를 복사해 실행하세요. 환경 변수들이 자동으로 설정됩니다.
bash
# CPU 코어 개수 지정(병렬 빌드용)
CPU_NUMBER=$(sysctl -n hw.ncpu)
# ServBay 설치 경로
SERVBAY_BASE_FULL_PATH="/Applications/ServBay"
# 패키지 디렉터리명
SERVBAY_PACKAGE_DIR_NAME="package"
# 패키지 전체 경로
SERVBAY_PACKAGE_FULL_PATH="${SERVBAY_BASE_FULL_PATH}/${SERVBAY_PACKAGE_DIR_NAME}"
# 바이너리 경로
SERVBAY_BIN_PATH="${SERVBAY_PACKAGE_FULL_PATH}/bin"
SERVBAY_SBIN_PATH="${SERVBAY_PACKAGE_FULL_PATH}/sbin"
# 환경·데이터·라이브러리 경로 등
SERVBAY_ETC_PATH="${SERVBAY_PACKAGE_FULL_PATH}/etc"
SERVBAY_VAR_PATH="${SERVBAY_PACKAGE_FULL_PATH}/var"
SERVBAY_COMMON_PATH="${SERVBAY_PACKAGE_FULL_PATH}/common"
SERVBAY_COMMON_INCLUDE_PATH="${SERVBAY_COMMON_PATH}/include"
SERVBAY_COMMON_LIB_PATH="${SERVBAY_COMMON_PATH}/lib"
SERVBAY_COMMON_LIBEXEC_PATH="${SERVBAY_COMMON_PATH}/libexec"
SERVBAY_COMMON_SHARE_PATH="${SERVBAY_COMMON_PATH}/share"
SERVBAY_COMMON_MAN_PATH="${SERVBAY_COMMON_PATH}/man"
SERVBAY_COMMON_DOC_PATH="${SERVBAY_COMMON_PATH}/doc"
SERVBAY_BUILD_DIR=$(pwd)
SERVBAY_BUILD_SRC_DIR=${SERVBAY_BUILD_DIR}/src
OPENSSL_SELECTED_VERSION="3.2"
OPENSSL_VERSION="3.2.1"
BUILD_OS_MIN_VERSION="12.00" # macOS Monterey 이상
BUILD_CPU_ARCH="-arch arm64"
BUILD_CPU_ARCH_CMAKE="arm64"
BUILD_MACOS_TARGET="" # Arm64는 일반적으로 불필요
# 컴파일러 옵션: 최적화, OS 최소버전, 아키텍처
export CFLAGS="-Qunused-arguments -O3 -mmacosx-version-min=${BUILD_OS_MIN_VERSION} ${BUILD_CPU_ARCH} ${BUILD_MACOS_TARGET}"
# 링크 옵션: rpath, 라이브러리 경로 등
export LDFLAGS="-Wl,-rpath -Wl,${SERVBAY_COMMON_LIB_PATH} -L${SERVBAY_COMMON_LIB_PATH} -L${SERVBAY_PACKAGE_FULL_PATH} -mmacosx-version-min=${BUILD_OS_MIN_VERSION} ${BUILD_CPU_ARCH} ${BUILD_MACOS_TARGET}"
# 헤더 포함 경로
export CPPFLAGS="-I${SERVBAY_COMMON_INCLUDE_PATH}"
export CXXFLAGS="-Qunused-arguments -O3 -mmacosx-version-min=${BUILD_OS_MIN_VERSION} ${BUILD_CPU_ARCH} ${BUILD_MACOS_TARGET}"
# 실행파일 검색 경로(ServBay 우선)
export PATH="${SERVBAY_BIN_PATH}:${SERVBAY_SBIN_PATH}:/usr/bin:/bin:/usr/sbin:/sbin:/Library/Apple/usr/bin"
export PKG_CONFIG_PATH="${SERVBAY_COMMON_LIB_PATH}/pkgconfig"
export PKG_CONFIG="${SERVBAY_BIN_PATH}/pkg-config"
export PKG_CONFIG_LIBDIR="${SERVBAY_COMMON_LIB_PATH}/pkgconfig"
export PATH=$PATH:"/usr/local/bin:/usr/local/sbin"
export PATH=$PATH:"/opt/homebrew/bin/" # Homebrew 기본 경로
# OpenSSL 라이브러리 및 헤더 추가
export LDFLAGS="-L${SERVBAY_COMMON_PATH}/openssl/${OPENSSL_SELECTED_VERSION}/lib ${LDFLAGS}"
export CPPFLAGS="-I${SERVBAY_COMMON_PATH}/openssl/${OPENSSL_SELECTED_VERSION}/include ${CPPFLAGS}"
export PKG_CONFIG_PATH="${PKG_CONFIG_PATH}:${SERVBAY_COMMON_PATH}/openssl/${OPENSSL_SELECTED_VERSION}/lib/pkgconfig"
export PKG_CONFIG_LIBDIR="${PKG_CONFIG_LIBDIR}:${SERVBAY_COMMON_PATH}/openssl/${OPENSSL_SELECTED_VERSION}/lib/pkgconfig"
# 환경 변수 설정 완료 후, 본 터미널에서 컴파일을 진행할 수 있습니다.
echo "ServBay Arm64 컴파일 환경이 설정되었습니다."bash
# CPU 코어 개수 지정(병렬 빌드용)
CPU_NUMBER=$(sysctl -n hw.ncpu)
# ServBay 설치 경로
SERVBAY_BASE_FULL_PATH="/Applications/ServBay"
# 패키지 디렉터리명
SERVBAY_PACKAGE_DIR_NAME="package"
# 패키지 전체 경로
SERVBAY_PACKAGE_FULL_PATH="${SERVBAY_BASE_FULL_PATH}/${SERVBAY_PACKAGE_DIR_NAME}"
# 바이너리 경로
SERVBAY_BIN_PATH="${SERVBAY_PACKAGE_FULL_PATH}/bin"
SERVBAY_SBIN_PATH="${SERVBAY_PACKAGE_FULL_PATH}/sbin"
# 환경·데이터·라이브러리 경로 등
SERVBAY_ETC_PATH="${SERVBAY_PACKAGE_FULL_PATH}/etc"
SERVBAY_VAR_PATH="${SERVBAY_PACKAGE_FULL_PATH}/var"
SERVBAY_COMMON_PATH="${SERVBAY_PACKAGE_FULL_PATH}/common"
SERVBAY_COMMON_INCLUDE_PATH="${SERVBAY_COMMON_PATH}/include"
SERVBAY_COMMON_LIB_PATH="${SERVBAY_COMMON_PATH}/lib"
SERVBAY_COMMON_LIBEXEC_PATH="${SERVBAY_COMMON_PATH}/libexec"
SERVBAY_COMMON_SHARE_PATH="${SERVBAY_COMMON_PATH}/share"
SERVBAY_COMMON_MAN_PATH="${SERVBAY_COMMON_PATH}/man"
SERVBAY_COMMON_DOC_PATH="${SERVBAY_COMMON_PATH}/doc"
SERVBAY_BUILD_DIR=$(pwd)
SERVBAY_BUILD_SRC_DIR=${SERVBAY_BUILD_DIR}/src
OPENSSL_SELECTED_VERSION="1.1.1u"
OPENSSL_VERSION="1.1.1u"
BUILD_OS_MIN_VERSION="12.00" # macOS Monterey 이상
BUILD_CPU_ARCH="-arch x86_64"
BUILD_CPU_ARCH_CMAKE="x86_64"
BUILD_MACOS_TARGET="-target x86_64-apple-macos${BUILD_OS_MIN_VERSION}"
# 컴파일러 옵션: 최적화, OS 최소버전, 아키텍처, 타겟
export CFLAGS="-Qunused-arguments -O3 -mmacosx-version-min=${BUILD_OS_MIN_VERSION} ${BUILD_CPU_ARCH} ${BUILD_MACOS_TARGET}"
export LDFLAGS="-Wl,-rpath -Wl,${SERVBAY_COMMON_LIB_PATH} -L${SERVBAY_COMMON_LIB_PATH} -L${SERVBAY_PACKAGE_FULL_PATH} -mmacosx-version-min=${BUILD_OS_MIN_VERSION} ${BUILD_CPU_ARCH} ${BUILD_MACOS_TARGET}"
export CPPFLAGS="-I${SERVBAY_COMMON_INCLUDE_PATH}"
export CXXFLAGS="-Qunused-arguments -O3 -mmacosx-version-min=${BUILD_OS_MIN_VERSION} ${BUILD_CPU_ARCH} ${BUILD_MACOS_TARGET}"
export PATH="${SERVBAY_BIN_PATH}:${SERVBAY_SBIN_PATH}:/usr/bin:/bin:/usr/sbin:/sbin:/Library/Apple/usr/bin"
export PKG_CONFIG_PATH="${SERVBAY_COMMON_LIB_PATH}/pkgconfig"
export PKG_CONFIG="${SERVBAY_BIN_PATH}/pkg-config"
export PKG_CONFIG_LIBDIR="${SERVBAY_COMMON_LIB_PATH}/pkgconfig"
export PATH=$PATH:"/usr/local/bin:/usr/local/sbin"
export PATH=$PATH:"/opt/homebrew/bin/" # Homebrew 기본 경로
# OpenSSL 라이브러리 및 헤더 추가
export LDFLAGS="-L${SERVBAY_COMMON_PATH}/openssl/${OPENSSL_SELECTED_VERSION}/lib ${LDFLAGS}"
export CPPFLAGS="-I${SERVBAY_COMMON_PATH}/openssl/${OPENSSL_SELECTED_VERSION}/include ${CPPFLAGS}"
export PKG_CONFIG_PATH="${PKG_CONFIG_PATH}:${SERVBAY_COMMON_PATH}/openssl/${OPENSSL_SELECTED_VERSION}/lib/pkgconfig"
export PKG_CONFIG_LIBDIR="${PKG_CONFIG_LIBDIR}:${SERVBAY_COMMON_PATH}/openssl/${OPENSSL_SELECTED_VERSION}/lib/pkgconfig"
# 환경 변수 설정 완료 후, 본 터미널에서 컴파일을 진행할 수 있습니다.
echo "ServBay x86_64 컴파일 환경이 설정되었습니다."Windows
Windows에서는 PowerShell 또는 Developer Command Prompt에서 환경변수를 설정합니다. 아래 스크립트는 Windows x64 용입니다.
powershell
# CPU 코어 수(병렬 빌드 용도)
$CPU_NUMBER = (Get-WmiObject -Class Win32_Processor).NumberOfLogicalProcessors
# ServBay 설치 경로
$SERVBAY_BASE_FULL_PATH = "C:\ServBay"
$SERVBAY_PACKAGE_DIR_NAME = "package"
$SERVBAY_PACKAGE_FULL_PATH = "${SERVBAY_BASE_FULL_PATH}\${SERVBAY_PACKAGE_DIR_NAME}"
# 바이너리·헤더·라이브러리 경로 등
$SERVBAY_BIN_PATH = "${SERVBAY_PACKAGE_FULL_PATH}\bin"
$SERVBAY_SBIN_PATH = "${SERVBAY_PACKAGE_FULL_PATH}\sbin"
$SERVBAY_ETC_PATH = "${SERVBAY_PACKAGE_FULL_PATH}\etc"
$SERVBAY_VAR_PATH = "${SERVBAY_PACKAGE_FULL_PATH}\var"
$SERVBAY_COMMON_PATH = "${SERVBAY_PACKAGE_FULL_PATH}\common"
$SERVBAY_COMMON_INCLUDE_PATH = "${SERVBAY_COMMON_PATH}\include"
$SERVBAY_COMMON_LIB_PATH = "${SERVBAY_COMMON_PATH}\lib"
$SERVBAY_COMMON_LIBEXEC_PATH = "${SERVBAY_COMMON_PATH}\libexec"
$SERVBAY_COMMON_SHARE_PATH = "${SERVBAY_COMMON_PATH}\share"
$SERVBAY_COMMON_DOC_PATH = "${SERVBAY_COMMON_PATH}\doc"
$SERVBAY_BUILD_DIR = Get-Location
$SERVBAY_BUILD_SRC_DIR = "${SERVBAY_BUILD_DIR}\src"
$OPENSSL_SELECTED_VERSION = "3.2"
$OPENSSL_VERSION = "3.2.1"
$BUILD_PLATFORM = "x64"
$BUILD_CONFIG = "Release"
# 환경 변수 설정
$env:SERVBAY_BASE_FULL_PATH = $SERVBAY_BASE_FULL_PATH
$env:SERVBAY_COMMON_PATH = $SERVBAY_COMMON_PATH
$env:SERVBAY_COMMON_INCLUDE_PATH = $SERVBAY_COMMON_INCLUDE_PATH
$env:SERVBAY_COMMON_LIB_PATH = $SERVBAY_COMMON_LIB_PATH
$env:PATH = "${SERVBAY_BIN_PATH};${SERVBAY_SBIN_PATH};$env:PATH"
$env:INCLUDE = "${SERVBAY_COMMON_INCLUDE_PATH};$env:INCLUDE"
$env:LIB = "${SERVBAY_COMMON_LIB_PATH};$env:LIB"
$env:LIBPATH = "${SERVBAY_COMMON_LIB_PATH};$env:LIBPATH"
$env:PKG_CONFIG_PATH = "${SERVBAY_COMMON_LIB_PATH}\pkgconfig"
# OpenSSL 라이브러리 및 헤더 포함
$env:INCLUDE = "${SERVBAY_COMMON_PATH}\openssl\${OPENSSL_SELECTED_VERSION}\include;$env:INCLUDE"
$env:LIB = "${SERVBAY_COMMON_PATH}\openssl\${OPENSSL_SELECTED_VERSION}\lib;$env:LIB"
$env:CMAKE_PREFIX_PATH = $SERVBAY_COMMON_PATH
$env:CMAKE_INSTALL_PREFIX = $SERVBAY_COMMON_PATH
Write-Host "ServBay Windows x64 컴파일 환경이 설정되었습니다."Developer Command Prompt 사용자용 배치 스크립트:
batch
@echo off
REM ServBay Windows 컴파일 환경 설정
REM ServBay 설치 경로
set SERVBAY_BASE_FULL_PATH=C:\ServBay
set SERVBAY_PACKAGE_FULL_PATH=%SERVBAY_BASE_FULL_PATH%\package
REM 경로 변수 설정
set SERVBAY_BIN_PATH=%SERVBAY_PACKAGE_FULL_PATH%\bin
set SERVBAY_COMMON_PATH=%SERVBAY_PACKAGE_FULL_PATH%\common
set SERVBAY_COMMON_INCLUDE_PATH=%SERVBAY_COMMON_PATH%\include
set SERVBAY_COMMON_LIB_PATH=%SERVBAY_COMMON_PATH%\lib
REM OpenSSL 버전
set OPENSSL_SELECTED_VERSION=3.2
REM 환경 변수 설정
set PATH=%SERVBAY_BIN_PATH%;%PATH%
set INCLUDE=%SERVBAY_COMMON_INCLUDE_PATH%;%SERVBAY_COMMON_PATH%\openssl\%OPENSSL_SELECTED_VERSION%\include;%INCLUDE%
set LIB=%SERVBAY_COMMON_LIB_PATH%;%SERVBAY_COMMON_PATH%\openssl\%OPENSSL_SELECTED_VERSION%\lib;%LIB%
set CMAKE_PREFIX_PATH=%SERVBAY_COMMON_PATH%
echo ServBay Windows 컴파일 환경 설정이 완료되었습니다.주의: 환경 변수는 현재 터미널(콘솔) 세션에서만 적용됩니다. 창을 닫거나 새로운 터미널을 열 때마다 해당 스크립트를 다시 실행하세요.
컴파일 예시
환경 변수 설정이 완료된 터미널에서 소스코드를 내려받아 실제 컴파일을 진행할 수 있습니다. 플랫폼별 주요 컴파일 예시를 들어 설명합니다.
ImageMagick 컴파일
ImageMagick는 PHP의 imagick 확장이 사용하는 강력한 이미지 처리 라이브러리입니다. ServBay 기본 설치본에 포함되어 있으므로 일반적으로 별도 빌드가 필요 없습니다. 아래 예시는 오직 ServBay 환경에서 컴파일 과정을 소개하기 위한 샘플입니다.
macOS / Linux
ImageMagick 소스코드 다운로드 및 압축 해제:
bash# 최신 버전은 필요에 따라 변경하세요 wget https://imagemagick.org/archive/releases/ImageMagick-7.1.1-33.tar.gz tar zxvf ImageMagick-7.1.1-33.tar.gz cd ImageMagick-7.1.1-33./configure스크립트 실행:
앞서 설정한 환경 변수들이 적용된 상태에서 configure 스크립트를 이용합니다.--prefix·--libdir·--includedir등은 ServBay Development Library 경로 및 하위 디렉터리를 지정해줍니다. 이렇게 해야 컴파일된 라이브러리와 헤더가 ServBay 환경 내 다른 소프트웨어(예: PHPimagick확장)와 연동될 수 있습니다. 기타 옵션은 ImageMagick의 요구에 맞게 추가하세요.bash./configure \ --prefix=${SERVBAY_COMMON_PATH} \ --libdir=${SERVBAY_COMMON_LIB_PATH} \ --includedir=${SERVBAY_COMMON_INCLUDE_PATH} \ --oldincludedir=${SERVBAY_COMMON_INCLUDE_PATH} \ --bindir=${SERVBAY_BIN_PATH} \ --sbindir=${SERVBAY_SBIN_PATH} \ --sysconfdir=${SERVBAY_ETC_PATH} \ --datarootdir=${SERVBAY_COMMON_SHARE_PATH} \ --enable-osx-universal-binary=no \ --disable-silent-rules \ --disable-opencl \ --enable-shared \ --enable-static \ --with-freetype=yes \ --with-gvc=no \ --with-modules \ --with-webp=yes \ --with-heic=no \ --without-gslib \ --with-fpx=no \ --without-openexexr \ --with-raw=yes \ --without-lqr \ --without-djvu \ --without-fftw \ --without-pango \ --without-wmf \ --without-x \ --with-gs-font-dir=${SERVBAY_COMMON_SHARE_PATH}/ghostscript/10.02.1/Resource/Fontmake및make install실행:make는 설정에 따라 실행파일 및 라이브러리를 빌드합니다.-j ${CPU_NUMBER}로 멀티코어 빌드가 가능합니다.make install로 빌드 결과물을 ServBay Development Library 경로에 설치합니다.bashmake -j ${CPU_NUMBER} make install
Windows
Windows에서는 보통 Visual Studio 또는 CMake로 ImageMagick을 빌드합니다. 컴파일 과정이 macOS보다 복잡하므로 CMake 빌드를 권장합니다.
ImageMagick 소스코드 다운로드:
powershell# curl 또는 브라우저로 다운로드 curl -O https://imagemagick.org/archive/releases/ImageMagick-7.1.1-33.tar.gz # 압축 해제(7zip 등 설치 필요) tar -xzf ImageMagick-7.1.1-33.tar.gz cd ImageMagick-7.1.1-33CMake 프로젝트 설정(Developer Command Prompt 또는 PowerShell에서):
powershell# 빌드 디렉터리 생성 mkdir builddir cd builddir # CMake 구성 cmake .. ` -DCMAKE_INSTALL_PREFIX="$env:SERVBAY_COMMON_PATH" ` -DCMAKE_BUILD_TYPE=Release ` -DBUILD_SHARED_LIBS=ON ` -DMAGICKCORE_QUANTUM_DEPTH=16 ` -DMAGICKCORE_HDRI_ENABLE=OFF ` -DWITH_BZLIB=ON ` -DWITH_ZLIB=ON ` -DWITH_PNG=ON ` -DWITH_JPEG=ON ` -DWITH_TIFF=ON ` -DWITH_FREETYPE=ON ` -DWITH_WEBP=ON빌드 및 설치:
powershellcmake --build . --config Release --parallel $CPU_NUMBER cmake --install . --config Release
cmake로 패키지 빌드하기
cmake 빌드 시스템을 사용하는 패키지의 경우, 플랫폼별 빌드 과정이 비교적 일관적입니다. 아래는 protobuf(Protocol Buffers) 빌드 예시입니다.
- protobuf 소스코드 다운로드 후 디렉터리 이동
macOS / Linux
CMake로 프로젝트 설정:
-S .: 현재 디렉터리를 소스코드로 사용-B builddir: 빌드파일은 builddir에 생성-DCMAKE_INSTALL_PREFIX등 옵션으로 ServBay Development Library 경로 지정
기타 옵션은 protobuf 요구에 맞게 추가bashcmake -S . -B builddir \ -DCMAKE_INSTALL_PREFIX=${SERVBAY_COMMON_PATH} \ -DCMAKE_INSTALL_LIBDIR=${SERVBAY_COMMON_LIB_PATH} \ -DCMAKE_INSTALL_INCLUDEDIR=${SERVBAY_COMMON_INCLUDE_PATH} \ -DCMAKE_INSTALL_BINDIR=${SERVBAY_BIN_PATH} \ -DCMAKE_INSTALL_SBINDIR=${SERVBAY_SBIN_PATH} \ -DCMAKE_INSTALL_SYSCONFDIR=${SERVBAY_ETC_PATH} \ -DCMAKE_INSTALL_DATAROOTDIR=${SERVBAY_COMMON_SHARE_PATH} \ -DCMAKE_MACOSX_RPATH=1 \ -DCMAKE_INSTALL_RPATH=${SERVBAY_COMMON_LIB_PATH} \ -DCMAKE_BUILD_WITH_INSTALL_RPATH=TRUE \ -DCMAKE_PREFIX_PATH=${SERVBAY_COMMON_PATH} \ -DBUILD_SHARED_LIBS=ON \ -Dprotobuf_BUILD_LIBPROTOC=ON \ -Dprotobuf_BUILD_SHARED_LIBS=ON \ -Dprotobuf_INSTALL_EXAMPLES=OFF \ -Dprotobuf_BUILD_TESTS=OFF \ -Dprotobuf_ABSL_PROVIDER=package \ -Dprotobuf_JSONCPP_PROVIDER=module \ -DCMAKE_CXX_STANDARD=17빌드 및 설치:
bashcmake --build builddir -j ${CPU_NUMBER} cmake --install builddir
Windows
CMake로 프로젝트 설정(PowerShell 또는 Developer Command Prompt에서):
powershellcmake -S . -B builddir ` -DCMAKE_INSTALL_PREFIX="$env:SERVBAY_COMMON_PATH" ` -DCMAKE_BUILD_TYPE=Release ` -DCMAKE_PREFIX_PATH="$env:SERVBAY_COMMON_PATH" ` -DBUILD_SHARED_LIBS=ON ` -Dprotobuf_BUILD_LIBPROTOC=ON ` -Dprotobuf_BUILD_SHARED_LIBS=ON ` -Dprotobuf_INSTALL_EXAMPLES=OFF ` -Dprotobuf_BUILD_TESTS=OFF ` -Dprotobuf_MSVC_STATIC_RUNTIME=OFF ` -DCMAKE_CXX_STANDARD=17빌드 및 설치:
powershellcmake --build builddir --config Release --parallel $CPU_NUMBER cmake --install builddir --config Release
PHP 모듈 빌드
ServBay에 추가로 PHP 확장(modules) 빌드가 필요한 경우(swoole, redis, mongodb 등), 전용 문서 참고:
PostgreSQL 모듈 빌드
ServBay 내 PostgreSQL 추가 모듈 빌드가 필요한 경우, 아래 문서 참고:
요약
ServBay의 Development Library 및 환경 변수 세팅을 통해, 개발자는 macOS와 Windows에서 원하는 소프트웨어 패키지를 손쉽게 재컴파일/커스터마이즈할 수 있습니다. 이는 프로젝트별 요구나 최신 라이브러리 적용 등 다양한 개발 목적에 유연하게 대응할 수 있도록 해줍니다.
핵심 포인트
- 크로스 플랫폼 지원: ServBay는 macOS와 Windows 모두 컴파일 환경 지원
- 경로 주의: 플랫폼별 설치 경로 상이(macOS:
/Applications/ServBay, Windows:C:\ServBay) - 툴체인 차이: macOS는 Xcode Command Line Tools, Windows는 Visual Studio Build Tools 필요
- 환경 변수 구성: 본인 플랫폼에 맞는 환경 변수 스크립트 선택 필요
유의사항
- 컴파일 전에 패키지 공식 빌드 가이드 꼼꼼히 읽기
- 타겟 플랫폼 특징에 따라 설정/과정 조정 권장
- Windows에서는 CMake 빌드 시스템 권장
- 오픈소스에 따라 플랫폼별 요구사항 및 의존성이 다를 수 있음
이 가이드 문서대로 따라하면 두 플랫폼 모두에서 ServBay 환경 기반의 소프트웨어 패키지 컴파일을 성공적으로 완료할 수 있습니다.
