Проект в Visual Studio

В обозревателе решений над деревом файлов стоит строка кнопок, и в ней есть кнопка с листом и фиолетовым значком, Switch Views. Эта кнопка переключает представление — то, в каком виде обозреватель показывает проект. Какое представление выбрано, написано в заголовке обозревателя после названия панели: сейчас это Folder View, дерево папки на диске.

Щелчок по кнопке Switch Views заменяет дерево списком представлений, а в заголовке обозревателя вместо имени представления появляется слово Views. В списке четыре строки:

• Open a solution, folder, or other item — заголовок списка, сама эта строка ничего не делает;
• Folder View выделено жирным, потому что это представление выбрано сейчас;
• CMake Targets View показывает проект так, как его видит CMake;
• Engine.slnx — файл решения, который CMake записал в папку build, когда ты настраивал проект из консоли. Visual Studio нашла этот файл в папке и предлагает открыть проект через него. В этом курсе проект открыт как папка, поэтому строка Engine.slnx не нужна.

Двойной щелчок по строке CMake Targets View в списке представлений покажет вместо папки проект CMake. В этом дереве:

• Engine Project — сам проект, имя взято из команды project в CMakeLists.txt;
• app (executable) — цель app из команды add_executable, а слово executable значит, что из этой цели получится программа .exe. Внутри узла цели лежат файлы, которые CMake отдаёт цели app. Так видно, попадёт ли файл в программу: файла, который ты создал, но не дописал в add_executable, в узле app (executable) не будет;
• CMakeLists.txt лежит в узле проекта, а не в узле цели: этот файл описывает весь проект;
• Pinned Targets — закреплённые цели. Когда целей в движке станет много, нужные можно закрепить здесь, чтобы не искать нужную цель в дереве.

Чтобы вернуться к папке на диске, снова нажми Switch Views и дважды щёлкни по строке Folder View.

Остальные кнопки в строке кнопок обозревателя решений нужны реже, а три из них пригодятся каждый день:

• кнопка со стрелками в обе стороны, Sync with Active DocumentСинхронизировать с активным документом, Ctrl+[, затем S, раскрывает дерево до файла, открытого в редакторе, и выделяет этот файл. Когда в движке появятся десятки файлов в разных папках, так проще всего узнать, где лежит файл, который ты сейчас правишь;
• кнопка с двумя уголками вверх, Collapse AllСвернуть все, сворачивает все раскрытые папки дерева одним щелчком;
• поле поиска под кнопками, Ctrl+;, оставляет в дереве только файлы, в имени которых есть набранные буквы: набери main, и в дереве останется main.cpp.

Пока ты печатаешь имя, список подсказок предлагает варианты, которые есть в подключённых файлах. Здесь набрано std::co, и список показал имена из std, которые начинаются с этих букв. Поэтому если нужного имени в списке нет, чаще всего не хватает строки #include с нужным файлом. Если список закрылся, Ctrl+Space открывает его снова.

Подсказки работают и после того, как имя набрано. Наведи указатель мыши на cout, и всплывёт его описание. Когда откроешь скобку после имени функции, появится подсказка с её параметрами. Клавиша F12 на слове откроет файл, где это имя объявлено: так видно, откуда взялось чужое имя. А Alt+F12 покажет то же в маленьком окне над кодом, не уводя тебя из твоего файла.

Сборкой управляют четыре элемента верхней полосы:

• список x64-Debug выбирает конфигурацию, и у каждой конфигурации своя папка сборки;
• список app.exe выбирает, что запускать. Visual Studio заполняет его целями из CMakeLists.txt, поэтому надпись Select Startup ItemВыбрать элемент запуска вместо имени значит, что настройка CMake ещё идёт или закончилась ошибкой;
• закрашенный треугольник, он же F5, собирает программу и запускает её под отладчиком;
• контурный треугольник, он же Ctrl+F5, собирает и запускает без отладчика.

Пока программа стоит, верхняя полоса меняется: вместо кнопок запуска там появляется панель отладки. Слева направо на ней такие кнопки:

• две полоски, Break AllПрервать все, останавливают работающую программу на той строке, где она сейчас; пока программа уже стоит, как сейчас, кнопка серая;
• красный квадрат, Stop DebuggingОстановить отладку, Shift+F5, завершает программу совсем;
• круговая стрелка, RestartПерезапустить, Ctrl+Shift+F5, останавливает программу и запускает заново;
• стрелка вправо, Show Next StatementПоказать следующий оператор, возвращает редактор к жёлтой стрелке, если ты ушёл смотреть другой файл;
• синяя стрелка дугой над точкой, Step OverШаг с обходом, F10, выполняет строку, на которой стоит жёлтая стрелка, и переходит к следующей. Строка 5 печатает приветствие, поэтому после этого шага в консоли появится Hello, Engine!.

На вкладке OutputВывод одно окно хранит несколько журналов, а показывает один: его выбирает список Show output fromПоказать выходные данные из. Для нашей работы нужны два журнала:

• журнал CMake хранит вывод настройки;
• журнал Build хранит вывод сборки.

Если в окне OutputВывод нет нужных строк, сначала проверь список Show output fromПоказать выходные данные из: возможно, открыт не тот журнал. Сюда стоит заглянуть за тем, чего нет в таблице ошибок: строки с note уточняют ошибку, например показывают, где объявлено std. Двойной щелчок по строке с error здесь тоже открывает файл на нужной строке.

Меню Build и Project нужны, когда сборка ведёт себя странно. Меню BuildСборка отвечает за сборку:

• Build AllСобрать все, Ctrl+Shift+B, собирает весь проект, но компилирует только изменившиеся файлы;
• Rebuild AllПерестроить все компилирует всё заново, а Clean AllОчистить все только удаляет результаты прошлой сборки, ничего не собирая;
• Build app.exeСобрать app.exe, Ctrl+B, собирает одну цель app, а CompileКомпилировать компилирует только открытый файл и линкер не запускает;

Меню ProjectПроект отвечает за настройку CMake:

• Configure CacheНастроить кэш запускает настройку заново;
• Delete Cache and ReconfigureУдалить кэш и выполнить перенастройку удаляет кэш CMake и настраивает с нуля.