"Tools -> Options..." ("Инструменты -> Параметры...") главного окна. "Среда" ("Environment") меню "Параметры". 
Рисунок 1. Переключение языка интерфейса
Руководство "Начало работы с Qt Creator"
Цель данного руководства - помочь разработчикам приложений для ЗОСРВ "Нейтрино" в освоении графической среды разработки Qt Creator (далее - Среда разработки), а также предоставить информацию о некоторых функциях и возможностях, присутствующих только в Qt Creator редакции КПДА. Рассматриваются только базовые приёмы работы (создание нового проекта, подключение к целевой системе, пошаговая отладка).
Официальная общедоступная документация на Qt Creator: doc.qt.io/qtcreator
Запуск Среды разработки осуществляется с помощью файла run_qtcreator.sh (Linux) или run_qtcreator.bat (Windows), находящегося в каталоге установки Комплекта разработчика для ЗОСРВ "Нейтрино" (далее - КР).
"Tools -> Options..." ("Инструменты -> Параметры...") главного окна. "Среда" ("Environment") меню "Параметры".
"Создать" ("New") на начальном экране или выберите пункт меню "File -> New File or Project..." ("Файл -> Создать файл или проект..."); также может быть использована комбинация клавиш Сtrl+N. 
"Проекты" ("Projects") выберите раздел "Примеры для ЗОСРВ Нейтрино" ("KPDA Examples"). Далее выберите один из предлагаемых шаблонов и нажмите кнопку "Выбрать..." ("Choose..."). 
"MyProject") или оставьте предлагаемое по умолчанию ("untitled"). 
 | Среда Qt Creator позволяет настроить проект на использование нескольких Комплектов (например, для последующего быстрого переключения между платформами при выполнении работ по переносу ПО с одной платформы на другую). На этапе знакомства со Средой разработки рекомендуем выбрать только один пункт из предлагаемого списка. |
"Завершить" ("Finish"). Настройку подпроектов и системы контроля версий в данный момент выполнять не требуется. 
В том случае, если новый проект создан успешно, в Редакторе будет автоматически открыт основной файл его исходного кода.
Ctrl+"+/-" ("+" и "-" на числовой клавиатуре), а также Ctrl+"прокрутка_колесом_мыши" F2 (курсор в редакторе кода должен быть установлен на интересующую переменную/класс/тип/заголовочный файл/...) "Открытые документы" ("Open Documents"): Alt+0 ("ноль") "вперед/назад"): Alt+"курсор_влево/курсор_вправо" Ctrl+"/" Ctrl+D Ctrl+Shift+"курсор_вверх/курсор_вниз" Выбор инструмента навигации по исходному коду осуществляется в левом верхнем углу главного окна Среды разработки:
Основные инструменты навигации:
"Обзор классов" ("Class View"): отображение иерархии классов и функций "Контур" (Outline): сводный перечень классов, функций, переменных и т.д. "Файловая система" ("File System"): доступ к содержимому проектов на файловой системе
| Для быстрого вызова инструментов, в т.ч. перечисленных выше, могут быть назначены горячие клавиши; см. раздел "Среда -> Клавиатура" ("Environment -> Keyboard") меню "Параметры". |
Также может быть полезен инструмент быстрого поиска "Найти..." ("Locate"), доступный через меню "Инструменты" ("Tools") или комбинацию клавиш Ctrl+K. Он позволяет осуществлять быстрый поиск по имени файла, объекта, класса и т.д. (как входящих в состав проекта, так и общесистемных).
"Build" (комбинация клавиш Ctrl+B или кнопка "Build" в левом нижнем углу главного окна Среды разработки). 
"Issues" (комбинация клавиш Alt+1) "Compile Output" (комбинация клавиш Alt+4). "General Messages" (комбинация клавиш Alt+6) Для повторной сборки проекта аналогично может быть использована команда "Build" (инкрементальная сборка), а также команда "Rebuild" (полная пересборка проекта с предварительной очисткой; см. пункт меню "Сборка" ("Build") или меню свойств проекта, доступное через нажатие правой кнопки на имени проекта).
| Для выполнения удалённого запуска и отладки ПО в общем случае требуется использование учётной запись суперпользователя ("root"). Для выполнения только удалённого запуска ПО возможно использование произвольной учётной записи. |
 | Изначально в состав конфигурации Среды разработки включён профиль "(unconfigured)", представляющий собой "заглушку" (т.е. в нём отсутствует какая-либо информация о целевой системе). Единственное назначение данного профиля - обеспечение визуальной целостности Комплектов (предотвращает появление предупреждения "No device set" / "Устройство не настроено"). В будущем данный профиль может быть исключён из состава стандартной конфигурации Среды разработки. |
