Konstruante Kate el Fontoj en Linukso

Ĝuste nun, la fontkodo de Kate troviĝas sur la invent.kde.org GitLab-instanco. Ĉi tiu lernilo klarigas kiel konstrui Kate sen tuŝi vian tutmondan instalaĵon.

Ĉiuj aferoj okazos ene de kroma disvolva dosierujo. Ĉi tio evitas la bezonon de administraj rajtoj kaj ebligas ĉiam retrovi por uzi la ĉiean instalitan Kate se la nuna konstrua versio estas rompita.

Ĉar ĉi tiu lernilo enkondukos aranĝon, kiu ebligas evoluigi aliajn partojn de la programaro de KDE, ankaŭ, ni parolos jene pri agordo de KDE-disvolva medio. Bezonataj KDE-Kadroj estos kompilitaj aldone al la Kate-aplikpartoj. Ĉi tio faciligas kontribuojn al ĉiuj niveloj de la programaro de KDE.

Elektu vian disvolvan dosierujon de Kate & KDE

Elektu al vi ian vojon, kie ĉiuj disvolvaj aferoj de Kate & KDE devus finiĝi. Krom lokaj agordaj dosieroj de uzanto, nenio ekster ĉi tiu dosierujo estos poluita. Vi povas reuzi ĉi tion por disvolviĝo en iu ajn parto de la programaro de KDE.

Por la ceteraj partoj de ĉi tiu priskribo ni uzas

~/projects/kde

Bonvolu personecigi ĉi tion.

Instali kdesrc-build

Instalado estas pli-malpli nur klonado de la nuna versio

mkdir -p ~/projects/kde/src
cd ~/projects/kde/src
git clone https://invent.kde.org/sdk/kdesrc-build.git

Por posta facileco de uzado, plej bone ligu la kdesrc-build-skripton al iu dosierujo ene de via vojo, ekz. se vi havas iun uzant-lokan bin-ujon:

ln -s ~/projects/kde/src/kdesrc-build/kdesrc-build ~/bin

Agordante kdesrc-build

kdesrc-build havas iun agordan paŝon kiu povas agordi aĵojn por vi, vidu ĉi tiun enkondukon.

Ĉi tie ni nur montras ~/.config/kdesrc-buildrc kiu estas sufiĉe bona por Kate-disvolvaj bezonoj.

Vi povas simple kopii kaj alglui la suban varianton en vian hejman dosierujon kiel ~/.config/kdesrc-buildrc kaj adapti la vojojn al viaj bezonoj. Se vi restas kun la vojo ~/projects/kde, kiun ni elektis supre, ĉi tio estu uzebla 1:1.

global
    # uzu la plej novajn programojn bazitajn sur KF6 kaj Qt6.
    branch-group kf6-qt6

    # uzu ninja por pli rapida alkrementa rekonstruado, malŝaltu iujn Qt5-aferojn por havi malpli da
    # dependecoj
    cmake-options -G "Ninja" -DBUILD_WITH_QT6=ON -DQT_MAJOR_VERSION=6 -DPHONON_BUILD_QT5=OFF -DBUILD_QT5=OFF

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

    # plata strukturo
    directory-layout flat

    # Instalu dosierujon por KDE-programaro
    install-dir ~/projects/kde/usr

    # Dosierujo por elŝutita fontkodo
    source-dir ~/projects/kde/src

    # Dosierujo por konstrui KDE antaŭ ol instali rilate al fonto-dir defaŭlte
    build-dir ~/projects/kde/build
end global

include ${module-definitions-dir}/kf6-qt6.ksb

La gravaj linioj por havi bonan sperton disvolvante Kate (aŭ aliajn KDE-aĵojn) kun Kate estas priskribitaj sube detale.

LSP-integriĝo

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

Ĉi tiuj linioj certigas, ke CMake generos la compile_commands.json dosierojn kiuj estas postulataj por clangd-bazita LSP-integriĝo. Krom sole generi ilin ene de la konstrua dosierujo, la ligad-opcio simbole ligos ilin reen al viaj fontaj dosierujoj. Ĉi tio permesas nul-agordan uzadon de la LSP-kromprogramo ene de Kate (kaj aliaj redaktiloj).

Instalu bezonatajn dependecojn (laŭvola)

kdesrc-build provizas iun komencan agordan reĝimon por instali la bezonatajn pakaĵojn por ke pluraj oftaj distribuaĵoj komenciĝu. Ĉi tio estas helpema se vi ne certas ĉu ĉiuj bezonataj disvolvaj pakoj estas instalitaj en via sistemo kaj vi ne volas prizorgi tion mem permane. Ĉar ĉi tio provos instali pakaĵojn por via distribuo, ĉi tiu paŝo postulos administrantajn rajtojn por la paka instalado. Por fari tion, simple lanĉu:

kdesrc-build --initial-setup

Ni jam kreis .config/kdesrc-buildrc, kiu restos netuŝita. Por la plua uzado vi ankaŭ ne bezonas modifi viajn ŝelajn agordojn.

