macOS에서 pgModeler 최신 버전 1.2.0-beta 설치 가이드

by흰담비팸 • • 2 min read
0

macOS에서 pgModeler 최신 버전 1.2.0-beta 설치 가이드




pgModeler는 PostgreSQL 데이터베이스 모델링 도구로, 데이터베이스 설계와 관리 작업을 효율적으로 수행할 수 있는 강력한 도구입니다. 이 문서에서는 macOS에서 최신 버전인 pgModeler 1.2.0-beta를 소스 코드로 설치하는 과정을 상세히 설명합니다. 설치 과정에서 발생할 수 있는 문제와 해결 방법도 함께 다룹니다.

1. 설치 전 준비 사항

pgModeler를 설치하기 위해 필요한 필수 도구와 라이브러리를 먼저 준비해야 합니다.

1.1 Homebrew 설치

Homebrew는 macOS에서 소프트웨어를 쉽게 설치하고 관리할 수 있도록 도와줍니다. Homebrew가 설치되어 있지 않다면, 터미널에서 다음 명령어를 실행하여 설치합니다:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

설치 완료 후 업데이트:

brew update

1.2 필수 패키지 설치

pgModeler를 빌드하려면 다음 라이브러리가 필요합니다. Homebrew를 사용해 설치합니다:

brew install qt libxml2 libpq

주의: 최신 버전의 pgModeler는 Qt 6.4.0 이상을 필요로 합니다. 기존에 설치된 Qt 5가 있다면 제거 후 Qt 6를 설치해야 합니다:

brew uninstall qt@5
brew install qt

2. pgModeler 소스 코드 다운로드

pgModeler 소스 코드를 GitHub에서 다운로드합니다.

2.1 Git 설치

Git이 설치되어 있지 않다면 다음 명령어로 설치합니다:

brew install git

2.2 소스 코드 다운로드

pgModeler 소스 코드를 클론합니다:

git clone https://github.com/pgmodeler/pgmodeler.git
cd pgmodeler

최신 버전인 1.2.0-beta로 체크아웃:

git checkout tags/v1.2.0-beta

3. 환경 변수 설정

pgModeler를 빌드하려면 Qt와 PostgreSQL 관련 라이브러리 경로를 환경 변수에 설정해야 합니다.

3.1 환경 변수 파일 열기

사용 중인 셸에 따라 파일을 엽니다:

  • zsh (기본 macOS 셸): 
    nano ~/.zshrc
  • bash: 
    nano ~/.bashrc

3.2 환경 변수 추가

파일 맨 아래에 다음 내용을 추가합니다:

export PATH="/opt/homebrew/opt/qt/bin:$PATH"
export LDFLAGS="-L/opt/homebrew/opt/libpq/lib"
export CPPFLAGS="-I/opt/homebrew/opt/libpq/include"
export PKG_CONFIG_PATH="/opt/homebrew/opt/libpq/lib/pkgconfig"

변경 사항을 저장한 후 적용:

source ~/.zshrc   # zsh 사용 시
source ~/.bashrc  # bash 사용 시

4. pgModeler 설정 파일 수정

pgModeler의 pgmodeler.pri 파일에서 PostgreSQL 및 libxml2 경로를 명시적으로 설정합니다.

4.1 파일 열기

pgmodeler.pri 파일을 열어 수정합니다:

nano pgmodeler.pri

4.2 경로 설정 추가

파일에서 다음 섹션을 찾아 수정합니다:

macx {
  PGSQL_LIB = /opt/homebrew/opt/libpq/lib/libpq.dylib
  PGSQL_INC = /opt/homebrew/opt/libpq/include
  XML_INC = /opt/homebrew/opt/libxml2/include/libxml2
  XML_LIB = /opt/homebrew/opt/libxml2/lib/libxml2.dylib
  INCLUDEPATH += $$PGSQL_INC $$XML_INC
}

수정 후 저장하고 닫습니다:

  • nano 사용 시: Ctrl + O → Enter → Ctrl + X

5. pgModeler 빌드

이제 pgModeler를 빌드합니다.

5.1 빌드 명령어 실행

qmake -r pgmodeler.pro
make
make install
  • qmake: Qt 프로젝트를 컴파일할 준비를 합니다.
  • make: 소스 코드를 빌드합니다.
  • make install: pgModeler를 설치합니다.

빌드가 완료되면 실행 파일이 생성됩니다.

6. pgModeler 실행

설치가 완료되면 다음 명령어로 pgModeler를 실행합니다:

./pgmodeler

7. 문제 해결

설치 과정에서 발생할 수 있는 일반적인 문제와 해결 방법을 정리했습니다.

7.1 Qt 버전 문제

Project ERROR: Unsupported Qt version detected 오류가 발생하면 Qt 6가 올바르게 설치되지 않았을 가능성이 높습니다. Qt 6를 다시 설치하고 환경 변수를 재설정합니다:

brew reinstall qt
export PATH="/opt/homebrew/opt/qt/bin:$PATH"
source ~/.zshrc

7.2 라이브러리 경로 문제

빌드 중 PostgreSQL 또는 libxml2 라이브러리를 찾지 못하는 경우, pgmodeler.pri 파일의 경로를 다시 확인하세요:

brew --prefix libpq
brew --prefix libxml2

8. 업데이트 및 관리

pgModeler를 최신 버전으로 유지하려면 다음 명령어를 실행합니다:

cd pgmodeler
git pull
make clean
make
make install

응용프로그램에 pgmodeler가 설치되었는지 확인하시고, 실행하시면 됩니다.

 

9. 마무리

이 가이드를 따라 macOS에서 최신 버전의 pgModeler를 성공적으로 설치하고 사용할 수 있습니다. pgModeler는 PostgreSQL 데이터베이스 설계와 관리를 크게 간소화할 수 있는 도구로, 개발자와 데이터베이스 관리자에게 유용합니다. 문제가 발생하거나 추가적인 설정이 필요하다면 공식 문서나 커뮤니티를 참조하세요.

공식 웹사이트: pgModeler 공식 사이트

4.94 / 169 rates
다음 이전