Данная статья применима к:
- Astra Linux Special Edition РУСБ.10015-01 (очередное обновление 1.8);
- Astra Linux Special Edition РУСБ.10015-01 (очередное обновление 1.7);
- Astra Linux Special Edition РУСБ.10152-02 (очередное обновление 4.7).
Подготовка рабочего места
На рабочем месте должны быть соблюдены следующие условия:
рабочее место функционирует под управлением ОС Astra Linux 1.7.5 на уровне защищенности «Усиленный» или «Максимальный»;
создана учетная запись с правами администратора, от имени которой будет происходить создание проекта и сборка пакета;
отключена блокировка трассировки
ptrace
;
Подготовка проекта в Qt Creator
Общие сведения
Для работы в Qt Creator был создан демонстрационный проект, который может использоваться как шаблон для разработчиков на Qt. Архив с проектом доступен по ссылке: https://disk.astralinux.ru/s/kSrtg5JKnzmeGdn.
Демонстрационный проект написан на языках C++ и QML. Демонстрационный проект обладает следующим функционалом:
загрузка разных страниц с текстом и картинками;
светлая/темная тема;
загрузка файлов локализации.
В демонстрационном проекте используется библиотека Qt-5.15.x и базовые модули Qt. Для более сложных проектов необходимо использовать дополнительные библиотеки и компоненты, например KDE Frameworks и Kirigami UI Framework.
Подготовка репозиториев
Для установки необходимых для сборки пакетов должны быть подключены следующие репозитории:
deb http://download.astralinux.ru/astra/stable/1.7_x86-64/repository-base/ 1.7_x86-64 main contrib non-free deb http://download.astralinux.ru/astra/stable/1.7_x86-64/repository-extended/ 1.7_x86-64 main contrib non-free
Следует убедиться, что нужные репозитории подключены, выведя содержимое файла /etc/apt/sources.list
командой:
Если в выводе команды данных репозиториев нет, необходимо добавить их в файл /etc/apt/sources.list
.
Убедившись, что нужные репозитории подключены, необходимо обновить список пакетов командой:
sudo apt update
Установка Qt и Qt Creator
Для установки Qt и Qt Creator необходимо выполнить команды:
sudo apt install qt5-default
sudo apt install clang cmake
sudo apt install qtdeclarative5-dev qtquickcontrols2-5-dev qttools5-dev
sudo apt install qtcreator
Сборка проекта
Для того чтобы собрать демонстрационный проект, необходимо:
- скачать архив с проектом по ссылке: https://disk.astralinux.ru/s/kSrtg5JKnzmeGdn;
- распаковать архив с проектом в отдельный каталог;
- запустить Qt Creator — в меню Пуск выбрать Разработка — Qt Creator;
- в окне программы в меню выбрать Файл — Открыть файл или проект;
- в открывшемся окне найти каталог проекта и выбрать файл
CmakeLists.txt
, затем нажать [Открыть]. В окне программы будет отображено дерево каталогов и файлов проекта;
- запустить сборку проекта — в окне программы в меню выбрать Сборка — Запустить или нажать комбинацию клавиш <Ctrl+R>.
Сборка deb-пакета
Условия сборки пакета
Перед началом сборки пакета должны быть установлены следующие пакеты:
dpkg-dev
— набор инструментов для работы с исходными файлами;devscripts
— набор сценариев для сборки пакета;equivs
— необходим для запуска инструментаmk-build-deps
для установки зависимых пакетов.
Для сборки пакета необходимы следующие каталоги и файлы:
astra-sample-app-0.1.2
— каталог, название которого соответствует названию и версии собираемого пакета;astra-sample-app-0.1.2/debian
— каталог с нужными для сборки файлами:control
— основной файл с описанием собираемого пакета и его зависимостей;changelog
— файл с описанием истории изменения пакета;rules
— файл с правилами компиляции пакета во время его сборки.
Каталог astra-sample-app-0.1.2/debian
также содержит следующие файлы:
postinst
— сценарий, запускаемый после установки пакета;postrm
— сценарий, запускаемый после удаления пакета;preinst
— сценарий, запускаемый перед установкой пакета;prerm
— сценарий, запускаемый перед удалением пакета.
Для сборки пакета под конкретные версии различных дистрибутивов Linux удобнее всего использовать отдельные chroot
-окружения.
c
hroot
-окружение позволяет запустить ОС, предназначенную для одной архитектуры (например arm64/
aarch64
), внутри ОС, предназначенной для другой архитектуры (например amd64/
x86_64
).
Примеры сценариев, автоматически настраивающих chroot-окружения сборки для Astra Linux под архитектуры amd64
(x86_64
) и arm64
(aarch64
), можно найти в каталоге astra-sample-app/linux
.
Далее рассмотрена ручная настройка окружения сборки с использованием инструмента debootstrap
.
Установка debootstrap
Инструмент debootstrap
используется для подготовки окружения сборки. Для установки инструмента выполнить команду:
Для создания окружения сборки используется команда следующего вида:
Подготовка окружения сборки
Подготовка окружения сборки выполняется в следующем порядке:
- выполнить команду:
sudo debootstrap --arch=amd64 --components=main,contrib,non-free 1.7_x86-64 chroot-amd64 http://download.astralinux.ru/astra/stable/1.7_x86-64/repository-base/
- в файл
chroot-amd64/etc/apt/sources.list
добавить репозитории:deb http://download.astralinux.ru/astra/stable/1.7_x86-64/repository-base/ 1.7_x86-64 main contrib non-free deb http://download.astralinux.ru/astra/stable/1.7_x86-64/repository-extended/ 1.7_x86-64 main contrib non-free
deb https://download.astralinux.ru/astra/frozen/1.8_x86-64/1.8.1/extended-repository/ 1.8_x86-64 main contrib non-free non-free-firmware deb https://download.astralinux.ru/astra/frozen/1.8_x86-64/1.8.1/main-repository/ 1.8_x86-64 main contrib non-free non-free-firmware
- выполнить команды для подготовки каталога сборки:
echo "export LC_ALL=C" | sudo tee -a chroot-amd64/root/.bashrc
sudo chroot chroot-amd64 apt update
sudo chroot chroot-amd64 apt install devscripts quilt equivs
sudo chown -R "${USER}:${USER}" chroot-amd64/opt/
Подготовка окружения сборки выполняется в следующем порядке:
- выполнить команду:
sudo debootstrap --arch=arm64 --components=main,contrib,non-free 4.7_arm chroot-arm64 http://download.astralinux.ru/astra/stable/4.7_arm/repository-base/
- в файл
chroot-amd64/etc/apt/sources.list
добавить репозитории:deb http://download.astralinux.ru/astra/stable/4.7_arm/repository-base/ 4.7_arm main contrib non-free deb http://download.astralinux.ru/astra/stable/4.7_arm/repository-extended/ 4.7_arm main contrib non-free
- выполнить команды для подготовки каталога сборки:
echo "export LC_ALL=C" | sudo tee -a chroot-arm64/root/.bashrc
sudo chroot chroot-arm64 /debootstrap/debootstrap --second-stage
sudo chroot chroot-arm64 apt update
sudo chroot chroot-arm64 apt install devscripts quilt equivs
sudo chown -R "${USER}:${USER}" chroot-arm64/opt/
Сборка пакета
Сборка пакета выполняется в следующем порядке:
- выполнить команды монтирования:
sudo mount -t proc proc chroot-amd64/proc
sudo mount -t sysfs sys chroot-amd64/sys
sudo mount -t devpts devpts chroot-amd64/dev/pts
sudo mount -o bind /dev/shm chroot-amd64/dev/shm
- скопировать каталог проекта в каталог
chroot-
и перейти вamd64
/optchroot
-окружение, выполнив команды:cp -a astra-sample-app-0.1.2 chroot-amd64/opt/
sudo chroot chroot-amd64
- выполнить команды сборки пакета:
cd /opt/astra-sample-app-0.1.2
mk-build-deps -i -r
dpkg-buildpackage -us -uc -ui -j$(nproc)
Собранный пакет будет расположен в каталоге chroot-
.amd64
/opt
Если есть необходимость очистить окружение сборки, выполнить команды:
dpkg -l | grep build-deps
apt purge '*build-deps*'
apt autoremove --purge
После сборки пакета необходимо размонтировать каталоги, выполнив команды:
sudo umount chroot-amd64/proc
sudo umount chroot-amd64/sys
sudo umount chroot-amd64/dev/pts
sudo umount chroot-amd64/dev/shm
Сборка пакета выполняется в следующем порядке:
- выполнить команды монтирования:
sudo mount -t proc proc chroot-arm64/proc
sudo mount -t sysfs sys chroot-arm64/sys
sudo mount -t devpts devpts chroot-arm64/dev/pts
sudo mount -o bind /dev/shm chroot-arm64/dev/shm
- скопировать каталог проекта в каталог
chroot-arm64/opt
и перейти вchroot
-окружение, выполнив команды:cp -a astra-sample-app-0.1.2 chroot-arm64/opt/
sudo chroot chroot-arm64
- выполнить команды сборки пакета:
cd /opt/astra-sample-app-0.1.2
mk-build-deps -i -r
dpkg-buildpackage -us -uc -ui -j$(nproc)
Собранный пакет будет расположен в каталоге chroot-arm64/opt
.
Если есть необходимость очистить окружение сборки, выполнить команды:
dpkg -l | grep build-deps
apt purge '*build-deps*'
apt autoremove --purge
После сборки пакета необходимо размонтировать каталоги, выполнив команды:
sudo umount chroot-arm64/proc
sudo umount chroot-arm64/sys
sudo umount chroot-arm64/dev/pts
sudo umount chroot-arm64/dev/shm
Установка deb-пакета
Для установки собранного пакета необходимо из каталога, в котором располагается пакет, выполнить команду:
sudo apt install ./astra-sample-app_0.1.2
_amd64.deb
Запуск программы
Запуск программы выполняется одним из следующих способов:
- через меню Пуск — Утилиты — Astra Sample App;
из терминала — выполнить команду:
astra-sample-app
Запуск программы в режиме «Мобильный» выполняется следующим образом:
- вызвать экран приложений — коснуться нижней части экрана и провести пальцем вверх;
- на экране приложений в разделе Мобильные коснуться значка программы «Astra Sample App».
Запуск программы выполняется одним из следующих способов:
- через меню Пуск — Научные — Astra Sample App;
из терминала — выполнить команду:
astra-sample-app
Запуск программы в режиме «Мобильный» выполняется следующим образом:
- вызвать экран приложений — коснуться нижней части экрана и провести пальцем вверх;
- на экране приложений в разделе Мобильные коснуться значка программы «Astra Sample App».