Alat SDK

Qt Online InstallerQt Creator koristi alat SDK (sdktool) za konfiguriranje CMakea i postavljanje preferencija Kita, kao što su kompajleri, otklanjivači pogrešaka, uređaji i verzije Qt-a. Možete ga koristiti s naredbenog retka, na primjer, za automatsko postavljanje preferencija za Qt i CMake za sve korisnike računala. Za pojedinog korisnika obično je lakše izvršiti promjene u Preferences > Kits.

Da biste koristili SDK Tool, unesite sljedeću naredbu u direktorij Tools\sdktool\bin u direktoriju instalacije Qt-a:

sdktool [OPTION] [OPERATION [OPTIONS]]

Za informacije o opcijama i operacijama koje podržava vaša verzija alata SDK, upišite:

sdktool --help

Tipovi vrijednosti

Operacije dodaju postavke u obliku <KEY> <TYPE>:<VALUE> u konfiguraciju koju stvaraju. Podržane vrijednosti TYPE su:

• bool
• int
• QByteArray
• QString
• QVariantList

Staza do SDK-a

Qt Online Installer i samostalni instalacijski program za Qt Creator instaliraju sdktool. Putanja sdktool iz instalacijskog programa zadano je lokacija s koje Qt Creator iz instalacijskog programa čita informacije koje SDK Tool zapisuje. Da biste usmjerili sdktool na neku drugu instalaciju Qt Creator, postavite --sdkpath ovisno o tome koristite li Qt Online Installer ili izvanmrežni instalacijski program.

• Qt Online Installer: <Qt_Online_Installer>/Tools/sdktool
• Qt Creator samostalni instalacijski program:
  • Na Windowsu i Linuxu: <qtcreator>/share/qtcreator/
  • Na macOSu Qt Creator.app/Contents/Resources/

Opcije

Sljedeća tablica sažima dostupne opcije.

Operacije

Sljedeća tablica sažima dostupne operacije.

Dodavanje sustavne arhitekture (ABI)

addAbiFlavor

sdktool addAbiFlavor --flavor <NAME> --oses <OS>(,<OS>)*

Dodaj ABI varijantu opcije

Sljedeća tablica sažima dostupne opcije.

Opcija	Opis	Obavezno
--flavor <NAME>	Naziv sustavne arhitekture (ABI).
--oses <OS>(,<OS>)*	Operativni sustav na koji se ABI odnosi.

Primjer ABI varijante

Da biste dodali Yocto Poky na Linux, unesite:

./sdktool addAbiFlavor \
--flavor poky \
--oses linux

Dodavanje CMake alata

addCMake

sdktool addCMake --id <ID> --name <NAME> --path <PATH> [<KEY> <TYPE:VALUE>]

Dodavanje CMake opcija

Sljedeća tablica sažima dostupne opcije.

Opcija	Opis	Potrebno
--id <ID>	ID instalacije CMakea. Može biti bilo koji ASCII (7-bitni) niz. Ako u nizu ne navedete broj verzije, registrirani CMake zadržava ID kada ažurirate ovu instalaciju CMakea, te se stoga svi kompleti automatski ažuriraju za korištenje nove verzije.
--name <NAME>	Naziv instalacije CMakea.
--path <PATH>	Staza do CMake izvršne datoteke.
<KEY> <TYPE:VALUE>	Dodatna podešavanja kao parovi ključ-vrijednost.

Za više informacija pogledajte Dodavanje CMake alata.

Primjer CMake konfiguracije

Da biste dodali CMake alat na Windows, unesite:

sdktool addCMake \
--id "my.custom.cmake" \
--name "Custom CMake" \
--path "C:\Program Files\CMake-3.30\bin\cmake.exe"

Dodavanje kompajlera

addTC

sdktool addTC --id <ID> --language <ID> --name <NAME> --path <PATH> --abi <ABI STRING> [OPTIONS]

addTC opcije

Sljedeća tablica sažima dostupne opcije.

