Izgradi ga
Gradnja Kate iz izvorne kode na Linuxu
Trenutno se izvorna koda Kate nahaja na Gitlabu na invent.kde.org. Ta učbenik pojasnjuje, kako zgraditi Kate, ne da bi se dotaknili vaše globalne namestitve.
Vse stvari se bodo zgodile v dodatnem razvojnem imeniku. S tem se izognete potrebi po pravicah skrbnika sistema in še vedno omogoča nadomestno uporabo globalno nameščenega urejevalnika Kate, če je trenutna različica gradnje pokvarjena.
Ta učbenik bo predstavil nastavitev, ki omogoča razvoj drugih delov sklada programske opreme KDE, bomo v nadaljevanju govorili o nastavitvah razvojnega okolja KDE. Zahtevana ogrodja KDE bodo prevedena poleg delov aplikacije Kate. To olajša prispevke za vse ravni sklada programske opreme KDE.
Izberite svoj imenik za razvoj Kate & KDE
Izberite si neko pot, kjer naj se vse razvojne stvari Kate & KDE končajo. Razen uporabniških lokalnih konfiguracijskih datotek, ne bo onesnaženo ničesar zunaj tega imenika. To lahko ponovno uporabite za razvoj pri katerem koli delu KDE sklada programske opreme.
Za preostale dele tega opisa uporabljamo
~/projects/kde
To lahko prilagodite.
Namesti kdesrc-build
Namestitev je bolj ali manj le kloniranje trenutne različice
mkdir -p ~/projects/kde/src
cd ~/projects/kde/src
git clone https://invent.kde.org/sdk/kdesrc-build.git
Za kasnejšo lažjo uporabo je najbolje, da simbolno povežete skript kdesrc-build z neko mapo znotraj vaše poti, npr. če imate user local bin:
ln -s ~/projects/kde/src/kdesrc-build/kdesrc-build ~/bin
Konfiguriranje kdesrc-build
kdesrc-build ima korak nastavitev, ko lahko konfigurira stvari namesto vas, glejte ta uvod.
Tukaj samo prikazujemo, da je ~/.config/kdesrc-buildrc dovolj dober za razvojne potrebe za Kate.
Spodnjo različico lahko preprosto kopirate in prilepite v svoj domači imenik kot**~/.config/kdesrc-buildrc** in prilagodite poti svojim potrebam. Če se držite poti ~/projects/kde, ki smo jo izbrali zgoraj, bi to moralo biti uporabno 1:1.
global
# uporabite najnovejšo programsko opremo, ki temelji na KF6 in Qt6.
branch-group kf6-qt6
# želimo v datotekah .kateproject z ninjo, izklopimo nekatere stvari Qt 5, da bomo imajo manj
# odvisnosti
cmake-options -G "Kate - Ninja" -DBUILD_WITH_QT6=ON -DQT_MAJOR_VERSION=6 -DPHONON_BUILD_QT5=OFF -DBUILD_QT5=OFF
# orodja clangd
compile-commands-export yes
compile-commands-linking yes
# ploska struktura
directory-layout flat
# Namesti imenik za programje KDE
install-dir ~/projects/kde/usr
# Imenik za sem preneseno izvorno kodo
source-dir ~/projects/kde/src
# Imenik za privzeto vgradnjo KDE pred namestitvijo glede na izvorni imenik
build-dir ~/projects/kde/build
end global
include ${module-definitions-dir}/kf6-qt6.ksb
Pomembne vrstice za dobro izkušnjo pri razvoju Kate (ali česa drugega v KDE) s Kate so podrobno opisane spodaj.
Ustvari datoteke .kateproject
# želimo datoteke .kateproject z ninja
cmake-options -G "Kate - Ninja"
To zagotavlja, da ne dobite samo datotek Ninja za izgradnjo (odlično, saj bo to npr.samodejno uporabljalo več jeder za prevajanje), vendar poleg tega datoteke .kateproject znotraj imenikov za izgradijo mape tudi za kasnejšo uporabo. S temi datotekami bo projektni vtičnik Kate vedel, kaj storiti, npr. kjer je izvorni imenik za prevajanje in katere ukaze za gradnjo naj uporabi vtičnik za gradnjo.
Zagotovi, da integracija LSP deluje
# orodja clangd
compile-commands-export yes
compile-commands-linking yes
To zagotavlja, da bo CMake ustvaril datoteke compile_commands.json, ki so potrebne za integracijo LSP na osnovi clangda. Poleg tega, da jih samo ustvarjaznotraj imenika gradnje jih bo možnost povezovanja simbolično povezala nazaj z vašim izvornim imenikom. To omogoča uporabo vtičnika LSP brez konfiguracije znotraj Kate (in drugih urejevalnikov).
Namesti potrebne odvisnosti (neobvezno)
kdesrc-build ponuja nekaj začetnih namestitvenih načinov za namestitev potrebnih paketov za več pogostih distribucij, da začnete razvijati. To je v pomoč, če niste prepričani, ali so nameščeni vsi potrebni razvojni paketi v vašem sistemu in za to ne želite sami poskrbeti ročno. Ker boste s tem poskušali namestiti pakete za vašo distribucijo, bo ta korak zahteval skrbniške pravice za namestitev paketov. Če želite to narediti, samo sprožite:
kdesrc-build --initial-setup
Ustvarili smo že .config/kde-builderrc, ki bo ostala nedotaknjena. Za nadaljnjo uporabo vam tudi ni treba spreminjati nastavitve shella.
Zgradi Kate & odvisnosti
Če želite sprožiti prevajanje Kate in vseh potrebnih odvisnosti KDE, zdaj preprosto vnesite:
kdesrc-build --include-dependencies kate
To traja nekaj minut na novejšem računalniku. Čas je, da popijete kavo ali razmislite o tem, kaj pravzaprav želite izvesti.
Dokler različica KF 6 naših odvisnosti ni v paketu z vašo distribucijo, bi bilo morda smiselno zgraditi še nekaj delov, da bi imeli boljši slog in integracijo terminala:
kdesrc-build --include-dependencies breeze plasma-integration kwayland-integration konsole kate
Če želite samo zgraditi Kate brez odvisnosti, ker ste prepričani če imate v sistemu dovolj nedavnih stvari, lahko poskusite:
kdesrc-build --no-include-dependencies kate
Toda glede na to, da so na sodobnih računalnikih časi prevajanja kratki, je bolj priročno samo sestaviti vse stvari, kar zagotavlja, da imate npr. zadnja in najboljša ogrodja KSyntaxHighlighting in KTextEditor!
Glede na to nastavitev lahko prosto zgradite vse dele programske opreme KDE s preprostim:
kdesrc-build
Upoštevajte, da to bo trajalo nekaj časa (in prostora na disku).
Če med gradnjo vidite kakršne koli napake, prikazane z rdečo pisavo, sledite temu vodniku - Kako rešiti težave pri gradnji
Kako uporabljati gradivo?
Če želite zagnati lokalno različico Kate, morate najprej pravilno nastaviti okolje, da zagotovite nalaganje pravih vtičnikov in stvari. Na srečo je to zelo preprosto:
source ~/projects/kde/build/kate/prefix.sh
kate
Izjemen način za zavijanje tega je, da npr. ustvarite majhen ovojni skript, da zaženete glavno vejo različice Kate znotraj lokalnega imenika bin:
#!/bin/bash
source ~/projects/kde/build/kate/prefix.sh
exec kate "$@"
Naj bodo vaše stvari posodobljene
Če želite ohraniti svojo lokalno različico posodobljeno, lahko preprosto ponovno uporabite zgornje ukaze. Poskrbeli bodo za črpanje novih sprememb iz skladišč KDEin njihovo gradnjo/nameščanje v vašo lokalno predpono.
Razvij!
Zdaj pa ostaja vprašanje: Kako najbolje razvijati?
Seveda, če želite programsko razdreti Kate, je morda smiselno, da kar Kate uporabite za to.
Glede na zgornje priprave je to enostavno narediti, samo zaženite svojo različico Kate iz novega glavnega imenika in ji posredujte imenik za izgradnjo:
kate ~/projects/kde/build/kate
Lahko pa se tja pomaknete v svojem terminalu ter zaženete Kate od tam in ga bo samodejno odprl:
cd ~/projects/kde/build/kate
kate
Za najboljšo izkušnjo s tem poskrbite, da imate omogočen vsaj projekt in vtičnik LSP. Če želite imeti integracijo gradnje GUI, aktivirajte tudi vtičnik za gradnjo.
Na koncu boste imeli nova okna Kate, kot je prikazano spodaj.
V spodnjem pogledu orodja »Trenutni projekt« imate privzeto dva terminala. Prvi terminal je v vašem imeniku gradnje, tukaj lahko npr. zaženete ukaze ninja in ninja install in podobno. Drugi terminal je znotraj vašega izvornega imenika, kot nalašč za npr. ukazno vrstico klicev git.
Glede na zgornjo nastavitev bi moral vtičnik LSP (če imate nameščen clangd) delovati brez dodatnih posegov.
Druge odlične stvari, kot je hitro odpiranje, iskanje in zamenjava ter popravljanje ciljev gradnje projektov lahko tudi nastavite.
Prispevajte nazaj!
Prosto ustvarite zahtevo za spajanje na invent.kde.org. Za več informacij si oglejte Pridružite se nam.
Dobivamo podporo?
Če imate vprašanja, jih lahko zastavite na našem poštnem seznamu kwrite-devel@kde.org in/ali se pridružite #kate na irc.libera.chat.
Za več informacij glejte Poiščite pomoč.
Gradnja Kate iz izvorne kode na sistemu Windows
Če želite zgraditi Kate/KWrite, ki temelji na KF5, lahko sledite vodniku na KDE onWindows.
Gradnja Kate iz izvorne kode na sistemu macOS
Če želite zgraditi Kate/KWrite, ki temelji na KF5, lahko sledite vodniku na KDE na macOS.