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

    From KDE UserBase Wiki
    (Importing a new version from external source)
    (Importing a new version from external source)
    Line 38: Line 38:
    {{Note_(uk)|1=Під час оброби ви можете побачити повідомлення щодо помилки: «Вам слід вказати коректне розташування проекту». Можете не зважати на це повідомлення.}}
    {{Note_(uk)|1=Під час оброби ви можете побачити повідомлення щодо помилки: «Вам слід вказати коректне розташування проекту». Можете не зважати на це повідомлення.}}


    * 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>
    * Середовище попросить вас вибрати файл проекту '''KDevelop''' у каталозі з кодом. Оскільки такого файла, ймовірно, у вас ще немає, просто натисніть кнопку <menuchoice>Далі</menuchoice>.


    * Hit <menuchoice>Next</menuchoice> again
    * Hit <menuchoice>Next</menuchoice> again

    Revision as of 14:05, 9 September 2017

    Сеанси і проекти: основи 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 у каталозі з кодом. Оскільки такого файла, ймовірно, у вас ще немає, просто натисніть кнопку Далі.
    • Hit Next again
    • KDevelop will then ask you to choose a project manager. If this project uses standard Unix make files, choose the custom makefile project manager
    • 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 that shows how long this process has come along. (If you have several processor cores, you can accelerate this process by going to the Settings -> Configure KDevelop menu item, then selecting Background parser on the left, and increasing the number of threads for background parsing on the right.)

    Option 2: Importing a project that is already on your hard drive

    Alternatively, if the project you want to work with already exists on your hard drive (for example, because you have downloaded it as a tar file from an FTP server, because you already checked out a version of the project from a version control system, or because it is your own project that exists only on your own hard drive), then use Projects -> Open/Import project and in the dialog box choose the directory in which your project resides.

    Setting up an application as a second project

    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.

    Creating projects from scratch

    There is of course also the possibility that you want to start a new project from scratch. This can be done using the Projects -> New from Template menu item, which presents you with a template selection dialog. Some project templates are provided with KDevelop, but even more are available by installing the KAppTemplate application. Choose the project type and programming language from the dialog, enter a name and location for you project, and click Next.

    The second page of the dialog allows you to set up a version control system. Choose the system you wish the use, and fill in the system-specific configuration if needed. If you do not wish to use a version control system, or want to set it up manually later, choose None. When you are happy with your choice, press Finish.

    Your project is now created, so you can try building or installing it. Some templates will include comments within the code, or even a separate README file, and it is recommended that you read those first. Then, you can start working on your project, by adding whatever features you want.