Qt/C++ - 025-сабақ. Qmake утилитасымен құрастыру үшін жоба файлдарын жасау

sources, headers, qt, config, libs, qt5, qmake

Файлдар жобасында қолданбаны, кітапхананы немесе плагинді құру үшін qmake талап ететін барлық ақпарат бар. Негізінде, сіз жобадағы ресурстарды көрсету үшін мәлімдемелер қатарын пайдаланасыз, бірақ қарапайым бағдарламалау құрылымдарын қолдау әртүрлі платформалар мен орталар үшін әртүрлі құрастыру процестерін сипаттауға мүмкіндік береді.

Жоба файлының элементтері

qmake пайдаланатын жоба файл пішімін қарапайым және өте күрделі жүйелерді қолдау үшін пайдалануға болады. Қарапайым файл жобасы жобадағы бастапқы және тақырып файлдарын анықтайтын айнымалы мәндерді жариялайтын қарапайым декларативті стильді пайдаланады. Күрделі жобалар құрастыру процесін басқару үшін ағындық құрылымдарды пайдалана алады.

Айнымалылар

Жоба файлында айнымалылар жолдар тізімін сақтау үшін пайдаланылады. Ең қарапайым жобада бұл айнымалы мәндер qmake қолданбасын пайдалану опцияларын орнату туралы немесе құрастыру процесі кезінде пайдаланылатын файл атаулары мен жолдарын қамтамасыз ету туралы хабарлайды.

qmake әрбір жоба файлында осы айнымалы мәндерді іздейді және Makefile файлына не жазылу керектігін анықтау үшін мазмұн арқылы пайдаланылады. Мысалы, HEADERS және SOURCES мәндер тізімі айнымалылар кейбір каталогтардағы qmake және тақырып файлдарын хабардар ету үшін пайдаланылады.

Айнымалы мәндерді уақытша мәндер тізімдерін сақтау үшін іштей пайдалануға болады, ал мәндердің бар тізімдерін жаңа мәндермен қайта жазуға немесе кеңейтуге болады.

Айнымалыға мәндер тізімін тағайындау:

HEADERS = mainwindow.h paintwidget.h

Айнымалы мәндердің тізімі келесідей кеңейтіледі:

SOURCES = main.cpp mainwindow.cpp \
          paintwidget.cpp
CONFIG += console

Ескертпе: Мәндердің бірінші декларациясы HEADERS айнымалысымен бір жолда пайда болатын мәндерді ғана қамтиды. Екінші мәлімдеме SOURCES мәндеріндегідей мәндерді бөледі. кері қиғаш сызықпен айнымалы («\»).

CONFIG айнымалысы Makefile файлын жасау кезінде qmake пайдаланатын басқа арнайы айнымалы болып табылады.

Айнымалылар тізімі

Төменде ең жиі қолданылатын айнымалылар тізімі және олардың мазмұнының сипаттамасы берілген.

• CONFIG - жобаның негізгі параметрлері
• DESTDIR - екілік немесе орындалатын файл орналастырылатын каталог
• FORMS - пайдаланушы интерфейсін жүзеге асыратын UI файлдарының тізімі
• HEADERS - тақырып файл атауларының тізімі (.h) және олардың жолдары
• QT - жобада қолданылатын Qt модульдерінің тізімі
• РЕСУРСТАР - қорытынды жобаға енгізілген ресурс файлдарының (.qrc) тізімі.
• SOURCES - жобаны құру кезінде пайдаланылатын бастапқы код файлдарының тізімі.
• ҮЛГІЛЕР - жобада қолданылатын үлгі. Компиляциядан, қолданбадан, кітапханадан немесе плагиннен кейін жоба қандай болатынын анықтайды.

Айнымалылардың мазмұнын басқа айнымалылардың атауының алдына екі $ белгісін қою арқылы басқа айнымалыларға тағайындауға болады.

Бос орындар

Әдетте, бос орындар айнымалы мәндерді бөледі. Атауында бос орын бар айнымалы мәнді көрсету үшін айнымалыны жақшаға алу керек:

