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

    # uporabi ninjo za hitrejšo inkrementalno obnovo, izklopi nekatere stvari Qt 5, da manj manj
    # odvisnosti
    cmake-options -G "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.

Integracija LSP

# orodja clangd
compile-commands-export yes
compile-commands-linking yes

Te vrstice zagotavljajo, da bo CMake ustvaril datoteke compile_commands.json, ki so potrebne za integracijo LSP na osnovi clangd. Poleg tega, da jih samo ustvarite znotraj imenika gradnje, jih bo možnost povezovanja simbolično povezala nazaj v vaše izvorne imenike. 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.