Pomôžte vyvíjať KDE Linux

Tím KDE Linux vždy ocení pomoc pri vývoji KDE Linux na operačný systém budúcnosti!

Pre komunikáciu s vývojármi KDE Linux použite Matrix.
Pre navrhnutie zmien odošlite Merge Request v jednom z relevantných git úložísk.
Pre nahlásenie problémov v samotnom operačnom systéme KDE Linux (t.j. dizajn OS, integrácia, systémové služby atď.) použite invent.kde.org a ignorujte strašidelný červený banner v hornej časti stránky.
Pre nahlásenie problémov v KDE Plasma alebo akýchkoľvek aplikáciách KDE použite bugs.kde.org.
Pre získanie pomoci s niečím súvisiacim s KDE Linux použite discuss.kde.org a označte svoj príspevok značkou "kde-linux".

CI obrazy

Skontrolujte zostavovací protokol pre váš pipeline. Mal by uvádzať, kde boli obrazy publikované.

Obrazy si môžete prezrieť aj odtiaľto.

Zlepšenie rýchlosti lokálnej zostavy

Pre zrýchlenie lokálnych zostáv vytvorte súbor mkosi.local.conf v koreňovom adresári úložiska s nasledujúcim obsahom:

[Content]
Environment=LOCALE_GEN="en_US.UTF-8 UTF-8" # nahraďte svojím locale`
Environment=MIRRORS_COUNTRY=us # nahraďte svojím kódom krajiny`
Environment=PARALLEL_DOWNLOADS=50 # ak je vaše internetové pripojenie rýchle

Musíte používať úložný ovládač Btrfs pre docker, inak to nebude poriadne fungovať.

Ak váš hostiteľský súborový systém používa Btrfs (ako KDE Linux), pridajte do /etc/docker/daemon.json nasledovné

{
  "storage-driver": "btrfs"
}

Oficiálnu dokumentáciu docker, ktorá to vysvetľuje, nájdete tu.

Ak nepoužívate Btrfs pre váš hostiteľský počítač, môžete stále vytvoriť Btrfs zväzok podporovaný súborom takto:

systemctl stop docker.socket docker.service || true
fallocate -l 64G /store/docker.btrfs
mkfs.btrfs /store/docker.btrfs
[ -d /var/lib/docker ] || mkdir /var/lib/docker
mount /store/docker.btrfs /var/lib/docker
systemctl restart docker.socket docker.service

Potom spustite:

./build_docker.sh --incremental

Zostavenie vlastných systémových obrazov

Môžete generovať vlastné obrazy KDE Linuxu na lokálne testovanie integrácie balíkov alebo systémových úprav. Proces zostavenia používa mkosi zabalený v Docker kontajneri.

Ak chcete zahrnúť vlastné balíky, pridajte požadované názvy balíkov do príslušných konfiguračných súborov (napríklad sekcie [Packages] v súbore mkosi.conf alebo konkrétnych súborov .packages) pred spustením zostavovacieho skriptu.

Spustite zostavenie pomocou:

./build_docker.sh

Once the build finishes successfully, the output will be a .iso image file located in mkosi.output/.

Rýchle testovanie pomocou Virt-Manager

The fastest way to test your changes is to boot the .iso image directly as an existing disk in a Virtual Machine, bypassing the full installation process.

Otvorte Virtual Machine Manager a spustite sprievodcu Nový virtuálny stroj.
Select Local Install Media and choose your generated .iso file.
Prideľte aspoň 4 GB RAM a 2 jadrá CPU.
Dôležité: V konfigurácii VM sa uistite, že Firmware je nastavený na UEFI a Secure Boot je vypnutý.

Pre trvalejšie nastavenie alebo pokyny na použitie iných virtualizačných nástrojov ako VirtualBox alebo UTM si pozrite príručku Inštalácia vo virtuálnom stroji.

Testing Changes with openQA

KDE Linux uses an automated openQA test suite to test system images before they are published. The suite boots images in virtual machines and exercises essential workflows, including installing a new system, upgrading an existing one, and testing the functionality of the installed system. This helps catch regressions that may not be apparent when testing a local build manually.

If your change affects image building, installation, updates, system services, or the desktop environment, consider whether the automated tests need to cover it. See openQA for Developers to learn how to write tests for it.

Článok napísal Harald Sitter, a Nate Graham pod licenciou CC-BY-4.0.