Qt 빌드하기 (Windows, MSVC2019, Static Library)

목차

 

0. 들어가기

Qt를 설치하면 기본적인 라이브러리가 설치되지만 static library가 필요한 경우가 있고 다른 버전의 라이브러리가 필요한 경우가 있다. 이럴 때는 누군가가 빌드해 놓은 것을 가져다 쓰거나 직접 빌드해야 하는데, 직접 빌드해보는 것도 나름 재미가 있다. 대신 시행착오와 빌드에 걸리는 시간에 대한 인내심이 필요하다.

 

1. Qt 소스코드 받기

소스코드를 받는 방법은 qt 사이트에서 zip 형식으로 받을 수 있고 git으로도 받을 수도 있다.

 

1) git에서 받기

git에서 받는 방법의 qt 사이트를 참고하면 된다.

https://wiki.qt.io/Building_Qt_5_from_Git#Getting_the_source_code

Building Qt 5 from Git - Qt Wiki

시간이 좀 걸리고 전체 사이즈가 크다는 점은 있지만 해볼 만하며 단, 제대로 받아지지 않으면 빌드에 실패할 수도 있다는 점을 참고해야 한다.

 

또한, clone을 하기 전에 해야 하는 작업이 있다. 파일 경로가 길어 소스코드를 받다가 에러가 발생한다.

error: unable to create file ...파일경로 (Filename too long)

 

cmd를 관리자 권한으로 열어 아래와 같이 입력한다. 관리자 권한이 없으면 에러가 발생한다.

git config --system core.longpaths true

 

성공

 

에러

 

준비가 되었으니 git으로 소스코드를 받는다.

git clone git://code.qt.io/qt/qt5.git qt5_src

 

git checkout 5.12.12

 

perl init-repository

 

여기서 잠시 시간이 걸린다. 받은 파일의 전체 크기를 보면 git 관련 파일 포함 6~7GB 정도 된다.

그리고 다시 한번, update를 한다.

 

git submodule update --init --recursive

 

정리하자면, 아래와 같다.

git clone git://code.qt.io/qt/qt5.git qt5_src
cd qt5_src/
perl init-repository
git checkout 5.12.12
git submodule update --init --recursive

 

 

2) 사이트에서 zip 파일로 받기

일반적으로 사용하는 방법이다. 아래와 같이 소스코드 zip 파일을 받을 수 있다.

https://download.qt.io/archive/qt/5.12/5.12.12/single/qt-everywhere-src-5.12.12.zip

 

2. 빌드하기

빌드를 위해서는 VS 2019 환경이 적용된 Command Prompt를 사용해야 한다. Visual Studio의 설치 위치에 따라 다르겠지만, 시작 화면에서 2019로 검색하면 찾을 수 있다. 이 방법으로 찾을 수 없다면, Visual Studio가 설치된 곳의 "VC\Auxiliary\Build"에서 찾을 수 있다. 나의 경우 일반 Command Prompt를 실행하여 아래와 같이 실행하면 된다.

 

"E:\_000\Microsoft Visual Studio\2019\Professional\VC\Auxiliary\Build\vcvars32.bat"

 

 

 

빌드에 앞서 configure를 해야 하는데 옵션은 configure -?로 확인 가능하다.

 

내가 선택한 옵션은 이렇다.

configure -static -debug-and-release -opensource -platform win32-msvc -nomake examples -nomake tests -prefix E:\_000\Qt\Qt5.12.12\5.12.12\msvc2019-static

 

-static : 별도의 설치 프로그램을 사용하기 싫어 static library로 빌드

-debug-and-release : debug / release 2가지 버전으로 빌드

-opensource : opensource 버전

-platform win32-msvc :  Visual Studio toolchains 사용 (https://doc.qt.io/qt-5/supported-platforms.html)

-nomake examples : examples 제외

-nomake tests : tests 제외

-prefix E:\_000\Qt\Qt5.12.12\5.12.12\msvc2015-static : 설치는 여기에.

 

그럼 해볼까.

 

에잇. CMake 버전이 낮다고 한다. 뭘 깔면서 같이 설치된 거 같은데 어떻게 제거를 해야 할지 몰라 그냥 받아서 설치했다.

https://github.com/Kitware/CMake/releases/download/v3.23.1/cmake-3.23.1-windows-x86_64.msi

 

버전을 올리고 다시 도전!!

 

당연히 Command Windows를 다시 시작해야 하고 version이 올라가지 않았다면 Path를 다시 잡아 준다. 어쨌든 예전 버전이 살아 있으니 조치를 취해야겠다.

 

 

configure 다시 실행!

 

configure가 완료되었다면 빌드를 한다. 빌드는 nmake를 사용해도 되지만 시간이 너무 걸린다. jom을 사용하면 병렬로 처리할 수 있어 빌드 시간을 줄일 수 있다. jom을 받아 Qt 소스코드 위치에 복사한다.

 

http://download.qt.io/official_releases/jom/jom.zip

 

 

jom을 실행하여 빌드를 하자. 시간이 좀 걸린다. PC의 성능에 따라 다르겠지만, 일반적으로 드라마 2편이나 영화 1편을 보고 오면 된다.

 

드디어 빌드가 완료되었다.

 

jom install을 실행하여 설치하자.

jom install

 

아래와 같이 설치가 완료되면 설치하고자 했던 디렉터리에 추가된 것을 확인할 수 있다.

jom install 실행 완료

 

원하던 곳에 설치 완료

 

 

3. 예제 돌려보기

길었던 설치가 완료되었다. 다음에는 설치한 라이브러리로 예제를 돌려보자. 그런데 지쳤다. 다음 포스트에서 하자.

 

2022.05.01 - [일하기/Qt] - QT Kit 추가

QT Kit 추가

 

2022.05.01 - [일하기/Qt] - MSVC2019 Static Library로 Qt 예제 빌드 해보기

MSVC2019 Static Library로 Qt 예제 빌드 해보기