Distribucija ekstenzija i dodataka

Kako biste svoju ekstenziju ili dodatak učinili dostupnim većem broju korisnika, objavite ga kao ekstenziju ili dodatak za Qt Creator, koji korisnici mogu pronaći i instalirati u načinu rada Extensions.

Također možete distribuirati arhive Lua ekstenzija ili binarne izgradnje dodataka temeljenih na C++ koje korisnici mogu instalirati u Edit > Preferences > Extensions > Install Extensions.

Objavljivanje ekstenzija

Zadani kanal distribucije za ekstenzije je registrar ekstenzija Qt Creator.

Prije objavljivanja ekstenzije pročitajte Ugovor o objavljivanju Qt ekstenzija.

Da biste objavili ekstenziju, slijedite upute u spremištu registra.

Korisnici mogu dodati vlastite registrije ekstenzija, kako je opisano na Qt Creator: Instalirajte ekstenzije.

Izrada binarnih verzija dodataka temeljenih na C++-u

Ako vaš C++-utemeljen dodatak radi i radi na više platformi, trebali biste osigurati binarne izgradnje za sve podržane platforme.

Qt Creator trenutno podržava:

• Windows
• Linux
• macOS

Pogledajte glavnu datoteku README.md u izvorima Qt Creator a za detaljniji popis.

The Qt Creator Plugin wizard već stvara predložak za GitHub Actions koji se može koristiti za izradu binarnih datoteka ako hostate izvore svog dodatka na GitHubu. Pogledajte README.md koji se stvara na istoj lokaciji za detalje.

Također možete upotrijebiti priloženi GitHub Actions recept kao inspiraciju za drugu uslugu za izgradnju po vašem izboru.

Pakiranje

Install Plugin Najlakši način pakiranja vašeg dodatka jest jednostavno pružiti zip datoteku koju korisnik može raspakirati na ispravnu lokaciju kako bi je Qt Creator mogao pronaći. Qt Creator olakšava korisniku to tako što u dijalogu Help > About Plugins (ili Qt CreatorAbout Plugins na macOS-u). Korisnik odabere zip-datoteku s dodatkom, a Qt Creator je raspakira na odgovarajuću lokaciju.

Sljedeći odjeljci opisuju opcije koje imate za raspored sadržaja dodatka.

Jedna biblioteka

Korištenje jedne biblioteke je preferirana i najjednostavnija opcija. Pružate jednu bibliotečnu datoteku dodatka u koju su sažeti svi potrebni resursi pomoću sustava Qt Resource System. To nameće neka ograničenja jer ne možete ovisiti o dodatnim binarnim datotekama, niti proširivati neke dijelove Qt Creator koji ovise o vanjskim datotekama, poput univerzalnog ističača. Na taj način i dalje možete dodati predloške čarobnjaka dodavanjem putanje do direktorija s resursima u vašu QRC datoteku pomoću metode ProjectExplorer::JsonWizardFactory::addWizardPath(). Registracija dokumentacije i prijevoda može se obaviti na sličan način.

Sažetak

• Jedna biblioteka kao jedan element u zip datoteci.
• Resursi su kompajlirani u biblioteku pomoću Qt Resource Systema.
• Može se lokalno instalirati za jednog korisnika za sve kompatibilne instalacije Qt Creator.
• Qt Creator Može se instalirati u instalaciju Qt-a za sve korisnike.

Više datoteka prema rasporedu datotečnog sustava Qt Creator a

Ovo je fleksibilnije rješenje u pogledu onoga što dodatak može raditi, ali je složenije za postavljanje. Ovo omogućuje dodatku da isporuči dodatne binarne datoteke i proizvoljne resurse.

Budući da se raspored datotečnog sustava znatno razlikuje među platformama, sustav za izgradnju Qt Creator -a pruža varijable poput IDE_DATA_PATH i IDE_LIBEXEC_PATH. Ako svoj dodatak gradite pomoću CMake-a, trebali biste koristiti i priložene funkcije add_qtc_library, add_qtc_executable i slične.

U vrijeme izvođenja možete pristupiti ovim lokacijama ovisnim o platformi pomoću Core::ICore::resourcePath() i Core::ICore::libexecPath().

Dodaci koji se distribuiraju na ovaj način ne mogu se lokalno instalirati za pojedinog korisnika. Moraju se instalirati izravno u instalaciju Qt Creator.

Sažetak

• Više datoteka prema standardnom rasporedu datotečnog sustava.
• Koristite specifične varijable i funkcije Qt Creator u sustavu za izgradnju.
• Koristite Core::ICore za pronalaženje lokacija tijekom izvođenja.
• Može se instalirati samo u instalaciju Qt Creator za sve korisnike.