Ajudar a desenvolver o KDE Linux

A equipe do KDE Linux sempre agradece a ajuda para desenvolver o KDE Linux como o sistema operacional do futuro!

  • Para conversar com os desenvolvedores do KDE Linux, use o Matrix.
  • Para propor alterações, envie uma solicitação de mesclagem em um dos repositórios git relevantes.
  • Para relatar problemas no próprio sistema operacional KDE Linux (por exemplo, design do SO, integração, serviços do sistema, etc) use o invent.kde.org e ignore o assustador banner vermelho no topo da página.
  • Para reportar problemas no KDE Plasma ou em qualquer aplicativo KDE, use o bugs.kde.org.
  • Para obter ajuda com algo relacionado ao KDE Linux, use o discuss.kde.org e marque sua postagem com “kde-linux”.

Imagens CI

Verifique o registro de compilação do seu pipeline. Ele deve indicar onde as imagens foram publicadas.

Você também pode navegar pelas imagens aqui.

Melhorar a velocidade de compilação local

Para acelerar as compilações locais, crie um arquivo mkosi.local.conf na raiz do repositório com o seguinte conteúdo:

[Content]
Environment=LOCALE_GEN="pt_BR.UTF-8 UTF-8" # substitua com o seu locale`
Environment=MIRRORS_COUNTRY=br # substitua com o código do seu país`
Environment=PARALLEL_DOWNLOADS=50 # se sua conexão internet for rápida

Você precisa usar o driver de armazenamento Btrfs para o Docker, caso contrário isso não funcionará corretamente.

Se o sistema de arquivos do seu host usa Btrfs (como o KDE Linux), adicione o seguinte ao arquivo /etc/docker/daemon.json

{
  "storage-driver": "btrfs"
}

A documentação oficial do Docker explicando isso pode ser encontrada aqui.

Se você não usa Btrfs para sua máquina host, ainda pode criar um volume Btrfs com suporte em um arquivo, como mostrado abaixo:

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

Então execute:

./build_docker.sh --incremental

Building Custom System Images

You can generate custom KDE Linux images to test package integrations or system modifications locally. The build process uses mkosi wrapped in a Docker container.

To include custom packages, add the desired package names to the relevant configuration files (such as the [Packages] section in mkosi.conf or the specific .packages files) before running the build script.

Run the build with:

./build_docker.sh

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

Quick Testing with Virt-Manager

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

  1. Open Virtual Machine Manager and start the New Virtual Machine wizard.
  2. Select Import existing disk image and choose your generated .raw file.
  3. Allocate at least 4GB of RAM and 2 CPU cores.
  4. Important: In the VM configuration, ensure the Firmware is set to UEFI and Secure Boot is disabled.

For a more permanent setup or instructions on using other virtualization tools like VirtualBox or UTM, refer to the Installing in a Virtual Machine guide.

Artigo contribuído por e sob a licença CC-BY-4.0.