DEST = "Program Files"

Жақшаға алынған мәтін айнымалылар тізіміндегі бір элемент ретінде есептеледі. Ұқсас тәсіл басқа жағдайларда да қолданылады. Мысалы, бос орындар бар файлдарға жолды көрсеткенде:

win32:INCLUDEPATH += "C:/mylibs/extra headers"
unix:INCLUDEPATH += "/home/user/extra headers"

Пікірлер

Сіз әдетте жоба файлдарына түсініктеме қосасыз. Пікірлер # белгісінен басталып, бір жолдың соңына дейін жалғасады.

# Comments usually start at the beginning of a line, but they
# can also follow other content on the same line.

Кірістірілген функциялар және ағынды басқару

qmake айнымалылардың мазмұнын қосу үшін бірнеше кірістірілген функцияларды қамтамасыз етеді. Қарапайым жобаларда жиі қолданылатын функция файл атауын аргумент ретінде қабылдайтын include(), функциясы болып табылады. Файлдың мазмұны жобаға қосу функциясы қолданылған жерде қосылады. Қосу функциясы әдетте басқа файл жобаларын қосу үшін пайдаланылады.

include(other.pro)

Шартты құрылымдарды қолдау бағдарламалау тіліндегі мәлімдемелер сияқты әрекет ететін қол жетімді аумақтарды жасайды:

win32 {
    SOURCES += paintwidget\_win.cpp
}

Жақша ішіндегі тапсырма, егер ол ақиқат болса, орындалады. Бұл жағдайда win32 CONFIG опциясында орнатылуы керек. Бұл Windows жүйесінде автоматты түрде орын алады. Ашылатын жақша шарт сияқты бір жолда пайда болуы керек.

Айнымалылардағы күрделірек операциялар әдетте find(), бірегей(), count() сияқты кіріктірілген функциялармен қамтамасыз етілетін циклдарды қажет етеді. Бұл функциялар және басқа да көптеген функциялар жолды және жолды өңдеуді қамтамасыз етеді. сыртқы құралдарды енгізу және шақыру.

Үлгі жобасы

ҮЛГІК айнымалысы құрылатын жобаның түрін жариялау үшін пайдаланылады. Егер жоба файлында жарияланбаса, qmake жобаны қолданба ретінде құрастырады және Makefile немесе баламасын жасайды.

Төменде qmake құру үшін қолжетімді жоба түрлері және олардың сипаттамалары берілген.

• қолданба (әдепкі) - Makefile қолданбаға енгізілген
• lib - Makefile кітапханаға салынған
• aux - Makefile ештеңе істемейді. Компилятор қажет болмаған кезде пайдаланылады, бірақ мақсатты жасау қажет, мысалы, жоба түсіндірілетін тілде жазылған болса.
• ішкі каталогтар - Makefile SUBDIRS айнымалысы арқылы көрсетілген ішкі каталогтарға арналған ережелерді қамтиды. Әрбір ішкі каталогта өзінің жеке жоба файлы болуы керек.
• vcapp - қолданбаға құрастыруға арналған Visual Studio Project файлы
• vclib - кітапханаға құрастыру үшін Visual Srudio Project файлы
• vcsubdirs - ішкі каталогтарда жобаны құруға арналған Visual Studio Project файлы

Ішкі каталогтар пайдаланылған кезде, qmake әрбір ішкі каталог үшін Makefile жасайды, ол тапқан кез келген жоба файлдарын орындайды және жаңадан жасалған Makefile файлында make іске қосады. SUBDIRS айнымалысы тізімді қамту үшін пайдаланылады. жұмыс орындалатын барлық ішкі каталогтардың.

Негізгі конфигурация

CONFIG айнымалысы жобада орындалатын опциялар мен функцияларды анықтайды.

Жобаны жөндеу және шығару режимінде немесе екеуінде де салуға болады. Түзету және шығару бір уақытта көрсетілсе, соңғысы күшіне енеді. debug_and_release көрсетілсе, жобаның екі нұсқасы да құрастырылады. qmake арқылы жасалған Makefile екі нұсқаны құрайтын ережені қамтиды. Мұны келесі жолмен жасауға болады.