SSH, целевая система должна быть предварительно настроена соответствующим образом: sshd должна входить в состав загрузочного образа либо присутствовать на файловой системе PubkeyAuthentication yes) PermitRootLogin yes) /var/run, доступный на запись. Перед созданием нового профиля конфигурации убедитесь, что
sshd (рекомендации по конфигурации см. выше).
| В случае возникновения проблем с подключением к целевой системе целесообразно проверить, возможно ли подключение в режиме командной строки. Примеры команды подключения для различных инструментальных систем:
sshd запущена на стандартном порту (22), то параметр -oPort=<порт_SSH> можно не указывать. При необходимости также можно использовать дополнительный параметр -v для вывода более подробной диагностической информации. |
"Устройства" ("Devices") в меню "Параметры" 
"Добавить" ("Add.."), выберите пункт "Устройство под управлением ЗОСРВ «Нейтрино» или QNX" ("KPDA or QNX Device") и нажмите кнопку "Начать настройку" ("Start Wizard"). 
Настройка новой конфигурации (профиля конфигурации) целевой системы:
| Рекомендация: имя профиля должно отражать особенности данной целевой системы - например, её архитектуру, местоположение, название платы/устройства и т.п. Имя может включать в себя символы кириллицы, пробелы и т.д. |
"Создать новую пару ключей" ("Create New Key Pair") 
 | Выбирайте местоположение каталога для сохранения ключей в т.ч. с точки зрения безопасности, т.к. доступ к ключам позволяет осуществлять подключение к целевой системе без необходимости ввода пароля. |
