KDevelop5/Manual/Debugging programs/uk: Difference between revisions

    From KDE UserBase Wiki
    (Importing a new version from external source)
     
    (Importing a new version from external source)
    (16 intermediate revisions by the same user not shown)
    Line 1: Line 1:
    <languages />
    <languages />


    == Debugging programs in KDevelop ==
    == Зневаджування програм у KDevelop ==
    <span id="Running a program in the debugger"></span>
    <span id="Running a program in the debugger"></span>
    === Running a program in the debugger ===
    === Запуск програми під керуванням програми для зневаджування ===


    Once you have a launch configured (see [[Special:myLanguage/KDevelop5/Manual/Running programs|Running programs]]), you can also run it in a debugger: Select the menu item <menuchoice>Run -> Debug Launch</menuchoice>, or hit <keycap>F9</keycap>. If you are familiar with '''gdb''', the effect is the same as starting '''gdb''' with the executable specified in the launch configuration and then saying <code>Run</code>. This means that if the program calls <code>abort()</code> somewhere (e.g. when you run onto a failing assertion) or if there is a segmentation fault, then the debugger will stop. On the other hand, if the program runs to the end (with or without doing the right thing) then the debugger will not stop by itself before the program is finished. In the latter case, you will want to set a breakpoint on all those lines of your code base where you want the debugger to stop before you run the debug launch. You can do that by moving the cursor on such a line and selecting the menu item <menuchoice>Run -> Toggle breakpoint</menuchoice>, or right-clicking on a line and selecting <menuchoice>Toggle Breakpoint</menuchoice> from the context menu.
    Після того, як запуск програми буде налаштовано (див. [[Special:myLanguage/KDevelop5/Manual/Running programs|Запуск програм]]), ви зможете запускати програму під керуванням інструмента зневаджування: скористайтеся пунктом меню <menuchoice>Виконання -> Зневаджувальний запуск</menuchoice> або натисніть клавішу <keycap>F9</keycap>. Якщо ви знайомі з роботою '''gdb''', результат буде той самий, що і після запуску '''gdb''' з вказаним виконуваним файлом у налаштуваннях запуску з наступною командою <code>Run</code>. Це означає, що якщо програмою буде десь викликано <code>abort()</code> (наприклад, якщо оператором контролю буде виявлено помилку) або якщо буде виявлено помилку сегментування, інструмент зневаджування зупинить роботу програми. З іншого боку, якщо програма зможе виконати роботу до кінця (правильно чи неправильно), інструмент зневаджування не зупинятиме її роботу, аж доки ця робота не завершиться сама. У такому разі вам можуть знадобитися встановлені ще до запуску програми точки зупину у всіх рядках коду, де інструмент зневаджування має зупиняти роботу програми. Встановити такі точки зупину можна встановленням курсора у відповідному рядку з наступним вибором пункту меню <menuchoice>Виконання -> Встановити/зняти точку зупину</menuchoice> або використанням пункту контекстного меню (викликається клацанням правою кнопкою миші) <menuchoice>Встановити/зняти точку зупину</menuchoice>.


    [[Image:kdevelop-4.png|center|thumb|550px]]
    [[Image:kdevelop-4.png|center|thumb|550px]]


    Running a program in the debugger will put '''KDevelop''' in a different mode: it will replace all the "Tool" buttons on the perimeter of the main window by ones that are appropriate for debugging, rather than for editing. You can see which of the mode you are in by looking at the top right of the window: there are tabs named <menuchoice>Review</menuchoice>, <menuchoice>Debug</menuchoice>, and <menuchoice>Code</menuchoice>; clicking on them allows you to switch back and forth between the three modes; each mode has a set of tool views of its own, which you can configure in the same way as we configured the <menuchoice>Code</menuchoice> tools in the section [[KDevelop5/Manual/Working_with_source_code#Tools and views|Tools and views]].
    Запуск програми у зневаднику переведе '''KDevelop''' у інший режим: всі кнопки інструментів на периметрі головного вікна програми буде замінено на відповідні кнопки зневаджування, а не редагування. Визначити режим, у якому працює програма можна за верхньою правою частиною вікна: там ви побачите вкладки з назвами <menuchoice>Перегляд</menuchoice>, <menuchoice>Зневаджування</menuchoice> та <menuchoice>Код</menuchoice>. Натискання заголовків цих вкладок надає змогу перемикатися між трьома режимами. У кожного з режимів є власний набір інструментів, налаштувати їхній перелік можна у такий само спосіб, у який ми налаштовували інструменти режиму <menuchoice>Код</menuchoice> у розділі [[KDevelop5/Manual/Working_with_source_code#Tools and views|Інструменти та панелі перегляду]].


    Once the debugger stops (at a breakpoint, or a point where <code>abort()</code> is called) you can inspect a variety of information about your program. For example, in the image above, we have selected the <menuchoice>Frame Stack</menuchoice> tool at the bottom (roughly equivalent to '''gdb's''' "backtrace" and "info threads" commands) that shows the various threads that are currently running in your program at the left (here a total of 8) and how execution got to the current stopping point at the right (here: <code>main()</code> called <code>run()</code>; the list would be longer had we stopped in a function called by <code>run()</code> itself). On the left, we can inspect local variables including the current object (the object pointed to by the <code>this</code> variable).
    Після зупинки інструмента зневаджування (у точці зупину або у точці виклику <code>abort()</code>) ви зможете вивчити різноманітні дані щодо роботи програми. Наприклад, на наведеному вище зображенні нами вибрано інструмент <menuchoice>Стек викликів</menuchoice> у нижній частині (приблизний еквівалент команд "backtrace" та "info threads" у  '''gdb'''), отже показано список запущених потоків виконання ліворуч (у нашому прикладі таких потоків 8) та спосіб переходу до поточної точки зупину праворуч (у нашому прикладі <code>main()</code> викликано <code>run()</code>; список був би довшим, якби ми зупинилися у функції, викликаній з <code>run()</code>). Ліворуч можна бачити локальні змінні, зокрема поточний об’єкт (об’єкт, на який вказує змінна <code>this</code>).


    From here, there are various possibilities you can do: You can execute the current line (<keycap>F10</keycap>, '''gdb's''' "next" command), step into the functions (<keycap>F11</keycap>, '''gdb's''' "step" command), or run to the end of the function (<keycap>F12</keycap>, '''gdb's''' "finish" command). At every stage, '''KDevelop''' updates the variables shown at the left to their current values. You can also hover the mouse over a symbol in your code, e.g. a variable; '''KDevelop''' will then show the current value of that symbol and offer to stop the program during execution the next time this variable's value changes. If you know '''gdb''', you can also click on the <menuchoice>GDB</menuchoice> tool button at the bottom and have the possibility to enter '''gdb''' commands, for example in order to change the value of a variable (for which there doesn't currently seem to be another way).
    Після зупинки ви можете діяти у декілька способів: наказати виконати поточний рядок (<keycap>F10</keycap>, команда «next» '''gdb'''), увійти до функції (<keycap>F11</keycap>, команда «step» у '''gdb''') або виконати інструкції до кінця функції (<keycap>F12</keycap>, команда «finish» '''gdb'''). На кожному з етапів виконання '''KDevelop''' оновлюватиме значення змінних, показані ліворуч. Ви також можете просто навести вказівник миші на частину коду, наприклад, назву змінної, і '''KDevelop''' покаже поточне значення та запропонує зупинити виконання програми під час наступної зміни значення змінної. Якщо ви знайомі з '''gdb''', ви також можете натиснути кнопку інструмента <menuchoice>GDB</menuchoice> у нижній частині вікна і отримати змогу вводити команди '''gdb''' безпосередньо, наприклад, для того, щоб змінити значення змінної (у поточній версії середовища, здається, не передбачено іншого способу).
    <span id="Attaching the debugger to a running process"></span>
    <span id="Attaching the debugger to a running process"></span>
    === Attaching the debugger to a running process ===
    === Приєднання програми для зневаджування до запущеного процесу ===


    [[Image:kdevelop-9.png|center|thumb|300px]]
    [[Image:kdevelop-9.png|center|thumb|300px]]


    Sometimes, one wants to debug a program that's already running. One scenario for this is debugging parallel programs using [https://computing.llnl.gov/tutorials/mpi/ MPI], or for debugging a long running background process. To do this, go to the menu entry <menuchoice>Run -> Attach to Process</menuchoice>, which will open a window like the one above. You will want to select the program that matches your currently open project in '''KDevelop''' - in my case that would be the step-32 program.  
    Іноді виникає потреба у зневаджуванні програми, яку вже запущено. Одним з випадків такої потреби є зневаджування паралельно запущених за допомогою [https://computing.llnl.gov/tutorials/mpi/ MPI] програм або зневаджування довготривалого фонового процесу. Виконати таке зневаджування можна за допомогою пункту меню <menuchoice>Виконання -> Долучити до процесу</menuchoice>, у відповідь на вибір якого буде відкрито вікно, подібне до наведеного вище. Вам потрібно вибрати програму, яка відповідає поточному відкритому проекту у '''KDevelop''' — у нашому випадку такою програмою буде step-32.  


    This list of programs can be confusing because it is often long as in the case shown here. You can make your life a bit easier by going to the dropdown box at the top right of the window. The default value is <menuchoice>User processes</menuchoice>, i.e. all programs that are run by any of the users currently logged into this machine (if this is your desktop or laptop, you're probably the only such user, apart from root and various service accounts); the list doesn't include processes run by the root user, however. You can limit the list by either choosing <menuchoice>Own processes</menuchoice>, removing all the programs run by other users. Or better still: Select <menuchoice>Programs only</menuchoice>, which removes a lot of processes that are formally running under your name but that you don't usually interact with, such as the window manager, background tasks and so on that are unlikely candidates for debugging.
    Цей список програм може бути доволі довгим, як у нашому прикладі. Ви можете дещо спростити собі роботу за допомогою спадного списку у верхній частині вікна. Типовим пунктом цього списку є <menuchoice>Процеси користувачів</menuchoice>, тобто всі програми, запущені всіма користувачами, які працюють у системі (якщо ви працюєте за власним стаціонарним або портативним комп’ютером, ймовірно, ви є єдиним користувачем, окрім користувача root та різноманітних облікових записів служб); у списку не буде процесів користувача root. Обмежити перелік процесів можна за допомогою пункту <menuchoice>Власні процеси</menuchoice>, його вибір призведе до вилучення зі списку програм, запущених іншими користувачами. Кращим варіантом є вибір пункту <menuchoice>Лише програми</menuchoice>, — зі списку буде вилучено багато процесів, які формально запущено від вашого імені, але які ви власноруч не запускали, зокрема програма для керування вікнами, фонові завдання тощо навряд чи є достойними кандидатами для зневаджування.


    Once you have selected a process, attaching to it will get you into '''KDevelop's''' debug mode, open all the usual debugger tool views and stop the program at the position where it happened to be when you attached to it. You may then want to set breakpoints, viewpoints, or whatever else is necessary and continue program execution by going to the menu item <menuchoice>Run -> Continue</menuchoice>.
    Після вибору процесу, долучення до нього переведе '''KDevelop''' у режим зневаджування, відкриє всі звичайні панелі зневаджування і зупинить програму на рядку, який виконувався під час долучення. На цьому етапі доцільно встановити точки зупину, точки перегляду або налаштувати інші елементи стеження за виконанням, а потім продовжити виконання програми за допомогою пункту меню <menuchoice>Виконання -> Продовжити</menuchoice>.
    <span id="Some useful keyboard shortcuts"></span>
    <span id="Some useful keyboard shortcuts"></span>
    === Some useful keyboard shortcuts ===
    === Деякі корисні клавіатурні скорочення ===


    {| class="tablecenter" style="border:1px solid"
    {| class="tablecenter" style="border:1px solid"
    ! colspan="2" style="background:#ffff99;" | Debugging
    ! colspan="2" style="background:#ffff99;" | Зневаджування
    |-
    |-


    | F10  
    | F10  
    | Step over (gdb's "next")
    | Перейти до наступної інструкції ("next" у gdb)
    |-
    |-


    | F11  
    | F11  
    | Step into (gdb's "step")
    | Увійти у наступну інструкцію ("step" у gdb)
    |-
    |-


    | F12
    | F12
    | Step out of (gdb's "finish")
    | Вийти з інструкції ("finish" у gdb)
    |}
    |}


    {{Prevnext2
    {{Prevnext2
    | prevpage=Special:MyLanguage/KDevelop5/Manual/Running_programs | nextpage=Special:MyLanguage/KDevelop5/Manual/Working_with_version_control_systems
    | prevpage=Special:MyLanguage/KDevelop5/Manual/Running_programs | nextpage=Special:MyLanguage/KDevelop5/Manual/Working_with_version_control_systems
    | prevtext=Running programs | nexttext=Working with version control systems
    | prevtext=Запуск програм | nexttext=Робота з системами керування версіями
    | index=Special:MyLanguage/KDevelop5/Manual | indextext=Back to menu
    | index=Special:MyLanguage/KDevelop5/Manual | indextext=Повернутися до меню
    }}
    }}


    [[Category:Development]]
    [[Category:Розробка/uk]]

    Revision as of 08:18, 1 October 2017

    Other languages:

    Зневаджування програм у KDevelop

    Запуск програми під керуванням програми для зневаджування

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

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

    Після зупинки інструмента зневаджування (у точці зупину або у точці виклику abort()) ви зможете вивчити різноманітні дані щодо роботи програми. Наприклад, на наведеному вище зображенні нами вибрано інструмент Стек викликів у нижній частині (приблизний еквівалент команд "backtrace" та "info threads" у gdb), отже показано список запущених потоків виконання ліворуч (у нашому прикладі таких потоків 8) та спосіб переходу до поточної точки зупину праворуч (у нашому прикладі main() викликано run(); список був би довшим, якби ми зупинилися у функції, викликаній з run()). Ліворуч можна бачити локальні змінні, зокрема поточний об’єкт (об’єкт, на який вказує змінна this).

    Після зупинки ви можете діяти у декілька способів: наказати виконати поточний рядок (F10, команда «next» gdb), увійти до функції (F11, команда «step» у gdb) або виконати інструкції до кінця функції (F12, команда «finish» gdb). На кожному з етапів виконання KDevelop оновлюватиме значення змінних, показані ліворуч. Ви також можете просто навести вказівник миші на частину коду, наприклад, назву змінної, і KDevelop покаже поточне значення та запропонує зупинити виконання програми під час наступної зміни значення змінної. Якщо ви знайомі з gdb, ви також можете натиснути кнопку інструмента GDB у нижній частині вікна і отримати змогу вводити команди gdb безпосередньо, наприклад, для того, щоб змінити значення змінної (у поточній версії середовища, здається, не передбачено іншого способу).

    Приєднання програми для зневаджування до запущеного процесу

    Іноді виникає потреба у зневаджуванні програми, яку вже запущено. Одним з випадків такої потреби є зневаджування паралельно запущених за допомогою MPI програм або зневаджування довготривалого фонового процесу. Виконати таке зневаджування можна за допомогою пункту меню Виконання -> Долучити до процесу, у відповідь на вибір якого буде відкрито вікно, подібне до наведеного вище. Вам потрібно вибрати програму, яка відповідає поточному відкритому проекту у KDevelop — у нашому випадку такою програмою буде step-32.

    Цей список програм може бути доволі довгим, як у нашому прикладі. Ви можете дещо спростити собі роботу за допомогою спадного списку у верхній частині вікна. Типовим пунктом цього списку є Процеси користувачів, тобто всі програми, запущені всіма користувачами, які працюють у системі (якщо ви працюєте за власним стаціонарним або портативним комп’ютером, ймовірно, ви є єдиним користувачем, окрім користувача root та різноманітних облікових записів служб); у списку не буде процесів користувача root. Обмежити перелік процесів можна за допомогою пункту Власні процеси, його вибір призведе до вилучення зі списку програм, запущених іншими користувачами. Кращим варіантом є вибір пункту Лише програми, — зі списку буде вилучено багато процесів, які формально запущено від вашого імені, але які ви власноруч не запускали, зокрема програма для керування вікнами, фонові завдання тощо навряд чи є достойними кандидатами для зневаджування.

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

    Деякі корисні клавіатурні скорочення

    Зневаджування
    F10 Перейти до наступної інструкції ("next" у gdb)
    F11 Увійти у наступну інструкцію ("step" у gdb)
    F12 Вийти з інструкції ("finish" у gdb)