Opcija	Opis	Obavezno
--abi <ABI STRING>	ABI prevoditelja u formatu koji ProjectExplorer::Abi::fromString() može analizirati.
--id <ID>	ID alatnog lanca u formatu ToolChainType:some_unique_part, gdje tip alatnog lanca može biti jedan od sljedećih ili nešto drugo što pruža dodatak: ProjectExplorer.ToolChain.Msvc za Microsoft MSVC kompajlere. Ovaj se kompajler automatski otkriva, pa ga ne morate dodavati pomoću alata SDK. ProjectExplorer.ToolChain.Gcc za GCC na Linuxu ili macOS-u. ProjectExplorer.ToolChain.Clang za Clang. ProjectExplorer.ToolChain.LinuxIcc za LinuxICC. ProjectExplorer.ToolChain.Mingw za MinGW. ProjectExplorer.ToolChain.ClangCl za Clang/CL. ProjectExplorer.ToolChain.Custom za prilagođeni toolchain. Qt4ProjectManager.ToolChain.Android za Android. Qnx.QccToolChain za QNX QCC. WebAssembly.ToolChain.Emscripten za Emscripten. Provjerite klase izvedene iz ProjectExplorer::ToolChain radi njihovih ID-ova. some_unique_part može biti bilo što. Qt Creator po zadanom koristi GUID-ove.
--language <ID>	ID ulaznog jezika alatnog lanca: C ili Cxx. Kada registrirate C ili C++ kompajler, pobrinite se da registrirate i odgovarajući C++ ili C kompajler.
--name <NAME>	Naziv toolchaina.
--path <PATH>	Staza do izvršne datoteke kompajlera.
--supportedAbis <ABI STRING>,<ABI STRING>	Popis ABI-ja koje kompajler podržava.
<KEY> <TYPE:VALUE>	Dodatna podešavanja kao parovi ključ-vrijednost.

Za više informacija pogledajte Dodavanje kompajlera.

Primjer kompajlera

Da biste dodali GCC kompajler na Linux, unesite:

./sdktool addTC \
    --id "ProjectExplorer.ToolChain.Gcc:company.product.toolchain.g++" \
    --language Cxx
    --name "GCC (C++, x86_64)" \
    --path /home/code/build/gcc-6.3/usr/bin/g++ \
    --abi x86-linux-generic-elf-64bit \
    --supportedAbis x86-linux-generic-elf-64bit,x86-linux-generic-elf-32bit \
    ADDITIONAL_INTEGER_PARAMETER int:42 \
    ADDITIONAL_STRING_PARAMETER "QString:some string" \

Dodavanje otklanjivača pogrešaka

addDebugger

sdktool addDebugger --id <ID> --name <NAME> [OPTIONS]

opcije addDebugger

Sljedeća tablica sažima dostupne opcije.

Opcija	Opis	Obavezno
--abis <ABI,ABI>	Popis definicija arhitekture sustava odvojenih zarezom.
--binary <PATH>	Staza do izvršne datoteke otklonika. Može biti apsolutna staza, vrijednost auto ili ABI. Pronalazi odgovarajući otklonik za MSVC alatne lance kada Qt Creator ne zna binarnu stazu.
--engine <ENGINE>	Tip pogonskog mehanizma otklanjivača pogrešaka: 1 za GDB 4 za CDB 8 za PDB 256 za LLDB 512 za GDB DAP 1024 za LLDB DAP 4096 za uVision Debugger
--id <ID>	Jedinstveni ID otklanjivača.
--name <NAME>	Naziv otklanjivača pogrešaka.
<KEY> <TYPE:VALUE>	Dodatna podešavanja kao parovi ključ-vrijednost.

Za više informacija pogledajte Dodavanje otklanjivača pogrešaka.

Primjer otklanjivača pogrešaka

Da biste dodali GDB otklanjivač na Linux, unesite:

./sdktool addDebugger \
    --id "company.product.toolchain.gdb" \
    --name "GDB (company, product)" \
    --engine 1 \
    --binary /home/code/build/gdb-7.12/bin/gdb \
    --abis arm-linux-generic-elf-32 \

Dodavanje uređaja

addDev

sdktool addDev --id <ID> --name <NAME> --type <INT> [OPTIONS]

addDev opcije

Sljedeća tablica sažima dostupne opcije. Opcije koje treba koristiti ovise o vrsti uređaja.

