QT 리눅스 Deploy 방법

QT에서 리눅스 환경에서 패키지를 설치 하기 위해서는 특별히 deploy 기능이 지원 되지 않는다
하지만 별도의 QT 툴을 이용하여 Deploy 를 할 수 있다.

여기서 사용하는 툴은 cqtdeployer 를 사용하여 패키지 하였다.
(참고로 cqtdeployer 는 리눅스와 윈도우 환경 모두를 지원한다.)

해당 github 소스 위치는 https://github.com/QuasarApp/CQtDeployer 이다

cqtdeployer 설치

설치 방법은 소스를 직접 설치 할 수도 있지만 여기서는 Snap Store 를 이용하면 명령어 하나로 간단히 설치 된다

https://snapcraft.io/cqtdeployer

링크 방문후 Install 을 클릭 하면 나오는 다음 명령어 실행 하면 된다 (snap 지원 리눅스에 한하여)

$ sudo snap install cqtdeployer

설치 snap 목록 확인

$ snap list

일부 생략
cqtdeployer        1.6.2323.dd027b2  272    latest/stable    quasarrapp    -

로 확인 해보면 cqtdeployer 를 확인 할 수 있다.

리눅스 패키지

이제 실제로 Qt 로 빌드한 바이너리를 생성 하고 해당 폴더로 이동을 해보자
여기서 예제로 BerEditor 라는 실행 파일이 생성 되면 해당 폴더에서 cqtdeployer -bin BerEditor 만 실행 하면 된다.

$ cd [바이너리 생성 폴더]
$ cqtdeployer -bin BerEditor

만약 실행 중에 설정 관련 경로 에러가 나면 qmake 위치를 지정해 주자.

cqtdeployer 명령어 에러시 qmake 위치 지정

명령 예제 임

cqtdeployer -bin BerEditor -qmake ~/Qt/5.13.2/gcc_64/bin/qmake

여기서 "~/Qt/5.13.2/gcc_64/bin/qmake" 는 사용자 환경에 맞제 지정해 주어야 한다.
위 명령어 실행을 하면 DistributionKit 폴더가 생성 됨

생성후 DistributionKit 폴더에 들어가 보면

cd DistributionKit
ls -l
total 20
-rwxrwxr-x  1 jykim jykim 1640 11월 20 15:46 BerEditor.sh
drwxrwxr-x  2 jykim jykim 4096 11월 20 15:45 bin
drwxrwxr-x  2 jykim jykim 4096 11월 20 15:45 lib
drwxrwxr-x 10 jykim jykim 4096 11월 20 12:02 plugins
drwxrwxr-x  2 jykim jykim 4096 11월 20 15:46 translations

이런게 관련 패키지 목록이 생겨 있다. 여기서 BerEditor.sh 파일을 실행 하면 된다.
실행 시 GLIBC XX 관련 에러가 나타나면 BerEditor.sh 파일을 열어서 아래 내용을 수정 하자

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:"$BASE_DIR"/lib/:"$BASE_DIR"

LD_LIBRARY_PATH 값을 앞으로 조절 해주면 됨
그리고 BerEditor.sh 을 실행 하면 된다.
cqtdeployer 로 명령어를 실행 하여 나온 파일들은 실행 파일에 대한 관련 라이브러리등의 파일을 묶어 주는 역활을 하는 것이다.
이렇게 생성 된 DistributionKit 폴더를 zip 으로 묶어서 배포하면 된다.

마무리

윈도우나 MacOS 경우 패키지 방식이 거의 정해진 방식이 있다.
하지만 리눅스는 아직 패키지 지원이 여러가지라서 일단 이렇게 관련 파일 묶음으로 패키지를 하였다.
사실 리눅스에서 rpm 또는 deb 같은 방식이 있지만 이 방식들은 지원하는 리눅스의 의존성이 있어서
zip으로 만들어서 사용하게 하였다.

여기서 Deploy 실행은 우분투 20 대 버전 64비트 모드에서 테스트 하였다.