CMake Konfiguracija izgradnje

Da biste specificirali postavke izgradnje za odabrani komplet, idite na Projects > Build Settings.

Konfiguriranje CMake projekata srednje i velike veličine u Qt Creator može biti izazov zbog broja varijabli koje morate proslijediti CMakeu kako biste ispravno konfigurirali projekt. Kako bi se to olakšalo, Qt Creator za vas stvara početnu konfiguraciju na temelju postavki kompleta i prikazuje je u Initial Configuration u Build Settings projektu. Ili možete koristiti CMake predloške za konfiguriranje CMakea.

Polje Configure prikazuje efektivni poziv CMakea koji Qt Creator konstruira koristeći vrijednosti polja Build directory i Build type.

Možete navesti dodatne CMake opcije, kao što su --find-debug, --trace-expand ili --warn-uninitialized, u polju Additional CMake options. Za više informacija o opcijama odaberite poveznicu u nazivu polja ili pogledajte CMake: cmake(1).

Odaberite Kit Configuration za uređivanje CMake postavki za odabrani build i run kit projekta.

Možete koristiti CMake preset datoteke za definiranje zajedničkih opcija za konfiguraciju, izgradnju i testiranje te ih dijeliti s drugima.

Početna konfiguracija

Initial Configuration popisuje varijable koje Qt Creator koristi za konfiguriranje CMake projekta prvi put. Pokazuje zadane vrijednosti koje dolaze iz CMake konfiguracije kita kurzivom. Qt Creator sprema početni popis varijabli konfiguracije u datoteku CMakeLists.txt.user smještenu u direktoriju .qtcreator unutar izvornog direktorija projekta.

Trenutna konfiguracija

Current Configuration popisuje CMake varijable u JSON izvozu cmake-file-api u direktoriju .cmake/api/v1/reply. Prikazuje varijable iz početne konfiguracije kurzivom, a neusklađene vrijednosti crvenom bojom.

Nakon odabira gumba Run CMake, možete pregledati i promijeniti stvarne vrijednosti varijabli koje Qt Creator prosljeđuje CMakeu. Stlpnik Key navodi nazive varijabli, a stlpnik Value navodi njihove trenutačne vrijednosti. Za više informacija o varijablama odaberite Help u kontekstnom izborniku ili pogledajte CMake: cmake-variables(7). Za više informacija o varijablama specifičnim za Qt pogledajte Referencu varijabli CMakea.

Podrška za višekonfiguracijske generatore

Qt Creator podržava generatore za više konfiguracija, kao što su Xcode, Visual Studio i Ninja Multi-Config. To znači da CMake trebate konfigurirati samo jednom, imati samo jednu mapu za izgradnju i brže se prebacivati između vrsta izgradnje.

Međutim, to znači da Qt Creator više ne može jednostavno analizirati prvi CMake file-api JSON izvoz. Stoga vrijednost polja Build type mora odgovarati vrijednosti varijable CMAKE_BUILD_TYPE kako bi generator jedinstvene konfiguracije (Ninja, Makefile) mogao odrediti koji generator koristiti.

Pri razvoju s Qt 6 za iOS podržan je samo generator za Xcode.

Mijenjanje vrijednosti varijabli

Stvarne vrijednosti varijabli koje se prosljeđuju CMakeu možete pregledati i urediti u Initial Configuration ili Current Configuration.

Možete odabrati nekoliko varijabli i primijeniti radnju na njih. Za poništavanje odabira kliknite bilo gdje u prikazu.

Za masovnu izmjenu vrijednosti varijabli odaberite Batch Edit.

Za izgradnju pomoću trenutačne konfiguracije odaberite Run CMake. Tijekom izgradnje tekst gumba mijenja se u Stop CMake. Odaberite gumb za otkazivanje trenutačne izgradnje.

Dodavanje varijabli

Za dodavanje varijabli odaberite Add, a zatim odaberite vrstu varijable koju dodajete: Boolean, String, Directory ili File.

Da biste promijenili tip odabrane varijable, kliknite desnom tipkom miša na naziv varijable u stupcu Key i zatim u kontekstnom izborniku odaberite Force to bool, Force to file, Force to directory ili Force to string.

Da biste kopirali naziv ili vrijednost odabrane varijable u međuspremnik, odaberite Copy u kontekstnom izborniku.

Promjena vrijednosti varijabli

Da biste promijenili vrijednost varijable, dvaput kliknite na nju ili je odaberite, a zatim odaberite Edit. Ako se početna, trenutačna i konfiguracija kompleta ne usklade, odaberite Apply Kit Value ili Apply Initial Configuration Value u kontekstnom izborniku u Initial Configuration ili Current Configuration.

Za poništavanje svih promjena koje ste napravili odaberite Reset.

Promijenjene vrijednosti varijabli prosljeđuju se putem -D<option>=<value> CMakeu, koji pohranjuje opcije u datoteku CMakeCache.txt. To znači da ako uklonite direktorij za izgradnju, sve prilagođene varijable koje nisu dio početne CMake konfiguracije također se uklanjaju.

Da biste ponovno konfigurirali projekt koristeći izmijenjene vrijednosti varijabli, idite na Build i odaberite Clear CMake Configuration, što uklanja datoteku CMakeCache.txt. To vam omogućuje potpuno ponovno izgradnju.

Uklanjanje varijabli

Da biste uklonili odabrane varijable, odaberite Unset. Da biste poništili uklanjanje, odaberite Set.

Prikaz naprednih varijabli

