CondinAPT в MiniOS: Руководство по интеграции

В этом документе описаны особенности использования CondinAPT в системе сборки MiniOS.

📚 Основная документация: Для базовых возможностей CondinAPT смотрите основной документ CondinAPT.md

Оглавление

• Интеграция с системой сборки MiniOS
• Конфигурация MiniOS
• Использование в модулях
• Примеры для MiniOS

Интеграция с системой сборки MiniOS

Использование в модулях MiniOS

CondinAPT — стандартный инструмент для установки пакетов в модулях MiniOS. Он интегрируется в процесс сборки через стандартный интерфейс модуля.

В скрипте установки модуля (install):

#!/bin/bash
set -e

# Load MiniOS library
. /minioslib || exit 1

# Install packages via CondinAPT
/linux-live/condinapt \
    -l "$CWD/packages.list" \
    -c /linux-live/build.conf \
    -m /linux-live/condinapt.map

Структура модуля MiniOS

Каждый модуль в /linux-live/scripts/ имеет стандартизированную структуру:

XX-module-name/
├── packages.list                     # Package list with conditions
├── install                           # Installation script (uses CondinAPT)
├── rootcopy-install/                 # (optional) Files to copy
└── rootcopy-postinstall/             # (optional) Files after installation

Конфигурация MiniOS

Содержимое condinapt.map в MiniOS

d=DISTRIBUTION
da=DISTRIBUTION_ARCH
dt=DISTRIBUTION_TYPE
de=DESKTOP_ENVIRONMENT
pv=PACKAGE_VARIANT
ik=INSTALL_KERNEL
kf=KERNEL_FLAVOUR
ka=KERNEL_AUFS
kbd=KERNEL_BUILD_DKMS
ib=INITRAMFS_BUILDER
lo=LOCALE
ml=MULTILINGUAL
kl=KEEP_LOCALES

Переменные конфигурации MiniOS

Основные переменные из build.conf:

• DISTRIBUTION — целевая дистрибуция (bookworm, trixie, jammy, noble)
• DISTRIBUTION_ARCH — архитектура (amd64, i386, i386-pae)
• DESKTOP_ENVIRONMENT — рабочее окружение (core, flux, xfce, lxqt)
• PACKAGE_VARIANT — вариант набора пакетов (minimum, standard, toolbox, ultra)
• INSTALL_KERNEL — устанавливать пакет ядра (true/false)
• KERNEL_FLAVOUR — вариант ядра (none, rt, cloud)
• KERNEL_AUFS — поддержка AUFS (true/false)
• KERNEL_BUILD_DKMS — собирать модули DKMS (true/false)
• INITRAMFS_BUILDER — сборщик initramfs (livekit, dracut)
• LOCALE — системная локаль (C, en_US, ru_RU, es_ES, pt_BR)
• MULTILINGUAL — поддержка мультиязычности (true/false)
• KEEP_LOCALES — сохранять локали (true/false)

Автоматически вычисляемые переменные (из minioslib):

• DISTRIBUTION_TYPE — тип дистрибуции (debian, ubuntu) — определяется автоматически на основе DISTRIBUTION
  • legacy: stretch, buster, orel, bionic
  • current: bullseye, bookworm, focal, jammy, noble
  • future: trixie, kali-rolling, sid

Использование в модулях

Пример мультимедийного модуля

packages.list:

# Basic multimedia codecs - always
gstreamer1.0-plugins-base
gstreamer1.0-plugins-good

# Additional codecs - not for minimal variant
gstreamer1.0-plugins-bad -pv=minimum
gstreamer1.0-plugins-ugly -pv=minimum
gstreamer1.0-libav -pv=minimum

# Professional tools - only for toolbox and ultra
audacity +{pv=toolbox|pv=ultra}
kdenlive +{pv=toolbox|pv=ultra} +{de=xfce|de=lxqt}

---

# Distribution-specific packages from backports
ffmpeg @bookworm-backports +d=bookworm

Пример модуля драйверов

packages.list:

# Basic drivers
mesa-utils
xserver-xorg-video-all

# NVIDIA drivers - only for non-free distributions
nvidia-driver +d=bookworm -{pv=minimum&de=core}

# AMD drivers - for modern distributions
firmware-amd-graphics +{d=trixie|d=noble}
mesa-vulkan-drivers +{d=trixie|d=noble}

# Old drivers - for old systems
xserver-xorg-video-radeon +d=bookworm

Пример модуля локализации

packages.list:

# Basic locales - always
locales

# Russian localization
language-pack-ru +lo=ru_RU
fonts-liberation +lo=ru_RU
firefox-esr-l10n-ru +lo=ru_RU +{de=xfce|de=lxqt}

# Multilingual support
task-russian +ml=true +lo=ru_RU
hunspell-ru +ml=true +lo=ru_RU

# Keeping locales
vlc-l10n +kl=true +{pv=toolbox|pv=ultra}

# Regional settings for different locales
language-pack-pt +lo=pt_BR
language-pack-de +lo=de_DE
language-pack-fr +lo=fr_FR

Примеры для MiniOS

Продвинутое использование фильтра в MiniOS

packages.list:

# DKMS modules with kernel and distribution conditions
ntfs3-dkms -ka=true -d=buster -d=trixie -d=sid
zfs-dkms +{pv=toolbox|pv=ultra} +da=amd64 +kbd=true -kf=none

# Drivers for old systems
broadcom-sta-dkms -d=jammy -ka=true -da=i386
aufs-dkms +dt=debian +d=buster

# Exclusion for new distributions
realtek-rtl8821cu-dkms -d=trixie -d=sid
firmware-b43-installer -d=bionic

# Complex alternatives with filters
exfatprogs -pv=minimum || exfat-utils -pv=minimum && exfat-fuse -pv=minimum

# Localization with exclusions and conditions
vlc-l10n -lo=en_US +{pv=toolbox|pv=ultra}
language-pack-gnome-ru-base +lo=ru_RU +dt=ubuntu
language-pack-gnome-ru-base +ml=true +dt=ubuntu
language-pack-gnome-ru-base +kl=true +dt=ubuntu

Оптимизация для MiniOS

Группировка по функционалу:

#=== Core System ===
systemd +pv=standard +pv=toolbox +pv=ultra
dbus

#=== Desktop Environment ===
xfce4-panel +de=xfce
lxqt-panel +de=lxqt
fluxbox +de=flux

#=== Applications by Variant ===
firefox-esr +{pv=standard|pv=toolbox|pv=ultra}
thunderbird +{pv=toolbox|pv=ultra}
libreoffice +pv=ultra

Интеграция с процессом сборки MiniOS

Переменные окружения модуля

В контексте модуля MiniOS доступны следующие переменные:

• $CWD — текущий каталог модуля
• $LIVEKITNAME — имя системы (обычно "minios")
• $MODULE — имя текущего модуля

Использование minioslib

#!/bin/bash
set -e

# Load MiniOS library
. /minioslib || exit 1

# Check module conditions
if [ "$PACKAGE_VARIANT" = "minimum" ] && [ "$DESKTOP_ENVIRONMENT" = "core" ]; then
    echo "Skipping module for minimal core build"
    exit 0
fi

# Install packages
/linux-live/condinapt \
    -l "$CWD/packages.list" \
    -c /linux-live/build.conf \
    -m /linux-live/condinapt.map

---

Для получения полной информации о возможностях CondinAPT смотрите основной документ CondinAPT.md