Konstruu Ĝin
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
# ni volas dosierojn .kateproject kun ninja, malŝaltu iujn Qt-5 aferojn por havi malpli da
# dependecoj
cmake-options -G "Kate - 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.
Kreu dosierojn .kateproject
# ni volas dosierojn .kateproject kun ninja
cmake-options -G "Kate - Ninja"
Ĉi tio certigas, ke vi ricevos ne nur Ninja konstrudosierojn (niftaj ĉar tio ekzemple aŭtomate uzos plurajn kernojn por kompiloj) sed krome .kateproject dosierojn ene de la konstruaj dosierujoj por pli posta uzo, ankaŭ. Kun ĉi tiuj dosieroj, la projekta kromaĵo de Kate scios kion fari, ekz. kie estas la fonta dosierujo por la kompilo kaj kiujn konstrukomandojn ĝi devus uzi por la konstrukromaĵo.
Certigu ke LSP-integriĝo funkcias
# clangd ilaro
compile-commands-export yes
compile-commands-linking yes
Ĉi tio certigas ke CMake generos la compile_commands.json dosierojn kiuj estas postulataj por clangd bazita LSP-integriĝo. Krom nur generi ilin ene de la konstrua dosierujo, la ligo-opcio simbolos ilin reen al viaj fontaj dosierujoj. Ĉi tio permesas nul-agordan uzadon de la LSP-aldonaĵo 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.