Za pregled svih varijabli odaberite Advanced.

Za prikaz svih varijabli prema zadanim postavkama idite na Postavke > CMake > General i odaberite Show advanced options by default.

Ponovna konfiguracija s početnim varijablama

Da biste vratili CMake varijable na početne vrijednosti, odaberite Re-configure with Initial Variables u Initial Configuration. Qt Creator briše trenutnu CMake konfiguraciju i pokreće CMake. Početne vrijednosti konfiguracije pohranjene su u datoteci CMakeLists.txt.user, pa brisanje direktorija za izgradnju ne briše početnu konfiguraciju.

Da biste bili upitani prije nego što Qt Creator poništi promjene, idite na Preferences > CMake > General i odaberite Ask before re-configuring with initial parameters.

Pregledavanje CMake izlaza

Izlazak iz CMakea prikazuje se pored kartica Build Settings, Deploy Settings i Run Settings u načinu Projects.

Za čišćenje izlaza iz CMakea odaberite (Clear).

Možete unijeti niz u polje Filter kako biste filtrirali izlaz. Za određivanje opcija filtriranja odaberite . Izlaz možete filtrirati pomoću regularnih izraza ili osjetljivosti na velika i mala slova. Odaberite Show Non-matching Lines kako biste sakrili retke koji odgovaraju filtru. Također možete postaviti broj prethodnih i sljedećih redaka za prikaz.

Odaberite Ctrl+F za pretraživanje niza u izlazu.

Za povećanje ili smanjenje veličine teksta izlaza odaberite (Zoom In) ili Ctrl++ ili (Zoom Out) ili Ctrl+-.

Za sakrivanje izlaza odaberite (Hide Right Sidebar) ili Alt+Shift+0.

Okolišna varijabla CLICOLOR_FORCE

Qt Creator Postavlja varijablu okruženja CLICOLOR_FORCE na 1 kako bi prikazala ANSI-boje izlaz za CMake. To može utjecati na izlaz procesa.

Ako izlaz izgleda netočno ili se razlikuje od ranijih verzija Qt Creator, pokušajte postaviti CLICOLOR_FORCE na 0 u Use Build Environment.

Korištenje spojnih točaka na Windowsu

Za prevladavanje problema s dugim putanjama na Windowsu, stvorite i koristite točke spajanja za direktorije izvora i izgradnje. Na točki spajanja, direktorij služi kao alias za drugi direktorij na računalu.

Da biste koristili junction points za CMake configure, build i install operacije, idite na Preferences > CMake > General i odaberite Use junctions for CMake configuration and build operations.

Qt Creator pohranjuje točke spajanja u C:\ProgramData\QtCreator\Links. Da biste koristili drugu putanju, postavite je kao vrijednost varijable okruženja QTC_CMAKE_JUNCTIONS_DIR.

Postavite varijablu okruženja QTC_CMAKE_JUNCTIONS_HASH_LENGTH kako biste skratili duljinu ključa MD5 haša s zadane vrijednosti od 32.

CMake koraci izgradnje

Qt Creator izgrađuje CMake projekte pokretanjem cmake . --build, koji zatim pokreće CMake generator naveden u konfiguraciji projekta: make, mingw32-make, nmake ili ninja, na primjer. CMake generator proizvodi projektne datoteke za Qt Creator. Podržani su i generator za više konfiguracija.

Možete dodati argumente za prosljeđivanje CMakeu i generatoru te ciljeve za naredbu izgradnje u Build Steps.

Da biste instalirali aplikaciju u privremeni direktorij pri križnom kompajliranju, odaberite Stage for installation i navedite putanju do direktorija u polju Staging directory. Alat za pakiranje konstruira paket iz sadržaja direktorija.

Korištenje Ninje kao CMake generatora

Da biste koristili Ninjau s CMakeom, morate ga instalirati i odabrati kao CMake generator u alatu za izgradnju i pokretanje:

1. Instalirajte Ninja.
2. Dodajte putanju do izvršne datoteke Ninja u vrijednost sustavne varijable PATH.
3. Idite na Projects > Build Settings i odaberite Kit Configuration.

   

4. Odaberite Change pokraj polja CMake generator kako biste otvorili dijalog CMake Generator.

   

5. U Generator odaberite Ninja.
6. Odaberite OK da spremite promjene i zatvorite dijalog.
7. Odaberite Close da zatvorite dijalog Kit CMake Configuration i vratite se u Build Settings.

Korištenje CMakea s upravljačima paketa

Za automatsko postavljanje upravitelja paketa Conan ili vcpkg za upotrebu s CMakeom:

1. Stvorite CMake skriptnu datoteku koja instalira ovisnosti iz datoteke conanfile.txt, conanfile.py ili vcpkg.json u izvornoj mapi projekta.
2. Postavite putanju do skripte kao vrijednost varijable CMAKE_PROJECT_INCLUDE_BEFORE.
3. Idite na Preferences > CMake > General i odaberite Package manager auto setup.

Okolišna varijabla QTC_RUN

Qt Creator Postavlja varijablu okruženja QTC_RUN na 1 pri izvođenju procesa cmake.

Ovo omogućuje CMake kodu da otkrije je li se izvršava iz Qt Creator.

CMake koraci čišćenja

Prilikom izgradnje s CMakeom možete dodati argumente za prosljeđivanje CMakeu i generatoru te ciljeve za naredbu clean u Clean Steps u.

Greške i upozorenja izgradnje se analiziraju i prikazuju u Issues.