"Создать и сохранить пару ключей" ("Generate and Save Key Pair"). "Файл секретного ключа" ("Private Key File"), нажмите кнопку "Установить ключ" ("Deploy Public Key"). 
"Connection". | Пароль необходим только для регистрации ключей, поэтому он вводится однократно при каждой регистрации и не сохраняется в среде разработки. |
"Deployment finished successfully" / "Установка завершилась успешно"), которое можно закрыть, после чего рядом с кнопкой "Установить ключ" ("Deploy Public Key") появится отметка в виде "галки" зелёного цвета. 
"Завершить" ("Finish") создание профиля конфигурации будет завершено. 
| Повторную проверку целевой системы при необходимости можно выполнить с помощью кнопки "Проверить" ("Test") в разделе "Устройства" ("Devices") меню "Параметры" (предварительно выбрав профиль конфигурации необходимой целевой системы из списка доступных). |
"Комплекты" ("Kits") меню "Параметры" выберите Комплект, используемый в качестве основного для текущего проекта "Устройство" ("Device") на соответствующее новому профилю конфигурации 
"Применить" ("Apply"), затем "ОК"
"Run" (комбинация клавиш Ctrl+R или кнопка "Запустить"/"Run" в левом нижнем углу главного окна Среды разработки). 
Консольный вывод приложения доступен через инструмент "Вывод приложения" ("Application Output"; комбинация клавиш Alt+3 ). Для каждого запущенного экземпляра приложения в данном инструменте открывается отдельная закладка.
Остановить запущенное ранее приложение можно с помощью кнопки "Остановить запущенную программу" ("Stop running program"), расположенной в верхнем меню этого же инструмента.
"Debug" (варианты из меню "Отладка" / "Debug" или кнопка "Start debugging of startup project" / "Начать отладку" в левом нижнем углу главного окна Среды разработки). | Англоязычное описание кнопки запуска отладки ("Start debugging of startup project") является стандартным для Qt Creator (как минимум, по состоянию на момент выхода версии 6.0.2). Несмотря на то, что оно имеет некоторую неоднозначность (в первую очередь касающуюся термина "startup project"), данное описание в Qt Creator редакции КПДА в настоящий момент оставлено без изменения, поскольку оно также встречается в общедоступной англоязычной документации. Русскоязычный перевод при этом скорректирован ("Начать отладку"). |
Среда разработки Qt Creator по умолчанию не устанавливает точку останова (breakpoint) в начале функции main(). Варианты:
"Start and Break On Main" (по умолчанию на клавише F10) main() вручную "Отладчик -> GDB" меню "Параметры" в поле "Дополнительные команды запуска" добавить команду "break main". 
Управление процессом отладки может осуществляться либо с помощью элементов управления (панели кнопок) инструмента "Отладчик" ("Debugger"), а также с помощью горячих клавиш (см. ниже):
Схема распределения клавиш, отвечающих за выполнение типовых операций при отладке (отличается от принятой, например, в среде разработки QNX Momentics IDE). Основные клавиши по умолчанию:
| Клавиша в Qt Creator | Назначение | Аналог в Eclipse/QNX Momentics IDE |
|---|---|---|
F5 | Запуск отладки | F11 |
F10 | Запуск отладки с остановкой в main() | F11 (по умолчанию) |
F5 (после начала отладки) | Приостановка отладки | - |
F5 (конфликт с "Приостановка отладки") | Продолжение (до следующей точки останова) | F8 |
F9 | Установить/убрать точку останова | Ctrl+Shift+B |
F10 (после начала отладки) | Шаг (режим "Step over") | F6 |
F11 | Шаг (режим "Step into") | F5 |
Shift+F11 | Шаг (режим "Step out") | F7 ("Step Return") |
Ctrl+F10 (не работает) | Шаг (режим "Run to line") | Ctrl+R |
Shift+F5 | Завершить отладку | Ctrl+F2 |
| Переопределить клавиши можно в разделе "Среда -> Клавиатура" ("Environment -> Keyboard") меню "Параметры"; там же при необходимости возможно выполнить импорт/экспорт модифицированной конфигурации. |
Остановить ранее запущенное в режиме отладки приложение можно с помощью кнопки "Завершить отладку" ("Stop Debugger"):
Полный журнал процесса отладки (в т.ч. низкоуровневое взаимодействие Среды разработки с отладчиком) доступен через инструмент "Журнал отладки" ("Debugger Log") в меню "Вид -> Обзоры" ("View -> Views").
Способ изменения параметров сборочной системы зависит от типа сборочной системы, на которой основан проект (CMake, qmake, рекурсивная сборочная подсистема и т.д.). В общем случае требуется редактирование конфигурационных файлов проекта (напр. CMakeLists.txt, <имя_проекта>.pro, common.mk и т.д.).
Параметры Комплекта (например, версии используемых компиляторов, версия компонентов платформы Qt и т.д.) могут быть изменены в свойствах Комплекта (см. раздел "Комплекты" ("Kits") меню "Параметры").
| Поскольку Комплекты, присутствующие в составе Среды разработки, по умолчанию могут быть доступны в режиме "только для чтения", для изменения свойств какого-либо Комплекта рекомендуется предварительно создать его копию (клон) с помощью кнопки "Создать копию" ("Clone"), и осуществлять редактирование свойств именно созданной копии. После создания таким образом нового Комплекта с требуемым набором свойств необходимо в параметрах проекта (меню "Проекты"/"Projects", раздел "Сборка и запуск"/"Build & Run") сделать новый комплект основным или активным. |
| Техническая поддержка осуществляется только в отношении Qt Creator редакции КПДА (т.е. входящей в состав Комплекта разработчика для ЗОСРВ "Нейтрино"). |
Предыдущий раздел: Графическая среда разработки Qt Creator (редакция КПДА)