Використання скрипту kdesrc-build

Після визначення даних налаштувань ви будете готові до запуску самого скрипту. Навіть якщо ви все ще хочете дещо налаштувати додатково або ознайомитися із додатковою довідковою інформацією, все ж варто одразу принаймні завантажити метадані проєктів KDE.

Завантаження метаданих проєкту

У вікні термінала увійдіть до системи від імені користувача, якого ви використаєте для компіляції програмного забезпечення KDE, і виконайте команду:

% kdesrc-build --metadata-only

Ця команда налаштує каталог з початковими кодами і з'єднає його зі сховищами Git KDE для отримання бази даних сховищ git та бази метаданих залежностей без компіляції чи внесення змін до коду. Корисно віддати цю команду окремо, оскільки ці метадані корисні для виконання інших команд kdesrc-build.

Попередній перегляд того, що трапиться, якщо запустити kdesrc-build

Якщо встановлено метадані проєкту, ви можете попередньо переглянути дії, які буде виконано kdesrc-build після запуску програми. Зробити це можна за допомогою параметра рядка команди --pretend.

% ./kdesrc-build --pretend

Ви маєте побачити повідомлення щодо того, що певні пакунки успішно зібрано (хоча насправді нічого не було зібрано). Якщо не буде показано повідомлення про якісь значні проблеми, ви зможете перейти до безпосереднього запуску скрипту для збирання.

% kdesrc-build

Ця команда призведе до отримання відповідного початкового коду та збирання, встановлення кожного модуля за порядком. Зрештою, ви маєте побачити виведені дані, подібні до даних у розділі Приклад 2.2, «Приклад даних, виведених під час запуску kdesrc-build»:

Приклад 2.2. Приклад даних, виведених під час запуску kdesrc-build

% kdesrc-build
Updating kde-build-metadata (to branch master)
Updating sysadmin-repo-metadata (to branch master)

Building libdbusmenu-qt (1/200)
        No changes to libdbusmenu-qt source, proceeding to build.
        Compiling... succeeded (after 0 seconds)
        Installing.. succeeded (after 0 seconds)

Building taglib (2/200)
        Updating taglib (to branch master)
        Source update complete for taglib: 68 files affected.
        Compiling... succeeded (after 0 seconds)
        Installing.. succeeded (after 0 seconds)

Building extra-cmake-modules from <module-set at line 32> (3/200)
        Updating extra-cmake-modules (to branch master)
        Source update complete for extra-cmake-modules: 2 files affected.
        Compiling... succeeded (after 0 seconds)
        Installing.. succeeded (after 0 seconds)

        ...

Building kdevelop from kdev (200/200)
        Updating kdevelop (to branch master)
        Source update complete for kdevelop: 29 files affected.
        Compiling... succeeded (after 1 minute, and 34 seconds)
        Installing.. succeeded (after 2 seconds)

<<<  PACKAGES SUCCESSFULLY BUILT  >>>
Built 200 modules

Your logs are saved in /home/kde-src/kdesrc/log/2018-01-20-07

Усування проблем під час збирання

Залежно від кількості модулів, які ви вибрали для отримання, може так статися, що kdesrc-build не зможе з першого разу зібрати програмне забезпечення KDE. Але вам не слід впадати у відчай!

kdesrc-build записує до журналу дані, виведені всіма виконаними скриптом командами. Типово, файли журналу зберігаються у теці ~/kdesrc/log. Щоб дізнатися про причину помилки для модуля у останній команді kdesrc-build, зазвичай, досить зазирнути до файла ~/kdesrc/log/latest/назва модуля/error.log.

Підказка

Ймовірно, найшвидшим способом виявлення повідомлення про помилку, що призвела до неможливості збирання модуля, є пошук від кінця файла без врахування регістру слова error. Після виявлення такого рядка пошукайте інші повідомлення щодо помилок поряд з ним. На джерело проблем має вказати перше повідомлення про помилку у виявленій групі.

У цьому файлі ви знайдете повідомлення про помилку, яка призвела до невдалої спроби збирання модуля. Якщо у нижній частині цього файла ви бачите повідомлення про те, що не вдалося знайти певні пакунки, спробуйте встановити пакунки (зокрема відповідні пакунки -dev) перед повторним запуском kdesrc-build, і передайте kdesrc-build параметр --reconfigure після встановлення пакунків, яких не вистачає.

Або, якщо помилка є помилкою збирання (повідомлення про синтаксичні помилки, помилки щодо некоректного прототипу («incorrect prototype»), повідомлення про невідомий тип («unknown type») тощо), ймовірно, що помилку пов’язано з вадою вихідних кодів KDE, яку, як ми сподіваємося, буде усунуто протягом декількох днів. Якщо цю помилку не буде усунуто протягом цього часу, не вагайтеся і напишіть листа до списку листування (можливо, вам доведеться оформити підписку на цей список листування), щоб повідомити розробникам про невдалу спробу збирання.

Ви можете знайти приклади помилок і знайти способи їх усування, а також загальні підказки та стратегії збирання програмного забезпечення KDE на сторінці покрокових настанов зі збирання KDE 4.

З іншого боку, якщо все гаразд, у вашій системі встановлено нове KDE. Тепер його слід запустити. Опис потрібних для цього дій наведено далі, у розділі «Налаштовування середовища на запуск зібраного стільничного середовища Плазми KDE».

Примітка

Для отримання докладніших відомостей щодо можливостей журналювання kdesrc-build, будь ласка, зверніться до розділу «Запис журналів збирання kdesrc-build».