Opcija	Opis	Obavezno
--authentication <INT>	Metoda autentifikacije: 0 za sve metode autentifikacije 1 za SSH autentifikaciju pomoću para javnog i privatnog ključa
--b2qHardware <STRING>	Boot to Qt informacije o platformi o hardveru.
--b2qSoftware <STRING>	Boot to Qt informacije o platformi o softveru.
--debugServerKey <STRING>	Ključ za debugiranje poslužitelja.
--dockerClangdExecutable <STRING>	Staza do izvršne datoteke Clangd u Docker spremniku.
--dockerMappedPaths <STRING>	Popis Docker mapa putanja odvojenih točkom-zarezom.
--dockerRepo <STRING>	Repozitorij Docker slike.
--dockerTag <STRING>	Oznaka Docker slike.
--freePorts <STRING>	Slobodni portovi.
--host <STRING>	Naziv domene ili IP adresa uređaja.
--id <ID>	Jedinstveni ID uređaja.
--keyFile <STRING>	Staza do datoteke privatnog ključa korisnika.
--name <NAME>	Naziv uređaja.
--origin <INT>	Je li uređaj automatski otkriven: 0 za ručno dodan uređaj 1 za automatski otkriveni uređaj
--osType <STRING>	Operativni sustav na uređaju: Android.Device.Type BareMetalOsType QdbLinuxOsType DockerDeviceType Ios.Device.Type Ios.Simulator.Type McuSupport.DeviceType Desktop WebAssemblyDeviceType QnxOsType GenericLinuxOsType
--password <STRING>	Lozinka za autentifikaciju lozinkom.
--sshPort <INT>	Broj porta za SSH veze.
--timeout <INT>	Vrijeme isteka za ponovnu upotrebu SSH veze u sekundama.
--type <INT>	Tip uređaja: 0 za hardverski uređaj 1 za emulator, simulator ili virtualni uređaj
--uname <STRING>	Korisničko ime za pristup uređaju.
<KEY> <TYPE:VALUE>	Dodatne postavke kao parovi ključ-vrijednost.

Za više informacija pogledajte : Kako razvijati za uređaje.

Primjer Linux uređaja

Da biste dodali udaljeni Linux uređaj (hardverski uređaj) na Linuxu i koristili SSH ključeve za autentifikaciju na uređaju, unesite:

./sdktool addDev \
    --id " LinuxDevice1" \
    --name "My Remote Linux Device" \
    --type 0 \
    --authentication 1 \
    --freePorts "10000-10100" \
    --host "10.10.10.15" \
    --keyFile "/usr/.ssh/qtc_id" \
    --origin 0 \
    --osType "GenericLinuxOsType" \
    --sshPort 22 \
    --timeout 10 \
    --uname "root"

Dodavanje Qt verzija

addQt

sdktool addQt --id <ID> --name <NAME> --qmake <PATH> --type <TYPE> [OPTIONS]

Dodavanje Qt opcija

Sljedeća tablica sažima dostupne opcije.

Opcija	Opis	Obavezno
--abis <ABI,ABI>	Popis definicija arhitekture sustava odvojenih zarezom.
--id <ID>	ID Qt instalacije. Qt Creator automatski postavlja ID kada otkrije instalirane verzije Qt-a na računalu.
--name <NAME>	Naziv instalacije Qt-a.
--qmake <PATH>	Staza do izvršne datoteke qmake u Qt instalaciji.
--type <TYPE>	Tip Qt verzije: Qt4ProjectManager.QtVersion.Android za Android. Qt4ProjectManager.QtVersion.Desktop za desktop Qt. Qt4ProjectManager.QtVersion.Ios za iOS. Qt4ProjectManager.QtVersion.QNX.QNX za QNX. RemoteLinux.EmbeddedLinuxQt za Embedded Linux. Qt4ProjectManager.QtVersion.WebAssembly za WebAssembly. Niz koji vraća QtVersion::type().
<KEY> <TYPE:VALUE>	Dodatna podešavanja kao parovi ključ-vrijednost.

Za više informacija pogledajte Dodavanje Qt verzija.

Primjer verzije Qt-a

Za dodavanje samostalno izgrađene verzije Qt 6.8 na Linuxu, unesite:

./sdktool addQt \
    --id "company.product.qt" \
    --name "Custom Qt" \
    --qmake /home/code/build/qt-6.8/bin/qmake \
    --type Qt4ProjectManager.QtVersion.Desktop \

Dodavanje kompleta

addKit

sdktool addKit --id <ID> --name <NAME> --devicetype <TYPE> [OPTIONS]

opcije addKit

