KDevelop4/Manual/Sessions and projects/uk: Difference between revisions

Latest revision as of 13:53, 13 July 2019

Other languages:

Deutsch
English
dansk
русский
українська

Сеанси і проекти: основи KDevelop

У цьому розділі ми оглянемо деякі питання щодо термінології, використаної у KDevelop, та структури роботи у середовищі. Зокрема, ми поговоримо про поняття сеанси і проекти та пояснимо, як налаштовувати проекти, над якими ви маєте намір працювати у KDevelop.

Термінологія

У KDevelop використано поняття сеанси та проекти. У сеансі містяться всі проекти, чимось пов’язані між собою. У наведених нижче прикладах ми припускаємо, що ви є розробником одночасно бібліотеки та програми, яка використовує цю бібліотеку. Прикладом подібної схеми розробки є бібліотеки KDE (бібліотека) і саме середовище KDevelop (програма). Інший приклад: ви є розробником ядра Linux і одночасно працюєте над драйвером пристрою для Linux, який ще не включено до ядра.

У останньому прикладі у нас був би сеанс KDevelop з двома проектами: ядром Linux і драйвером пристрою. Варто згрупувати ці проекти у одному сеансі (замість двох сеансів для кожного окремого проекту), оскільки корисно бачити функції та структури даних ядра у KDevelop, коли ви пишете код драйвера: ви, наприклад, зможете скористатися автодоповненням назв функцій та змінних ядра або переглянути документацію з функції ядра під час розробки драйвера пристрою.

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

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

Налаштування сеансу та імпортування вже створеного проекту

Зупинимося на прикладі з ядром Linux і драйвером пристрою. Вам слід буде замінити назви бібліотек та проектів вашими назвами бібліотек і проектів, щоб реалізувати наші приклади у вашій системі. Щоб створити сеанс, який міститиме два наших проекти, скористаємося пунктом меню Сеанс -> Почати новий сеанс, розташованим вгорі ліворуч (або якщо ви вперше запустили KDevelop, просто скористайтеся типовим сеансом, його буде відкрито порожнім).
Далі нам потрібно заповнити сеанс проектами, які у нашому прикладі будуть вже створеними раніше проектами (створення проектів «з нуля» обговорено у іншому розділі цього підручника). Виконати заповнення можна у два способи. Один з них можна застосувати до проектів, дані яких вже зберігаються на жорсткому диску вашого комп’ютера. Іншим можна скористатися для отримання даних проекту з сервера.

1. Імпортування даних проекту з сервера системи керування версіями

Припустімо, що дані потрібного нам проекту, — скажімо, ядра Linux, — зберігаються у якійсь системі керування версіями, але у вас ще немає копії сховища коду на жорсткому диску комп’ютера. У такому разі, відкрийте меню Проект для створення проекту ядра Linux у межах поточного сеансу і виконайте такі дії:

Скористайтеся пунктом меню Проекти -> Звантажити проект для імпортування даних проекту.

Середовище запропонує вам розпочати новий проект у межах поточного сеансу, залежно від походження коду: ви можете просто вказати KDevelop вже створений каталог з кодом, ви також можете наказати KDevelop отримати код зі сховища коду. Припускаємо, що у вас ще немає копії коду зі сховища системи керування версіями.

Вам слід виконати такі дії:

- У діалоговому вікні під написом Вибір джерела виберіть Subversion, Git або один з інших варіантів.
- Виберіть робочий каталог призначення, до якого слід звантажити код проекту.
- Виберіть адресу розташування сховища з кодом проекту.
- Натисніть кнопку Отримати. Отримання кодів може бути доволі тривалою справою. Тривалість виконання цієї дії залежить від ширини каналу вашого з’єднання з інтернетом та розміру проекту. На жаль, у KDevelop 4.2.x панель поступу не є надто інформативною, але ви можете спостерігати за поступом з командного рядка за допомогою команди
```
du -sk /шлях/до/проекту/KDevelop
```
  (буде показано об’єм отриманих даних).

Зауваження