make all

Добавление **build\_all**в переменную **CONFIG** создаёт правило по умолчанию, когда собирается проект.

Ескертпе CONFIG айнымалысы жобаны құру үшін белгілі бір опциялар пайдаланылса немесе пайдаланылмаса, құрастыру шарттары да болуы мүмкін.

CONFIG(opengl) {
    message(Building with OpenGL support.)
} else {
    message(OpenGL support is not available.)
}

Бұл жағдайда жөндеу және шығару құрастырулары үшін әртүрлі конфигурациялар қосылады.

Ескертпе Бұл опциялардың кейбірі құрастыру платформасына сәйкес келсе ғана күшіне енеді.

• qt - Жоба Qt қолданбасы болып табылады және Qt кітапханасымен байланыстырылуы керек. Қолданбаны құру үшін қажет Qt модульдерін қосуды басқару үшін QT айнымалы мәнін пайдалану керек. Бұл мән әдепкі бойынша қосылады, бірақ оны Qt емес жобада qmake арқылы жоюға болады.
• x11 - жоба x11 қолданбасы немесе кітапханасы. Егер мақсат Qt болса, бұл мән қажет емес.

Қолданба үлгілері мен кітапханалар сізге құрастыру процесі үшін көбірек мамандандырылған опцияларды ұсынады. Мысалы, қолданбаңыз Qt кітапханасын пайдаланса және сіз отладка режимінде құрастырғыңыз келсе, жобаңызда келесі жол болуы керек:

CONFIG += qt debug

Ескертпе Сіз "=" емес, "+=" пайдалануыңыз керек немесе qmake Qt параметрлерін пайдалануды қоспайды.

Qt кітапханаларын жариялау

CONFIG айнымалысы qt мәнін қамтыса, Qt қолданбалары үшін qmake қосылады. Бұл қолданбада қандай Qt модульдері қолданылатынын анықтауға мүмкіндік береді. Мұның артықшылығы QT айнымалысы тек қажетті кітапханалар мен модульдерді жариялау үшін пайдаланылуы мүмкін. Мысалы, біз келесідей XML және желі модульдерін қоса аламыз:

QT += network xml

Ескертпе QT әдепкі бойынша core және gui модульдерін, сондай-ақ XML және желілік модульдерді қамтиды. Модуль айнымалысының келесі түрі тағайындауға core және gui кірмейді және құрастыру қателеріне әкеледі.

QT = network xml # This will omit the core and gui modules.

Егер жобаны gui, модулінсіз құрастырғыңыз келсе, оны келесі "-=" операторымен алып тастауыңыз керек.

QT -= gui # Only the core module is used.

Параметрлер

qmake .prf файлдарында көрсетілетін кеңейтілген теңшеу функцияларына орнатылуы мүмкін. Бұл кеңейтілген мүмкіндіктер құрастыру процесі кезінде жиі реттелетін құралдарға қолдау көрсетеді. Құрастыру процесіне функцияларды қосу үшін функция атауын CONFIG. айнымалысына қосыңыз

Мысалы, qmake D-Bus және ogg кітапханалары сияқты pkg-config қолдайтын сыртқы кітапханалармен құрастыру үшін конфигурациялануы мүмкін.

CONFIG += link\_pkgconfig
PKGCONFIG += ogg dbus-1

Басқа кітапханаларды жариялау

Егер жобаңызда Qt модульдерінен басқа басқа кітапханалар пайдаланылса, оларды жоба файлында көрсету керек.

qmake кітапханаларды іздейтін жолдар LIBS айнымалысында көрсетілген. Кітапхана жолын Unix-стиль арқылы көрсетуге болады.

LIBS += -L/usr/local/lib -lmath

Тақырып файлдары бар жолдарды INCLUDEPATH айнымалысы арқылы ұқсас жолмен көрсетуге болады.

INCLUDEPATH = c:/msdev/include d:/stl/include