Sljedeća tablica sažima dostupne opcije.

Opcija	Opis	Obavezno
--builddevice <ID>	ID uređaja na kojem će se izraditi aplikacije.
--cmake <ID>	ID CMake izvršne datoteke za izgradnju projekta.
--cmake-config <KEY:TYPE=VALUE>	Parametri za CMake konfiguraciju kompleta. Možete dodati više unosa ove vrste.
--cmake-generator <GEN>:<EXTRA>:<TOOLSET>:<PLATFORM>	CMake generator za korištenje pri izradi projektnih datoteka.
--debugger <PATH>	Staza do otklanjivača pogrešaka koji se koristi za komplet. Nemojte koristiti ovu opciju s --debuggerid.
--debuggerengine <ENGINE>	Tip otklanjivača postavljenog pomoću --debugger. Nemojte koristiti ovu opciju s --debuggerid.
--debuggerid <ID>	Jedan od ID-ova koji se koriste pri dodavanju otklanjivača pogrešaka pomoću operacije addDebugger. Nemojte koristiti ovu opciju s --debugger i --debuggerengine.
--device <ID>	Uređaj na kojem će se izvršavati aplikacije.
--devicetype <TYPE>	Vrsta uređaja na kojem će se pokretati aplikacije: Android.Device.Type za Android uređaje. Desktop za kod koji se pokreće na lokalnom računalu. Ios.Device.Type za iOS uređaje. Ios.Simulator.Type za iOS simulatore. GenericLinuxOsType za ugrađene Linux uređaje. WebAssemblyDeviceType za web-preglednike. Niz koji vraća IDevice::type().
--env <VALUE>	Vrijednosti varijabli okruženja za razvojno okruženje. Možete dodati više unosa ove vrste.
--run-env <VALUE>	Vrijednosti varijabli okruženja za okruženje izvođenja. Možete dodati više unosa ove vrste.
--icon <PATH>	Staza do slike koja će se koristiti kao ikona za komplet.
--id <ID>	ID skupa. Qt Creator automatski postavlja ID kada otkrije instalirane verzije Qt-a na računalu.
--<LANG>toolchain <ID>	Jedan od ID-ova koji se koriste pri dodavanju kompajlera pomoću operacije addTC. <LANG> je: C, Cxx, Nim ili nešto što je postavila dodatna komponenta.
--mkspec <PATH>	Konfiguracija mkspec -a koju qmake koristi. Ostavite ovu opciju praznom da biste koristili zadanu mkspec postavljenu za odabranu verziju Qt-a.
--name <NAME>	Naziv kompleta. Možete koristiti varijable za generiranje naziva kompleta na temelju elemenata kompleta koje ste postavili drugim operacijama, kao što je verzija Qt-a.
--qt <ID>	Jedan od ID-ova koji se koriste pri dodavanju Qt verzija pomoću operacije addQt.
<KEY> <TYPE:VALUE>	Dodatna podešavanja kao parovi ključ-vrijednost.

Za više informacija pogledajte Dodavanje kompleta.

Primjer kompleta

Da biste dodali kit koji koristi GCC kompajler i samostalno izgrađeni Qt za izradu aplikacija na Linuxu, unesite:

./sdktool addKit \
    --id "company.product.kit" \
    --name "Qt %{Qt:Version} (company, product)" \
    --debuggerid "company.product.toolchain.gdb" \
    --devicetype GenericLinuxOsType \
    --sysroot /tmp/sysroot \
    --Ctoolchain "ProjectExplorer.ToolChain.Gcc:company.product.toolchain.gcc" \
    --Cxxtoolchain "ProjectExplorer.ToolChain.Gcc:company.product.toolchain.g++" \
    --qt "company.product.qt" \
    --mkspec "devices/linux-mipsel-broadcom-97425-g++" \

Dodavanje, dohvaćanje i pronalaženje ključeva

Unesite putanju do datoteke relativno u odnosu na direktorij s glavnim postavkama i bez ekstenzije .xml, a zatim jedan ili više parova ključ-vrijednost <KEY> <TYPE>:<VALUE>.

Uklanjanje konfiguriranih stavki

Za uklanjanje CMake alata, kompajlera, otklonitelja pogrešaka, uređaja, verzije Qt-a ili skupa, unesite:

rm<Item> --id <ID>

Gdje je <ID> ID stavke.