KDevelop5/Підручник/Налаштовування KDevelop

Налаштовування KDevelop

Іноді корисно змінити типовий вигляд або спосіб роботи KDevelop, наприклад, ви звикли до інших клавіатурних скорочень або у вашому проекті використовується інші відступи у коді. У наступних розділах ми коротко обговоримо різні способи налаштування KDevelop відповідно до ваших потреб.

Налаштовування редактора

Корисно налаштувати вбудований редактор та інші компоненти KDevelop. Однією з загальних речей є вмикання показу нумерації рядків за допомогою пункту меню Редактор -> Перегляд -> Показати номери рядків. У такому режимі простіше буде визначати рядки з помилками під час компіляції або визначати відповідність діагностичних повідомлень позиціям у коді. У тому ж підменю ви можете увімкнути "Рамку для піктограм" — стовпчик у лівій частині панелі редактора, у якому KDevelop показуватиме піктограми, зокрема позначок точок зупину у рядках.

Налаштовування відступів у коді

У кожного з нас є певні уподобання щодо форматування коду. У багатьох проектах є власні правила щодо відступів у коді. Ці правила можуть не відповідають правилам встановлення відступів KDevelop. Ви можете просто змінити правила відступів: скористайтеся пунктом меню Параметри -> Налаштувати KDevelop. Перейдіть на сторінку Форматування коду за допомогою списку ліворуч. Ви можете вибрати один з попередньо визначених розповсюджених типів форматування або визначити власний стиль додаванням нового стилю з наступним його редагуванням. Можливо, повністю відтворити стиль форматування коду вашого проекту у минулому не вдасться, але ви можете гранично до нього наблизитися за допомогою параметрів нового стилю. Приклад наведено на двох зображеннях нижче.

Зауваження

У KDevelop 4.2.2 ви можете створити стиль для файлів окремого типу MIME (наприклад, для стилю файлів заголовків C++), але цей стиль не буде показано у списку можливих стилів для файлів інших типів MIME (наприклад, для коду файлів C++), хоча, звичайно ж, було б корисно використати цей тип для обох типів файлів. Тому вам доведеться визначати стиль двічі: один раз для файлів заголовків і один раз для файлів коду. Про цю ваду було повідомлено розробникам, KDevelop, вада 272335.

Налаштовування клавіатурних скорочень

У KDevelop передбачено майже безмежний список клавіатурних скорочень (деякі з них можна знайти у списках «Корисні клавіатурні скорочення» у декількох частинах цього підручника). Ці клавіатурні скорочення можна змінити за вашими потребами за допомогою пункту меню Параметри -> Налаштувати скорочення. У верхній частині діалогового вікна ви можете вказати ключ пошуку, щоб переглянути лише відповідні ключу скорочення. Після цього ви можете змінити клавіатурні скорочення для бажаних команд.

Two that have been found to be very useful to change are to set Align to the Tab key (many people don't usually enter tabs by hand and rather prefer if the editor chooses the layout of code; with the changed shortcut, hitting Tab makes KDevelop indent/outdent/align the code). The second one is putting Toggle Breakpoint on Ctrl + B since this is quite a frequent operation.

Customizing code auto-completion

Code completion is discussed in this manual's section on writing source code. In KDevelop, it comes from two sources: the editor, and the parse engine. The editor (Kate) is a component of the larger KDE environment and offers auto-completion based on words it has already seen in other parts of the same document. Such auto-completions can be identified in the tooltip by the icon that precedes it:

The editor's code completion can be customized via Settings -> Configure Editor -> Editing -> Auto Completion. In particular, you can select how many characters you need to type in a word before auto-completion kicks in.

On the other hand, KDevelop's own auto-completion is much more powerful as it takes into account semantic information about the context. For example, it knows which member functions to offer when you type object., etc., as shown here:

This context information comes from various language support plugins, which can be used after a given file has been saved (so it can check the filetype and use the correct language support). KDevelop's completion is set to appear as you type, right away, pretty much everywhere that it could possibly complete something. This is configurable in Settings -> Configure KDevelop -> Language Support. If it isn't already set (as it should, by default), make sure Enable Automatic Invocation is set.

KDevelop has two ways to show a completion: Minimal Automatic Completion shows just the basic information in completion tooltips (i.e. the namespace, class, function, or variable name). This will look similar to Kate completion (except for the icons). On the other hand, Full completion will additionally show the type for each entry, and in the case of functions, also the arguments they take. Also, if you are currently filling in the arguments to a function, full completion will have an additional info-box above the cursor that will show you the current argument you are working on. KDevelop's code completion should also bring-to-top and highlight in green any completion items that match the currently expected type in both minimal and full completion, known as "best-matches".

The three possible choices for the completion level in the configuration dialog are:

Always minimal completion: Never show "Full Completion"

Minimal automatic completion: Only show "Full Completion" when auto-completion has been triggered manually (i.e., whenever you hit Ctrl+Space)

Always full completion: Always show "Full Completion"