Konstruu Kate kaj dependecojn

Por ekigi kompilon de Kate kaj ĉiuj bezonataj KDE-dependecoj nun simple tajpu:

kdesrc-build --include-dependencies kate

Tio daŭras kelkajn minutojn en lastatempa maŝino. Tempo por preni iom da kafo aŭ pensi pri tio, kion vi vere volas efektivigi.

Dum kiam la KF-6 versio de niaj dependecoj ne estas kunmetita kun via distribuo, povus havi sencon konstrui kelkajn pliajn partojn por havi pli bonan stiladon kaj terminalan integriĝon:

kdesrc-build --include-dependencies breeze plasma-integration kwayland-integration konsole kate

Se vi nur volas konstrui Kate sen la dependecoj ĉar vi certas, ke vi havas sufiĉe lastatempajn aĵojn en via sistemo, vi povas provi:

kdesrc-build --no-include-dependencies kate

Sed pro tio, ke ĉe modernaj maŝinoj, la kompiltempoj estas malaltaj, estas pli oportune nur konstrui ĉiujn aĵojn, tio certigas, ke vi havas ekz. la plej novaj kaj plej bonaj kadroj KSyntaxHighlighting kaj KTextEditor ĉirkaŭe ankaŭ!

Konsiderante ĉi tiun aranĝon, vi rajtas konstrui ĉiujn KDE-programarajn partojn per simpla:

kdesrc-build

Memoru: tio daŭros iom da tempo (kaj diskospaco).

Se dum la konstruo vi vidas iujn malsukcesojn montritajn per ruĝa tiparo, sekvu ĉi tiun gvidilon - Kiel solvi konstruproblemojn

Kiel uzi la konstruaĵojn?

Por lanĉi vian lokan Kate-version, vi devas unue agordi la medion ĝuste por certigi, ke la ĝustaj kromprogramoj kaj aĵoj estas ŝarĝitaj. Feliĉe ĉi tio estas tre simpla:

source ~/projects/kde/build/kate/prefix.sh
kate

Agrabla maniero envolvi ĉi tion estas ekz. kreu al vi malgrandan envolvaĵan skripton por komenci vian ĉefbranĉan version de Kate ene de via loka bin-dosierujo:

#!/bin/bash
source ~/projects/kde/build/kate/prefix.sh
exec kate "$@"

Tenu viajn aĵojn ĝisdatigitaj

Por konservi vian lokan version ĝisdatigita, vi povas simple uzi la suprajn komandojn denove. Ili zorgos pri eltiri novajn ŝanĝojn el la KDE-deponejoj kaj konstrui/instali ilin en vian lokan prefikson.

Evoluigu!

Nun, la restanta demando estas: Kiel disvolvi plej bone?

Kompreneble, se vi volas haki Kate, povus havi sencon uzi Kate por tio.

Konsiderante la suprajn preparojn, tio estas facile fari, simple komencu vian novan majstran version de Kate kaj transdonu al ĝi la konstruan dosierujon:

kate ~/projects/kde/build/kate

Alternative, vi povas navigi tie en via terminalo kaj lanĉi Kate de tie, ĝi aŭtomate malfermos ĝin:

cd ~/projects/kde/build/kate
kate

Por havi la plej bonan sperton pri tio, certigu, ke vi havas almenaŭ projektan kaj LSP-kromaĵon ebligita. Se vi ŝatas havi iom da GUI-konstrua integriĝo, ankaŭ aktivigu la konstruan kromaĵon.

Vi finiĝos kun novaj Kate-fenestroj kiel montrite sube.

En la malsupra "Nuna Projekto" ila vido vi havas defaŭlte du terminalojn. La unua terminalo estas ene de via konstrua dosierujo, ĉi tie vi povas ekz. rulu viajn komandojn ninja kaj ninja install kaj tiajn. La dua terminalo estas ene de via fonta dosierujo, perfekta por ekz. git komandliniaj vokoj.

Konsiderante la ĉi-supran aranĝon, la LSP-kromaĵo (se vi havas clangd instalitan) devus funkcii el la skatolo.

Ankaŭ aliaj agrablaj aferoj kiel projekto larĝe malfermita, serĉi kaj anstataŭigi kaj ĝustajn konstruajn celojn devus esti aranĝitaj.

Kontribuu reen!

Bonvolu krei kunfandan peton ĉe invent.kde.org. Por pliaj informoj vidu Aliĝi al ni.

Ĉu akiri Subtenon?

Se vi havas demandojn, vi povas demandi ilin en nia dissendolisto kwrite-devel@kde.org kaj/aŭ aliĝi al #kate ĉe irc.libera.chat.

Por pliaj informoj vidu Akiri Helpon.

Konstruante Kate el Fontoj sur Vindozo

Por konstrui la Kate/KWrite bazitan en KF5, vi povas sekvi la gvidilon ĉe KDE en Vindozo.

Konstruante Kate de Fontoj sur macOS

Por konstrui la Kate/KWrite bazitan en KF5, vi povas sekvi la gvidilon en KDE sur macOS.