Розробникам відомо про проблему зі смужкою поступу: KDevelop, вада 256832.

Зауваження

Під час оброби ви можете побачити повідомлення щодо помилки: «Вам слід вказати коректне розташування проекту». Можете не зважати на це повідомлення.

Середовище попросить вас вибрати файл проекту KDevelop у каталозі з кодом. Оскільки такого файла, ймовірно, у вас ще немає, просто натисніть кнопку Далі.

Ще раз натисніть кнопку Далі.

KDevelop попросить вас визначитися зі способом керування проектом. Якщо у проекті використано стандартні файли make Unix, виберіть нетиповий спосіб керування проектом за допомогою файла makefile.

KDevelop виконає обробку даних проекту. Знову ж таки, ця дія може бути доволі тривалою, оскільки доведеться виконати обробку всіх файлів, створити покажчик класів тощо. У нижній правій частині основного вікна буде показано панель поступу з даними щодо поступу виконання обробки. (Якщо у вашого процесора декілька ядер, ви можете пришвидшити процедуру: скористайтеся пунктом меню Параметри -> Налаштувати KDevelop, виберіть пункт Інструмент фонової обробки на панелі ліворуч і збільшіть кількість потоків обробки у полі праворуч.)

2. Імпортування проекту, дані якого вже зберігаються на жорсткому диску вашого комп’ютера

Якщо ж проєкт, над яким ви бажаєте працювати, вже зберігається на жорсткому диску вашого комп’ютера (наприклад, ви отримали дані проєкту у архіві з сервера FTP, скопіювали зі сховища керування версіями проєкту або ви працюєте над власним проєктом, дані якого зберігаються лише на жорсткому диску вашого комп’ютера), скористайтеся пунктом меню Проєкти -> Відкрити/Імпортувати проєкт і у діалоговому вікні вкажіть каталог, у якому зберігаються дані вашого проєкту. Якщо у проєкті вже є makefile (або CMakeList.txt), перейдіть до каталогу, у якому зберігається проєкт і виберіть makefile; програма покаже вам наступне діалогове вікно, за допомогою якого ви зможете змінити назву проєкту (з типової, яку буде визначено на основі назви теки, у якій зберігається makefile). Для використання makefile слід вибрати системою збирання «Нетиповий проєкт Makefile». Якщо маємо справу зі makefile із декількома цілями, слід вибрати пункт меню Виконання->Налаштувати запуски..., перейти на сторінку «Загальне» і натиснути кнопку +Додати новий, вибрати «Компільований виконуваний файл», позначити пункт «Виконуваний файл» і ввести повну назву виконуваного файла до відповідного поля.

Налаштування програми як другого проекту

Наступним кроком буде, очевидно, налаштування інших проектів у тому самому сеансі. У нашому раніше наведеному прикладі другим проектом буде драйвер ядра. Додати новий проект можна знову виконавши вказані вище кроки.

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

Створення проектів «з нуля»

Звичайно ж, ви можете скористатися новим проектом. Створити новий проект можна за допомогою пункту меню Проекти -> Створити за шаблоном, який відкриває діалогове вікно вибору шаблона. Деякі з шаблонів встановлюються з основним пакунком KDevelop, інші ж можна встановити разом з програмою KAppTemplate. Виберіть у діалоговому вікні тип проекту і мову програмування, вкажіть назву і розташування вашого проекту і натисніть кнопку Далі.

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

Тепер ваш проект створено, ви можете спробувати зібрати і встановити його. У деяких шаблонах передбачено коментарі у коді або навіть окремий файл README. Рекомендуємо ознайомитися зі вмістом такого файла до того, як буде розпочато подальшу розробку. Після ознайомлення з усіма довідковими матеріалами можна розпочати роботу над проектом і додавання потрібних вам можливостей.

@@ Line 3: / Line 3: @@
 == Сеанси і проекти: основи KDevelop ==
