타사 라이브러리

Qt에서 타사 라이브러리를 사용하는 것은 간단한 과정입니다. 고양이의 야옹 소리 오디오 샘플을 받아 영어 단어로 번역하는 크로스 플랫폼 라이브러리를 알고 있다고 가정해 보겠습니다. 이 라이브러리의 이름은 CatWhisperer 이며, 라이브러리의 일부로 제공하는 여러 파일이 있습니다. 프로젝트( MyQtApp)는 이러한 파일을 3rdparty 이라는 폴더에 저장합니다:

• MyQtApp/
  • MyQtApp.pro
  • src/
    • main.cpp
  • 3rdparty/
    • CatWhisperer
      • include/
        • CatWhisperer.h
      • lib/
        • libCatWhisperer.so
        • CatWhisperer.lib
      • bin/
        • CatWhisperer.dll

MyQtApp, qmake 에서 CatWhisperer 라이브러리를 사용하려면 CatWhisperer 라이브러리의 위치와 이름이 필요합니다. 선택적으로 사용할 수도 있습니다:

• CatWhisperer 소스 코드의 위치를 제공하면 각 파일을 코드에 포함할 때 각 파일의 전체 경로를 입력할 필요가 없습니다.
• MyQtApp 실행 파일이 생성될 대상을 선택합니다.

위의 정보는 .pro 파일에 제공되므로 qmake 에서 이를 파싱하여 메이크파일을 생성할 수 있습니다. 메이크파일에는 컴파일러와 링커가 실행 파일, 다른 라이브러리 파일 등 출력을 생성하는 데 필요한 모든 정보가 포함되어 있습니다. 다음 섹션에서는 qmake 에서 이 정보를 제공하는 구문에 대해 설명합니다.

소스 코드

작성하려면

#include <CatWhisperer.h>

대신

#include <3rdparty/CatWhisperer/include/CatWhisperer.h>

대신 CatWhisperer include 디렉토리의 경로를 INCLUDEPATH 변수를 사용하여 제공할 수 있습니다:

INCLUDEPATH += 3rdparty/CatWhisperer/include

라이브러리 파일

qmake 에 CatWhisperer 라이브러리 파일을 찾을 위치를 알려주려면 LIBS 변수를 사용합니다:

LIBS += -L"3rdparty/CatWhisperer/lib" -lCatWhisperer

표현식의 첫 부분은 링커가 라이브러리 파일을 어느 디렉터리에서 찾아야 하는지 알려줍니다. 큰따옴표는 경로에 공백이 포함된 경우에만 필요하므로 이 예제에서는 생략할 수 있습니다.

두 번째 부분은 링커에게 어떤 라이브러리를 기준으로 링크할지 알려줍니다. UNIX 플랫폼과 Windows용 라이브러리 파일은 각각 libCatWhisperer.so 및 CatWhisperer.lib 입니다. .lib 확장자나 lib 접두사(UNIX 플랫폼의 경우)를 지정할 필요는 없습니다.

대상 디렉터리

기본적으로 qmake 은 .pro 파일과 동일한 디렉터리에 실행 파일을 만듭니다. DESTDIR 변수를 사용하여 자체 디렉터리를 선택할 수 있습니다:

DESTDIR = bin

끝입니다! 이제 프로젝트에서 CatWhisperer 라이브러리를 사용할 수 있습니다. 최종 .pro 파일은 다음과 같습니다:

TARGET = MyQtApp

TEMPLATE = app

INCLUDEPATH += 3rdparty/CatWhisperer/include

SOURCES += src/main.cpp

LIBS += -L"3rdparty/CatWhisperer/lib" -lCatWhisperer