KDevelop4/Підказки і настанови

Підказки і настанови

Автоматичне доповнення коду

Хоча передбачено автоматичне доповнення коду, іноді може виникнути потреба і у викликанні такого доповнення вручну. Натисніть Ctrl + Пробіл, щоб побачити докладний список доповнення коду. Пересуватися пунктами списку можна за допомогою кнопок зі стрілочками (↑/↓). Щоб переглянути документацію з позначеного пункту, натисніть (і утримуйте натиснутою) клавішу Alt. Щоб вставити пункт зі списку, натисніть клавішу Enter.

Помічник з типів C++

Припустімо, що у вашому коді є такий фрагмент:

#include <vector>
void myFunc(const std::vector<int>& v) {

}

Тепер слід виконати послідовну ітеративну обробку вмісту. Замість вписування типу ітератора, достатньо написати:

  it = vector.begin();

Після чого зачекати секунду, доки помічник не покаже панель у нижній частині області редактора. Тепер можна натиснути Alt + 1, щоб виконати дію помічника і отримати таке:

  std::vector< int >::iterator it = v.begin();

Чудово, вдалося зекономити доволі багато часу. Цей спосіб працює з більшістю або навіть з усіма виразами: якщо праву частину виразу можна обчислити, помічник здатен додати правильне визначення типу до лівої частини.

Помічник підписів C++

Приклад коду:

class foo {
  int bar();
};

int foo::bar()
{
}

Тепер спробуйте виконати вказані далі кроки, зупиняючись на секунду після виконання кожного з них. Застосовуйте пропозиції помічника, які буде показано на панелі у нижній частині області редагування, за допомогою натискання комбінації клавіш Alt + 1:

1. додайте параметр, наприклад int foo до кожного підпису у визначенні або оголошенні;
2. створіть один підпис const;
3. змініть тип параметра;
4. вилучіть параметр.

Знову ж таки, дуже зручний інструмент для економії часу.

Помічник пропущених оголошень C++

Приклад коду:

class foo {
  int bar();
};

foo::bar()
{
}

Впишіть у реалізацію bar таке:

  myVar = 1;

Середовище відкриє панель помічника і запропонує вам три варіанти:

1. оголосити int myVar локально (local) (див. помічник з типів);
2. оприлюднити (public) int myVar, додає оголошення до тіла класу;
3. закрити (private) int myVar, те саме, що і пункт вище, але у розділі private.

Цей спосіб працює навіть для функцій:

class foo {
};

int main() {
  foo f;

}

Тепер введіть це трохи нижче foo f;:

  f.someFunction(1, true, "asdf");

Помічник запропонує вам оголосити функцію. Зрештою, ви отримаєте таке:

class foo {
public:
  void someFunction( int arg1, bool arg2, const char* arg3 );
};

Чудово .

Помічник з перевантаження

Приклад коду:

class A {
public:
  virtual A* foo(int something){}
};
class B : public A {

};

Всередині тексту класу B натисніть комбінацію клавіш Ctrl + Пробіл, щоб викликати інструмент доповнення коду. У списку буде показано пункт перевантаження foo(int something);. Вставте цей пункт за допомогою Enter. Має вийти таке:

class B : public A {
public:
  virtual A* foo(int something);
};

Чудово .

Помічник з реалізації

Продовжимо з того місця, на якому ми зупинилися у прикладі щодо Помічника з перевантаження:

class B : public A {
public:
  virtual A* foo(int something);
};

Розташуйте курсор під контекстом класу, викличте засіб завершення коду за допомогою натискання комбінації клавіш Ctrl + Пробіл. У списку буде показано пункт реалізації B::foo(int something);. Вставте цей пункт натисканням клавіші Enter. Має вийти щось таке:

A* B::foo(int something)
{
  A::foo(something);
}

Непогано .

Пришвидшення відкриття

Пункти Швидко відкрити є однією з дуже корисних можливостей KDevelop, вони значно підвищують продуктивність роботи:

• Швидко відкрити файли

Натисніть комбінацію клавіш Ctrl + Alt + O і введіть частину шляху до файла, натисніть Enter, і програма відкриє вибраний файл. Елементи шляху відокремлюються звичайними похилими рисками, тобто ви можете ввести /a/.cpp, щоб у списку було показано лише шляхи, назви тек у яких починаються з a, а назви файлів завершуються на .cpp. Спробуйте.

• Швидко відкрити класи

Ctrl + Alt + C, потім введіть частину чинного ідентифікатора класу, натисніть Enter, і курсор буде переведено до оголошення відповідного класу.

Вам варто також ознайомитися з іншими корисними можливостями Швидкого відкриття.

Огляд

Подібно до швидкого відкриття, натискання комбінації клавіш Ctrl + Alt + N надасть вам доступ до огляду поточного документа, а також можливість виконати пошук ідентифікатора та швидко перейти до його оголошення.

Навігація контекстом

Наведіть вказівник на текст з використанням, оголошенням або визначенням, і середовище покаже контекстну панель з метаданими. Ви можете перевести курсор у відповідне місце, а потім натиснути (і тримати натисненою) клавішу Alt, щоб відкрити цю контекстну панель без миші. Для навігації посиланням на контекстній панелі ви можете скористатися клавішами зі стрілочками. За допомогою клавіші Enter можна перейти за посиланням.

When inside a use, press Meta + Left or Meta + Right to jump to the previous/next use. Press Ctrl + . or Ctrl + , to jump to the declaration or definition of the symbol under the cursor. Alternatively click on a symbol with Ctrl button pressed to do the same.

Вам також варто зазирнути до меню Навігація і ознайомитися з відповідними клавіатурними скороченнями. Контекстний перегляд — це чудово!

Способи роботи з autotools: automake, autoconf та libtool

Підтримка роботи з autotools у Kdevelop4 є недостатньою. Вам варто скористатися Konsole для запуску скриптів налаштування і створення файла makefile. Передбачено непогану підтримку нетипових файлів makefile. Вам варто також користуватися окремою текою збирання (наприклад project/build).

After the custom makefiles are in place (say in 'build'-directory) one can add that to build list by clicking + button on lower left corner Project selection while build directory is selected. This causes command make to be run when pressing Build. One can also directly run say make install on specific directory by right clicking the folder and selecting make install. This is nice if you have lots of projects in working set.

З libtool також можуть виникнути проблеми, якщо ви намагаєтеся виконати діагностику програми, яку було об’єднано за допомогою libtool: програма, яка називається, наприклад, src/bin/program є не є основним виконуваним файлом, а лише скриптом, який працює з бібліотеками.

Problem is properly solved in console by running

libtool --mode=execute <dst_binary>

but at least currently KDevelop4 does not work good (at all) with other console than default. I have been stuck of using the real binary (found usually from src/bin/.libs/<exec>) that might use wrong libraries, so do make install before every run.

Документація з класів KDE

Using the Qt Documentation plugin you may integrate KDE documentation along with Qt documentation. Point your browser at KDE API Reference and download the desired .qch file (not all modules provide one). Then configure the Qt Documentation plugin by adding the downloaded files. That's it! Whenever you hover a KDE class you can see a link Show documentation for KFooClass which points to KFooClass documentation. Enjoy.