-In this section, we will go over some of the terminology of how '''KDevelop''' sees the world and how it structures work. In particular, we introduce the concept of '''sessions''' and '''projects''' and explain how you can set up the projects you want to work on in '''KDevelop'''.
+У цьому розділі ми оглянемо деякі питання щодо термінології, використаної у '''KDevelop''', та структури роботи у середовищі. Зокрема, ми поговоримо про поняття ''сеанси'' і ''проекти'' та пояснимо, як налаштовувати проекти, над якими ви маєте намір працювати у '''KDevelop'''.
 <span id="Terminology"></span>
 === Термінологія ===
-'''KDevelop''' has the concept of '''sessions''' and '''projects'''. A session contains all projects that have something to do with each other. For the examples that follow, assume you are the developer of both a library and an application that uses it. You can think of the core KDE libraries as the former and '''KDevelop''' as the latter. Another example: Let's say you are a Linux kernel hacker but you are also working on a device driver for Linux that hasn't been merged into the kernel tree yet.
+У '''KDevelop''' використано поняття ''сеанси'' та ''проекти''. У сеансі містяться всі проекти, чимось пов’язані між собою. У наведених нижче прикладах ми припускаємо, що ви є розробником одночасно бібліотеки та програми, яка використовує цю бібліотеку. Прикладом подібної схеми розробки є бібліотеки KDE
+(бібліотека) і саме середовище '''KDevelop'''  (програма). Інший приклад: ви є розробником ядра Linux і одночасно працюєте над драйвером пристрою для Linux, який ще не включено до ядра.
-So taking the latter as an example, you would have a session in '''KDevelop''' that has two projects: the Linux kernel and the device driver. You will want to group them into a single session (rather than having two sessions with a single project each) because it will be useful to be able to see the kernel functions and data structures in '''KDevelop''' whenever you write source code for the driver &mdash; for example so that you can get kernel function and variable names auto-expanded, or so that you can see kernel function documentation while hacking on the device driver.
+У останньому прикладі у нас був би сеанс '''KDevelop''' з двома проектами: ядром Linux і драйвером пристрою. Варто згрупувати ці проекти у одному сеансі (замість двох сеансів для кожного окремого проекту), оскільки корисно бачити функції та структури даних ядра у '''KDevelop''', коли ви пишете код драйвера: ви, наприклад, зможете скористатися автодоповненням назв функцій та змінних ядра або переглянути документацію з функції ядра під час розробки драйвера пристрою.
-Now imagine you also happen to be a KDE developer. Then you would have a second session that contains KDE as a project. You could in principle have just one session for all of this, but there is no real reason for this: in your KDE work, you don't need to access kernel or device driver functions; and you don't want KDE class names autoexpanded while working working on the Linux kernel. Finally, building some of the KDE libraries is independent of re-compiling the Linux kernel (whereas whenever you compile the device driver it would also be good to re-compile the Linux kernel if some of the kernel header files have changed).
+Припустімо тепер, що ви є одним з розробників KDE. Тоді у вас буде інший сеанс, який міститиме проект KDE. Звичайно, ви можете створити єдиний сеанс для всіх ваших проектів, але для цього немає ніяких причин: для вашої роботи у KDE вам не потрібен доступ до функцій ядра або драйверів пристроїв, вам не потрібне автоматичне доповнення назв класів KDE під час роботи над ядром Linux. Нарешті, збирання бібліотек KDE не пов’язане зі збиранням ядра Linux (з іншого боку збирання драйвера пристрою часто пов’язане зі збиранням ядра Linux, якщо було внесено зміни до файлів заголовків ядра).
-Finally, another use for sessions is if you work both on the current development version of a project, as well as on a branch: in that case, you don't want '''KDevelop''' to confuse classes that belong to mainline and the branch, so you'd have two sessions, with the same set of projects but from different directories (corresponding to different development branches).
+Нарешті, ще одним з випадків використання сеансів є одночасна робота над експериментальною версією проекту та його стабільною версією: у цьому випадку небажаним буде конфлікт між класами, які належать різним гілкам проекту у '''KDevelop'''. Отже, варто створити два сеанси з однаковим набором проектів, але різними каталогами зберігання (відповідно до гілок розробки).
 <span id="Setting up a session and importing an existing project"></span>
 === Налаштування сеансу та імпортування вже створеного проекту ===
-Let's stick with the Linux kernel and device driver example &mdash; you may want to substitute your own set of libraries or projects for these two examples. To create a new session that contains these two projects go to the <menuchoice>Session -> Start new session</menuchoice> menu at the top left (or, if this is the first time you use '''KDevelop''': simply use the default session you get on first use, which is empty). Next, go to the <menuchoice>Project</menuchoice> menu to create the Linux kernel as a project inside this session. To to this, follow these steps:
+Зупинимося на прикладі з ядром Linux і драйвером пристрою. Вам слід буде замінити назви бібліотек та проектів вашими назвами бібліотек і проектів, щоб реалізувати наші приклади у вашій системі. Щоб створити сеанс, який міститиме два наших проекти, скористаємося пунктом меню <menuchoice>Сеанс -> Почати новий сеанс</menuchoice>, розташованим вгорі ліворуч (або якщо ви вперше запустили '''KDevelop''', просто скористайтеся типовим сеансом, його буде відкрито порожнім).<br />
+Далі нам потрібно заповнити сеанс проектами, які у нашому прикладі будуть вже створеними раніше проектами (створення проектів «з нуля» обговорено у іншому розділі цього підручника). Виконати заповнення можна у два способи. Один з них можна застосувати до проектів, дані яких вже зберігаються на жорсткому диску вашого комп’ютера. Іншим можна скористатися для отримання даних проекту з сервера.
-<ul>
+==== 1. Імпортування даних проекту з сервера системи керування версіями ====
-<li> Go to <menuchoice>Projects -> Fetch project</menuchoice> to import a project
-<li> You then have multiple options to start a new project in the current session, depending on where the source files should come from: You can just point '''KDevelop''' at an existing directory, or you can ask '''KDevelop''' to get the sources from a repository. Let's look at these options in turns:
+Припустімо, що дані потрібного нам проекту, — скажімо, ядра Linux, — зберігаються у якійсь системі керування версіями, але у вас ще немає копії сховища коду на жорсткому диску комп’ютера. У такому разі, відкрийте меню <menuchoice>Проект</menuchoice> для створення проекту ядра Linux у межах поточного сеансу і виконайте такі дії:
-<li> If you want to work with a project that's already on your hard drive then just select as source <menuchoice>Do not obtain</menuchoice> and choose the <menuchoice>Working directory</menuchoice> as the directory in which your project resides. This could be a directory into which you unpackaged a tar file that you downloaded, or it could be a directory into which you checked out a version of the project using a version control system (e.g. git or subversion).
-<li> Alternatively, assuming you wanted to work with the current development sources of deal.II and don't already have a version checked out: <ul>
+* Скористайтеся пунктом меню <menuchoice>Проекти -> Звантажити проект</menuchoice> для імпортування даних проекту.
-  <li> In the dialog box, under <menuchoice>Select the source</menuchoice>, choose to use <menuchoice>Subversion</menuchoice>, <menuchoice>Git</menuchoice>, or one of the other choices
-  <li> Choose a working directory as destination into which the sources should be checked out
+* Середовище запропонує вам розпочати новий проект у межах поточного сеансу, залежно від походження коду: ви можете просто вказати '''KDevelop''' вже створений каталог з кодом, ви також можете наказати '''KDevelop''' отримати код зі сховища коду. Припускаємо, що у вас ще немає копії коду зі сховища системи керування версіями.
-  <li> Choose an URL for the location of the repository where the source files can be obtained
-  <li> Hit <menuchoice>Get</menuchoice>. This can take quite a long while; depending on the speed of your connection and the size of the project. Unfortunately, in '''KDevelop''' 4.2.x the progress bar does not actually show anything, but you can track progress by periodically looking at the output of the command line command <code>du -sk /path/to/KDevelop/project</code> to see how much data has already been downloaded.
+Вам слід виконати такі дії:
-{{Note|1=The problem with the progress bar has been reported as [http://bugs.kde.org/show_bug.cgi?id=256832 KDevelop bug 256832].}}
+** У діалоговому вікні під написом <menuchoice>Вибір джерела</menuchoice> виберіть <menuchoice>Subversion</menuchoice>, <menuchoice>Git</menuchoice> або один з інших варіантів.
-{{Note|1=In this process, I also get the error message ''You need to specify a valid location for the project'' which can be safely ignored.}}</ul>
+** Виберіть робочий каталог призначення, до якого слід звантажити код проекту.
-<li> It asks you to select a '''KDevelop''' project file in this directory. Since you probably don't have one yet, simply hit <menuchoice>Next</menuchoice>
+** Виберіть адресу розташування сховища з кодом проекту.
-<li> Hit <menuchoice>Next</menuchoice> again
+** Натисніть кнопку <menuchoice>Отримати</menuchoice>. Отримання кодів може бути доволі тривалою справою. Тривалість виконання цієї дії залежить від ширини каналу вашого з’єднання з інтернетом та розміру проекту. На жаль, у '''KDevelop''' 4.2.x панель поступу не є надто інформативною, але ви можете спостерігати за поступом з командного рядка за допомогою команди {{Input|1=du -sk /шлях/до/проекту/KDevelop}} (буде показано об’єм отриманих даних).
-<li> '''KDevelop''' will then ask you to choose a project manager. If this project uses standard Unix make files, choose the custom makefile project manager
-<li> '''KDevelop''' will then start to parse the entire project. Again, it will take quite a while to go through all files and index classes etc. At the bottom right of the main window, there is a progress bar on the bottom right that shows how long this process has come along. (If you have several processor cores, you can accelerate this process by going to the <menuchoice>Settings -> Configure KDevelop</menuchoice> menu item, then selecting <menuchoice>Background parser</menuchoice> on the left, and increasing the number of threads for background parsing on the right.)
+{{Note_(uk)|1=Розробникам відомо про проблему зі смужкою поступу: [http://bugs.kde.org/show_bug.cgi?id=256832 KDevelop, вада 256832].}}
-</ul>
+{{Note_(uk)|1=Під час оброби ви можете побачити повідомлення щодо помилки: «Вам слід вказати коректне розташування проекту». Можете не зважати на це повідомлення.}}
+* Середовище попросить вас вибрати файл проекту '''KDevelop''' у каталозі з кодом. Оскільки такого файла, ймовірно, у вас ще немає, просто натисніть кнопку <menuchoice>Далі</menuchoice>.
+* Ще раз натисніть кнопку <menuchoice>Далі</menuchoice>.
+* '''KDevelop''' попросить вас визначитися зі способом керування проектом. Якщо у проекті використано стандартні файли make Unix, виберіть нетиповий спосіб керування проектом за допомогою файла makefile.
+* '''KDevelop''' виконає обробку даних проекту. Знову ж таки, ця дія може бути доволі тривалою, оскільки доведеться виконати обробку всіх файлів, створити покажчик класів тощо. У нижній правій частині основного вікна буде показано панель поступу з даними щодо поступу виконання обробки. (Якщо у вашого процесора декілька ядер, ви можете пришвидшити процедуру: скористайтеся пунктом меню <menuchoice>Параметри -> Налаштувати KDevelop</menuchoice>, виберіть пункт <menuchoice>Інструмент фонової обробки</menuchoice> на панелі ліворуч і збільшіть кількість потоків обробки у полі праворуч.)
+==== 2. Імпортування проекту, дані якого вже зберігаються на жорсткому диску вашого комп’ютера ====
+Якщо ж проєкт, над яким ви бажаєте працювати, вже зберігається на жорсткому диску вашого комп’ютера (наприклад, ви отримали дані проєкту у архіві з сервера FTP, скопіювали зі сховища керування версіями проєкту або ви працюєте над власним проєктом, дані якого зберігаються ''лише'' на жорсткому диску вашого комп’ютера), скористайтеся пунктом меню <menuchoice>Проєкти -> Відкрити/Імпортувати проєкт</menuchoice> і у діалоговому вікні вкажіть каталог, у якому зберігаються дані вашого проєкту. Якщо у проєкті вже є makefile (або CMakeList.txt), перейдіть до каталогу, у якому зберігається проєкт і виберіть makefile; програма покаже вам наступне діалогове вікно, за допомогою якого ви зможете змінити назву проєкту (з типової, яку буде визначено на основі назви теки, у якій зберігається makefile). Для використання makefile слід вибрати системою збирання «Нетиповий проєкт Makefile». Якщо маємо справу зі makefile із декількома цілями, слід вибрати пункт меню <menuchoice>Виконання->Налаштувати запуски...</menuchoice>, перейти на сторінку «Загальне» і натиснути кнопку +Додати новий, вибрати «Компільований виконуваний файл», позначити пункт «Виконуваний файл» і ввести повну назву виконуваного файла до відповідного поля.
 <span id="Setting up an application as a second project"></span>
 === Налаштування програми як другого проекту ===
-The next thing you want to do is set up other projects in the
+Наступним кроком буде, очевидно, налаштування інших проектів у тому самому сеансі. У нашому раніше наведеному прикладі другим проектом буде драйвер ядра. Додати новий проект можна знову виконавши вказані вище кроки.
-same session. In the example above, you would want to add the device driver as the second project, which you can do using exactly the same steps.
-If you have multiple applications or libraries, simply repeat the steps to add
+Якщо ви розробляєте одночасно декілька програм або бібліотек, просто повторіть вказані вище кроки для додавання цих проектів до вашого сеансу.
-more and more projects to your session.
 <span id="Creating projects from scratch"></span>
 === Створення проектів «з нуля» ===
-There is of course also the possibility that you want to start a new project from scratch. This can be done using the <menuchoice>Projects -> New from template</menuchoice> menu item. The details of what options this offers to you are described elsewhere in this manual.
+Звичайно ж, ви можете скористатися новим проектом. Створити новий проект можна за допомогою пункту меню <menuchoice>Проекти -> Створити за шаблоном</menuchoice>, який відкриває діалогове вікно вибору шаблона. Деякі з шаблонів встановлюються з основним пакунком '''KDevelop''', інші ж можна встановити разом з програмою '''KAppTemplate'''. Виберіть у діалоговому вікні тип проекту і мову програмування, вкажіть назву і розташування вашого проекту і натисніть кнопку <menuchoice>Далі</menuchoice>.
+[[Image:kdevelop-project-dialog.png|thumb|500px|center]]
+За допомогою другої сторінки діалогового вікна ви можете налаштувати систему керування версіями. Виберіть бажану для вас систему і заповніть відповідні поля параметрів. Якщо ви не хочете користуватися системою керування версіями або хочете визначити її параметри пізніше, виберіть пункт <menuchoice>Немає</menuchoice>. Щойно визначення відповідних параметрів буде завершено, можете натиснути кнопку <menuchoice>Завершити</menuchoice>.
+Тепер ваш проект створено, ви можете спробувати зібрати і встановити його. У деяких шаблонах передбачено коментарі у коді або навіть окремий файл README. Рекомендуємо ознайомитися зі вмістом такого файла до того, як буде розпочато подальшу розробку. Після ознайомлення з усіма довідковими матеріалами можна розпочати роботу над проектом і додавання потрібних вам можливостей.
 {{Prevnext2
-| prevpage=Special:MyLanguage/Kdevelop4/Manual/What_is_KDevelop? | nextpage=Special:MyLanguage/KDevelop4/Manual/Working_with_source_code
+| prevpage=Special:MyLanguage/Kdevelop4/Manual/Meet_KDevelop | nextpage=Special:MyLanguage/KDevelop4/Manual/Working_with_source_code
-| prevtext=Для чого призначено KDevelop? | nexttext=Робота з кодом програм
+| prevtext=Початкові зауваження щодо KDevelop | nexttext=Робота з кодом програм
 | index=Special:MyLanguage/KDevelop4/Manual | indextext=Повернутися до меню
 }}
 [[Category:Розробка/uk]]